Starsoft e-CF API Documentation DGII

Esta API gestiona el flujo completo de facturacion electronica: mapeo JSON a XML, firma, validacion previa, envio a DGII, secuencia RFCE para E32 y tracking operativo.

Abrir Swagger UI Ver OpenAPI JSON

Base path activo: /api

Quick Start

  • 1) Validar primero: POST /api/validate-scenario o POST /api/validate-xml.
  • 2) Si canSend=true, enviar con POST /api/send-xml o POST /api/test-scenarios-json.
  • 3) Consultar estado DGII con GET /api/trackid?trackId=....
  • 4) Para E32 menor de 250,000 revisar b2cResumenOnly, codigoSeguridadeCF y link_original.

Endpoints Principales

MetodoRutaDescripcion
GET/api/healthEstado y rutas activas
GET/api/api/healthHealth alias CERT
POST/api/test-scenariosProcesa escenarios por filePath
POST/api/test-scenarios-jsonProcesa escenarios JSON para envio DGII
POST/api/aprobacion-acfePruebas de aprobacion ACFE por filePath
POST/api/aprobacion-acfe-jsonPruebas de aprobacion ACFE por JSON
POST/api/test-bodyPruebas de body libre
GET/api/trackidConsulta estado por TrackId
POST/api/generate-xml-no-sendGenera y firma XML sin enviar
POST/api/validate-scenarioValida JSON antes de enviar
POST/api/validate-xmlValida XML ECF/RFCE
POST/api/send-xmlEnvia ECF o secuencia RFCE -> ECF
POST/api/firmar-xmlFirma XML usando certificado por RNC
POST/api/sign-documentFirma XML simple con auth
POST/api/convertir-certConvierte certificado a formato compatible
POST/api/create-invoiceCrea factura y la envia a DGII
POST/api/send-invoiceEnvia factura XML por correo
GET/api/logs/{rnc}Consulta logs por RNC
GET/api/logs/{rnc}/filesLista archivos de logs
GET/api/logs/{rnc}/searchBusca texto en logs
GET/api/logs/{rnc}/statsEstadisticas de logs
DELETE/api/logs/{rnc}/cleanElimina logs antiguos
GET/api/logs/{rnc}/downloadDescarga logs
GET/api/logs/{rnc}/urlURL publica de logs
GET/api/automation/events/pendingPendientes del tracker AI
GET/api/automation/events/allTodos los eventos del tracker AI
POST/api/automation/events/{id}/processedMarca evento como procesado
GET/api/autenticacion/semillaSemilla receptor DGII
GET/api/autenticacion/api/semillaAlias semilla
POST/api/autenticacion/validacion-certificadoValida certificado y emite token
POST/api/autenticacion/api/validacion-certificadoAlias validacion-certificado
POST/api/autenticacion/validacioncertificadoAlias sin guion
POST/api/autenticacion/api/validacioncertificadoAlias sin guion + api
POST/api/recepcion/ecfRecepcion de ECF (receptor)
POST/api/recepcion/api/ecfAlias recepcion/ecf
POST/api/aprobacioncomercial/ecfAprobacion comercial (receptor)
POST/api/aprobacioncomercial/api/ecfAlias aprobacioncomercial/ecf
POST/api/aprobacion-comercial/ecfAlias con guion
POST/api/aprobacion-comercial/api/ecfAlias con guion + api

Ejemplo Request

POST /api/test-scenarios-json

{
  "scenarios": [
    {
      "Version": "1.0",
      "TipoeCF": "32",
      "ENCF": "E320000000500",
      "RNCEmisor": "101085363",
      "RazonSocialEmisor": "M Q LAMPARAS SRL",
      "FechaEmision": "17-03-2026",
      "TipoIngresos": "01",
      "TipoPago": "1",
      "RazonSocialComprador": "Cliente Prueba",
      "MontoGravadoTotal": "7627.12",
      "MontoGravadoI1": "7627.12",
      "ITBIS1": "18",
      "TotalITBIS": "1372.88",
      "TotalITBIS1": "1372.88",
      "MontoTotal": "9000.00",
      "IndicadorMontoGravado": "0",
      "FormaPago[1]": "1",
      "MontoPago[1]": "9000.00",
      "NumeroLinea[1]": "1",
      "IndicadorFacturacion[1]": "1",
      "NombreItem[1]": "Servicio",
      "IndicadorBienoServicio[1]": "1",
      "CantidadItem[1]": "1.00",
      "PrecioUnitarioItem[1]": "7627.12",
      "MontoItem[1]": "7627.12",
      "CasoPrueba": "101085363E320000000500"
    }
  ]
}

Ejemplo Response

Escenario E32 menor de 250,000

{
  "status": "success",
  "code": 200,
  "message": "Proceso de pruebas completado",
  "data": {
    "results": [
      {
        "status": "success",
        "b2cResumenOnly": true,
        "codigoSeguridadeCF": "W4kZOh",
        "fechaHoraFirmaRFCE": "17-03-2026 11:02:01",
        "link_original": "https://ecf.dgii.gov.do/testecf/ConsultaTimbreFC?RncEmisor=101085363&eNCF=E320000000500"
      }
    ]
  }
}

Notas de Integracion

  • Usa /api/test para pruebas y /api/prod para produccion.
  • Existen aliases para compatibilidad: /api/api, /ecf/fe y /fe.
  • Todos los contratos y ejemplos detallados estan en Swagger UI.