DEVSDESIGN — DEVELOPERS & DESIGN

API v1 · contrato 1.0.0

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

ConceptoQué es
CuentaTu organización dentro de la plataforma. Agrupa aplicaciones, empresas y usuarios.
API keyCredencial con la que tu backend se autentica. Tiene permisos acotados y pertenece a un ambiente.
Empresa emisoraCada contribuyente (RNC) que emite comprobantes. Tiene su propio certificado y sus secuencias. Su identificador empieza por cmp_.
ComprobanteUn e-CF enviado a través de la API. Su identificador empieza por doc_.
e-NCFEl número de comprobante fiscal electrónico, tomado del rango de secuencias autorizado a la empresa.
AmbientePruebas (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:

  1. Recepción. Tu sistema envía POST /v1/documents. La API responde 202 con el identificador y el e-NCF asignado.
  2. Validación. El documento se valida contra el XSD oficial del formato e-CF v1.0 y contra las reglas de cálculo.
  3. Firma. Se genera el XML y se firma digitalmente (XMLDSig) con el certificado de la empresa.
  4. Envío. El comprobante se transmite a la DGII, con reintentos y manejo de contingencia.
  5. 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.