SDK .NET / C#

dotnet add package SSDDO.ECF_DGII.SDK

using EcfDgii.Client;
using EcfDgii.Client.Generated.Models;

// Configura el cliente con tu API key (JWT obtenido en ecf.ssd.com.do)
var client = new EcfClient(new EcfClientOptions
{
  ApiKey = "tu-jwt-token",        // o usa la variable de entorno ECF_API_KEY
  Environment = EcfEnvironment.Prod
});

// Construye el comprobante
var ecf = new ECF
{
  Encabezado = new Encabezado
  {
      IdDoc = new IdDoc
      {
          TipoeCF = TipoeCFType.FacturaDeCreditoFiscalElectronica,
          Encf = "E310000000001"
      },
      Emisor = new Emisor
      {
          RncEmisor = "123456789",
          RazonSocialEmisor = "Mi Empresa SRL",
          DireccionEmisor = "Calle Principal #1, Santo Domingo",
          FechaEmision = new Date(2026, 1, 10)
      },
      Totales = new Totales
      {
          // montos, ITBIS, etc.
      }
  },
  DetallesItems = new List<Item>
  {
      new Item
      {
          NombreItem = "Servicio de consultoría",
          IndicadorFacturacion = IndicadorFacturacionType.NoFacturable_18Percent,
          CantidadItem = new UntypedDouble(1),
          PrecioUnitarioItem = new UntypedDouble(10000.00),
          MontoItem = new UntypedDouble(10000.00)
      }
  }
};

// Envía y espera el resultado
try
{
  EcfResponse resultado = await client.SendEcfAsync(ecf);
  Console.WriteLine($"Comprobante procesado exitosamente!");
  Console.WriteLine($"Estado: {resultado.Progress}");
  Console.WriteLine($"Mensaje DGII: {resultado.Mensaje}");
  Console.WriteLine($"Código seguridad: {resultado.CodSec}");
  Console.WriteLine($"URL impresión: {resultado.ImpresionUrl}");
}
catch (EcfException ex)
{
  Console.WriteLine($"Error: {ex.Message}");
  Console.WriteLine($"Detalle: {ex.Response.Errors}");
}

EcfResponse resultado = await client.SendEcfAsync(ecf);

string urlQr = resultado.ImpresionUrl;             // codificar como QR
string codigoSeguridad = resultado.CodSec;         // imprimir en el comprobante
DateTimeOffset fechaFirma = resultado.FechaFirma;  // fecha de firma digital

if (resultado.Estatus == EcfEstado.Aceptado)
{
  Console.WriteLine("Comprobante aceptado por la DGII");
  Console.WriteLine($"QR URL: {urlQr}");
  Console.WriteLine($"Código seguridad: {codigoSeguridad}");
  Console.WriteLine($"Firmado: {fechaFirma}");
}

var resultado = await client.SendEcfAsync(ecf, new PollingOptions
{
  InitialDelayMs = 1000,      // espera inicial entre consultas
  MaxDelayMs = 30000,         // espera máxima entre consultas
  MaxRetries = 60,            // máximo de reintentos
  BackoffMultiplier = 2,      // multiplicador exponencial
  TimeoutMs = 120000          // timeout total (2 minutos)
});

{
"encabezado": {
  "idDoc": {
    "encf": "E310000051630",
    "TipoeCF": "FacturaDeCreditoFiscalElectronica",
    "TipoPago": "Contado",
    "TipoIngresos": "01",
    "TablaFormasPago": [
      { "FormaPago": "Efectivo", "MontoPago": 1015.25 }
    ],
    "IndicadorMontoGravado": "ConITBISIncluido",
    "FechaVencimientoSecuencia": "2028-12-31T00:00:00"
  },
  "Emisor": {
    "RNCEmisor": "131460941",
    "FechaEmision": "2026-01-10",
    "DireccionEmisor": "AVE. ISABEL AGUIAR NO. 269, ZONA INDUSTRIAL DE HERRERA",
    "RazonSocialEmisor": "DOCUMENTOS ELECTRONICOS DE 02"
  },
  "Totales": {
    "ITBIS1": 18,
    "MontoGravadoI1": 762.71,
    "MontoGravadoTotal": 762.71,
    "TotalITBIS1": 137.29,
    "TotalITBIS": 137.29,
    "MontoNoFacturable": 100.0,
    "ImpuestosAdicionales": [
      {
        "TipoImpuesto": "002",
        "TasaImpuestoAdicional": 2,
        "OtrosImpuestosAdicionales": 15.25
      }
    ],
    "MontoImpuestoAdicional": 15.25,
    "MontoTotal": 1015.25,
    "MontoPeriodo": 1015.25
  },
  "Version": "Version1_0",
  "Comprador": {
    "RNCComprador": "131880681",
    "RazonSocialComprador": "DOCUMENTOS ELECTRONICOS DE 03"
  }
},
"DetallesItems": [
  {
    "MontoItem": 1016.95,
    "NombreItem": "Iphone 18 Pro max",
    "NumeroLinea": 1,
    "CantidadItem": 1,
    "UnidadMedida": "Unidad",
    "PrecioUnitarioItem": 1016.95,
    "IndicadorFacturacion": "ITBIS1_18Percent",
    "IndicadorBienoServicio": "Bien",
    "TablaImpuestoAdicional": [
      { "TipoImpuesto": "002" }
    ]
  },
  {
    "MontoItem": 100.0,
    "NombreItem": "Costo de Envío",
    "NumeroLinea": 2,
    "CantidadItem": 1,
    "UnidadMedida": "Unidad",
    "PrecioUnitarioItem": 100.0,
    "IndicadorFacturacion": "NoFacturable_18Percent",
    "IndicadorBienoServicio": "Servicio"
  }
],
"DescuentosORecargos": [
  {
    "TipoValor": "$",
    "TipoAjuste": "D",
    "NumeroLinea": 1,
    "MontoDescuentooRecargo": 84.75,
    "DescripcionDescuentooRecargo": "Descuento",
    "IndicadorFacturacionDescuentooRecargo": "ITBIS1_18Percent"
  }
]
}

