Introducción
Qué es la API e-CF de Devsdesign, para quién está pensada y cómo se organiza.
Estado de la plataforma. La API e-CF de Devsdesign está en proceso de acreditación ante la DGII. Hoy puedes integrar y probar contra el ambiente de pruebas; la emisión con validez fiscal se habilitará al completar ese proceso.
Qué es la API
Es una API REST que recibe los datos de una venta en JSON y se encarga del resto del ciclo del comprobante fiscal electrónico (e-CF): valida el documento contra el esquema oficial, asigna la secuencia, lo firma con el certificado digital de la empresa, lo envía a la DGII y te avisa del resultado.
Tu sistema no necesita construir XML, manejar certificados ni hablar directamente con los servicios de la DGII.
Para quién está pensada
- Desarrolladores que integran facturación electrónica en una aplicación propia.
- Empresas que quieren conectar su ERP, su POS o su tienda en línea.
- Proveedores de software que atienden a varias empresas emisoras desde un mismo producto.
Conceptos fundamentales
| Concepto | Qué es |
|---|---|
| Cuenta | Tu organización dentro de la plataforma. Agrupa aplicaciones, empresas y usuarios. |
| API key | Credencial con la que tu backend se autentica. Tiene permisos acotados y pertenece a un ambiente. |
| Empresa emisora | Cada contribuyente (RNC) que emite comprobantes. Tiene su propio certificado y sus secuencias. Su identificador empieza por cmp_. |
| Comprobante | Un e-CF enviado a través de la API. Su identificador empieza por doc_. |
| e-NCF | El número de comprobante fiscal electrónico, tomado del rango de secuencias autorizado a la empresa. |
| Ambiente | Pruebas (dd_test_) o producción (dd_live_). Sus datos están completamente separados. |
Arquitectura general
La emisión es asíncrona. La API acepta el comprobante, responde de inmediato y lo procesa en segundo plano:
- Recepción. Tu sistema envía
POST /v1/documents. La API responde202con el identificador y el e-NCF asignado. - Validación. El documento se valida contra el XSD oficial del formato e-CF v1.0 y contra las reglas de cálculo.
- Firma. Se genera el XML y se firma digitalmente (XMLDSig) con el certificado de la empresa.
- Envío. El comprobante se transmite a la DGII, con reintentos y manejo de contingencia.
- Resultado. Tu sistema recibe un webhook con el estado final y puede descargar el XML firmado y el PDF.
Requisitos de integración
- Un backend capaz de hacer solicitudes HTTPS con cuerpo JSON. No hay restricción de lenguaje.
- Una URL pública con HTTPS si quieres recibir webhooks (recomendado).
- Por cada empresa emisora: su certificado digital (.p12) y los rangos de secuencia e-NCF autorizados.
Convenciones de la API
- URL base:
https://api.devsdesign.cloud/v1 - Formato: JSON en solicitudes y respuestas. Los importes se envían como texto para conservar la precisión, por ejemplo
"1000.0000". - Trazabilidad: cada respuesta incluye el encabezado
X-Request-Id. Guárdalo en tus registros: es el dato que más agiliza un diagnóstico. - Errores: siguen el formato
application/problem+json, descrito en Errores.
¿Algo no está claro o falta en esta página? Escríbenos por el centro de soporte.