Zucchetti.SDH.DCA.Client 1.0.3

Descripción

Cliente DLL para la SDH DCA API (Documento de Control Administrativo, Orden FOM/2861/2012).

Sigue las mismas convenciones que el resto de clientes de Solmicro Digital Hub (Solmicro.DigitalHub.Client): .NET Standard 2.0, HttpWebRequest + System.Text.Json, autenticación encapsulada en Certificate / SDHAuthorization, y una clase de cliente por dominio (ControlDocumentsClient) con un método Set(...) para configurar el contexto de conexión antes de invocar las operaciones.

Autenticación

SDHAuthorization admite dos modos:

• Solo certificado de cliente (mTLS): usado por SdhProductionAuthentication. Cada petición se autentica con el certificado y la cabecera CompanyId.
• Azure AD (OAuth2 client-credentials): además del certificado/CompanyId, cada petición incluye un token Bearer obtenido del endpoint de token de Microsoft Entra ID mediante ClientId + certificado (firma de JWT assertion) o ClientId + ClientSecret. El token se cachea en memoria hasta su expiración.

Uso básico

// Modo mTLS (SdhProductionAuthentication)
var certificate = new Certificate("thumbprint-o-numero-de-serie");
var sdhAuth = new SDHAuthorization(certificate);

// Modo Azure AD (OAuth2), alternativamente:
// var sdhAuth = new SDHAuthorization(clientId, certificate);
// var sdhAuth = new SDHAuthorization(clientId, clientSecret);

var client = new ControlDocumentsClient();
client.Set(companyId: "00000000-0000-0000-0000-000000000000",
           url: "https://decatest.solmicrosdh.com",
           sdhAuth: sdhAuth);

var response = client.Create(new CreateControlDocumentRequest
{
    ContractualCharger = new ContractualCharger { BusinessName = "...", TaxIdentificationNumber = "...", Address = "..." },
    ActualCarrier = new ActualCarrier { BusinessName = "...", TaxIdentificationNumber = "..." },
    Shipments = new List<Shipment> { new Shipment { Origin = "...", Destination = "...", GoodsNature = "...", WeightKg = 1000 } },
    Vehicle = new Vehicle { LicensePlate = "1234ABC" },
    TransportDate = DateTime.Today
});

client.Update(response.Id, new UpdateControlDocumentRequest { /* ... */ });
client.ResendNotification(response.Id, new ResendNotificationRequest { Channel = NotificationChannel.Email, Address = "destinatario@dominio.com" });
client.Delete(response.Id);

Vehicle.LicensePlate es obligatoria salvo que se informen a la vez TractorLicensePlate y SemitrailerLicensePlate (conjunto articulado completo), en cuyo caso puede omitirse:

Vehicle = new Vehicle { TractorLicensePlate = "5678DEF", SemitrailerLicensePlate = "9012GHI" },