// 1. Enviar la factura al backend
var invoiceResponse = await httpClient.PostAsJsonAsync("/api/v1/invoices", invoiceData);
var result = await invoiceResponse.Content.ReadFromJsonAsync<InvoiceResult>();

// 2. Crear cliente de solo lectura (GetToken se llama automáticamente)
var frontend = new EcfFrontendClient(new EcfFrontendClientOptions
{
  GetToken = async () =>
  {
      var response = await httpClient.GetAsync("/api/v1/ecf-token");
      var json = await response.Content.ReadFromJsonAsync<TokenResponse>();
      return json.ApiKey;
  },
  Environment = EcfEnvironment.Prod
  // CacheToken usa archivo encriptado en disco por defecto
});

// 3. Consultar el estado del ECF
var ecf = await frontend.QueryEcfAsync(result.Rnc, result.Encf);
var ecfs = await frontend.SearchEcfsAsync(result.Rnc);

var ecfClient = new EcfClient(new EcfClientOptions
{
  ApiKey = backendJwtToken,
  Environment = EcfEnvironment.Prod
});

// Endpoint de facturación — tu lógica de negocio + envío a ECF SSD
[HttpPost("/api/v1/invoices")]
public async Task<IActionResult> CreateInvoice(CreateInvoiceRequest request)
{
  var invoice = await _invoiceService.ValidateAndSave(request);
  var ecf = _mapper.ToEcf(invoice);

  var response = await ecfClient.Api.Ecf.E31[rnc].PostAsync(ecf);
  await _invoiceService.UpdateMessageId(invoice.Id, response.MessageId);

  return Ok(new { invoice.Id, response.MessageId });
}

// Endpoint separado: generar token de lectura para el cliente
[HttpGet("/api/v1/ecf-token")]
public async Task<IActionResult> GetEcfToken()
{
  var apiKey = await ecfClient.Api.ApiKey.PostAsync(new NewCompanyApiKeyRequest
  {
      // token restringido al tenant y RNC, solo lectura
  });
  return Ok(new { apiKey.Token });
}

// Consultar comprobantes
var comprobantes = await client.Api.Ecf["123456789"].GetAsync();

// Buscar un comprobante específico
var resultado = await client.Api.Ecf["123456789"]["E310000000001"].GetAsync();

// Consultar estado en la DGII
var estado = await client.Api.Dgii["123456789"].Consultaestado.Estado.GetAsync(config =>
{
  config.QueryParameters.RncEmisor = "123456789";
  config.QueryParameters.NcfElectronico = "E310000000001";
  config.QueryParameters.RncComprador = "987654321";
  config.QueryParameters.CodigoSeguridad = "ABC123";
});

// Gestión de empresas
var empresas = await client.Api.Company.GetAsync();
await client.Api.Company.PutAsync(new UpsertCompanyRequest { /* ... */ });

// Aprobación comercial
await client.Api.Ecf.Aprobacioncomercial["123456789"]["E310000000001"]
  .PostAsync(new SendAcecfRequest { /* ... */ });

// Anulación de rangos
await client.Api.Ecf.Anularrango["123456789"]
  .PostAsync(new AnulacionRequest { /* ... */ });

// Estatus de servicios DGII
var estatus = await client.Api.Dgii["123456789"].Estatusservicios.ObtenerEstatus.GetAsync();

try
{
  var resultado = await client.SendEcfAsync(ecf);
}
catch (EcfException ex)
{
  // La DGII rechazó el comprobante
  Console.WriteLine($"Rechazado: {ex.Response.Errors}");
  Console.WriteLine($"Estado DGII: {ex.Response.Estatus}");
}
catch (PollingTimeoutException)
{
  // El comprobante fue enviado pero no se recibió respuesta a tiempo
  // Puedes consultar el estado después con client.Api.Ecf[rnc][encf].GetAsync()
}

using var cts = new CancellationTokenSource(TimeSpan.FromMinutes(5));
var resultado = await client.SendEcfAsync(ecf, cancellationToken: cts.Token);