SDKs & Librerías

ECF SSD ofrece SDKs oficiales autogenerados a partir de nuestra especificación OpenAPI para las plataformas más populares. Cada librería proporciona un método de alto nivel sendEcf que maneja el ruteo, polling con backoff exponencial y manejo de errores automáticamente.

Código abierto — Todos los SDKs están disponibles en GitHub. El SDK de PHP se encuentra en un repositorio separado.

Entornos disponibles

Todos los SDKs soportan tres entornos:

EntornoBase URLUso
Testapi.test.ecfx.ssd.com.doDesarrollo y pruebas
Certapi.cert.ecfx.ssd.com.doCertificación DGII
Prodapi.prod.ecfx.ssd.com.doProducción

Autenticación

Todos los SDKs se autentican mediante JWT Bearer Token. Puede pasar el token directamente al crear el cliente o configurar la variable de entorno ECF_API_KEY.

Arquitectura Backend / Frontend

Los SDKs siguen un patrón de arquitectura dual:

  • EcfClient (Backend) — Envía ECFs con el token completo. Maneja firma, envío y polling.
  • EcfFrontendClient (Frontend) — Solo lectura. Usa un token con alcance limitado para consultar estado de comprobantes.

SDKs disponibles

.NET / C#

NuGet: SSDDO.ECF_DGII.SDK

TypeScript / JavaScript

npm: @ssddo/ecf-sdk

React

npm: @ssddo/ecf-react

Python

PyPI: ecf-dgii

Java / Android

Maven: do.com.ssd.ecfx:ecf-dgii-sdk-java

Kotlin

Maven: do.com.ssd.ecfx:ecf-dgii-sdk-kotlin

iOS / Swift

SPM: EcfDgiiClient

C++

vcpkg / Conan / NuGet

PHP

Composer: ecfx/ecf-dgii-php

Tipos de E-CF soportados

Todos los SDKs soportan los 10 tipos de comprobantes fiscales electrónicos:

CódigoTipo
E31Factura de Crédito Fiscal
E32Factura de Consumo
E33Nota de Débito
E34Nota de Crédito
E41Compras
E43Gastos Menores
E44Regímenes Especiales
E45Gubernamental
E46Exportaciones
E47Pagos al Exterior