DEVSDESIGN — DEVELOPERS & DESIGN

La API de facturación electrónica para República Dominicana

Emite, firma, valida y consulta comprobantes fiscales electrónicos (e-CF) con una sola API REST. Hecha para equipos que integran sistemas ERP y puntos de venta y necesitan idempotencia estricta y apego al formato de la DGII.

La plataforma está en proceso de acreditación ante la DGII. Mientras tanto, la integración se prueba contra un simulador local.

api.devsdesign.cloud
POST /v1/documents
Authorization: Bearer dd_test_…
Idempotency-Key: pedido-10482

{
  "company_id": "tu-company-id",
  "type": "31",
  "issue_date": "2026-11-16",
  "income_type": "01",
  "payment": { "type": "cash" },
  "buyer": { "rnc": "101000000" },
  "currency": { "code": "DOP" },
  "items": [{
    "line": 1,
    "kind": "service",
    "name": "Servicio de consultoría",
    "quantity": "1.0000",
    "unit_price": "1000.0000",
    "tax": { "itbis_rate": "18" }
  }]
}
Entidad registrada
RNC 132878061
Contrato
OpenAPI versionado
Reintentos seguros
Idempotencia por solicitud
Verificación
Suite automatizada

Qué ocurre con cada comprobante que envías

Tu sistema envía un JSON. La validación, la firma digital, el envío a la DGII y la representación impresa quedan del lado de la API.

  1. Recepción

    202 · queued

    La API responde de inmediato y pone el documento en cola. La clave de idempotencia impide duplicados si reintentas.

  2. Validación

    XSD v1.0

    Estructura, redondeo, ITBIS y catálogos oficiales se revisan antes de consumir una secuencia fiscal.

  3. Firma digital

    XMLDSig

    El XML se firma con el certificado de tu empresa, custodiado cifrado y aislado de los demás emisores.

  4. Envío a la DGII

    Reintentos controlados

    Si la DGII no responde, el comprobante pasa a contingencia y se reenvía sin intervención tuya.

  5. Resultado

    accepted

    Recibes un webhook firmado con el estado final. El XML y la representación impresa en PDF quedan disponibles.

Diseñada para la emisión fiscal a escala

La firma digital, la validación XSD y el control de secuencias fiscales quedan fuera de tu software de gestión.

Ver la arquitectura completa
Validación XSD v1.0 preventiva

Inspección estructural antes de consumir secuencias fiscales: sintaxis, reglas de redondeo, ITBIS y catálogos oficiales de unidades y tipos de pago.

Detecta rechazos antes de la firma digital.

Custodia segura de certificados

Los certificados digitales (.p12) se almacenan cifrados en una bóveda protegida. Las claves privadas operan aisladas por empresa emisora.

La clave privada nunca se expone a interfaces públicas.

Control atómico de secuencias

Gestión transaccional en PostgreSQL que evita saltos o colisiones en la numeración de los e-NCF.

Seguro con varias terminales y cajas POS a la vez.

Representación impresa en PDF

Genera la representación impresa en formato ticket (80 mm) y hoja completa (A4/Carta), con el código QR fiscal.

Lista para imprimir o enviar al comprador.

Receptor comercial y acuses

Recibe los e-CF que emiten tus proveedores, valida sus firmas digitales y genera acuses de recibo y aprobación comercial.

Cubre el ciclo comercial electrónico completo.

Entorno sandbox y simulador

Ambiente de pruebas para ensayar emisiones, anulaciones y consultas contra un simulador de respuestas, sin tocar datos de producción.

Integra y prueba antes de salir a producción.

Facturación electrónica e-CF

Los tipos de comprobante y sus requisitos están detallados en la guía de facturación electrónica.

Consultar la guía e-CF

Tres pasos hasta tu primer e-CF

Es una API REST con JSON sobre HTTPS: funciona desde PHP, Python, Node.js, C#, Go o cualquier lenguaje con un cliente HTTP.

  1. Obtén credenciales de prueba

    Genera tu API Key en el portal y carga el certificado digital de prueba (.p12) para operar contra el simulador.

  2. Envía tu comprobante en JSON

    Haz una petición POST al endpoint unificado con tu clave de idempotencia y los datos de la factura.

  3. Recibe el webhook y el PDF

    Tu sistema recibe la confirmación, el XML firmado y la representación impresa para entregar al comprador.

curl https://api.devsdesign.cloud/v1/documents \
  -H "Authorization: Bearer $DD_API_KEY" \
  -H "Idempotency-Key: pedido-10482" \
  -H "Content-Type: application/json" \
  -d @factura-31.json

# 202 Accepted
# {"id":"doc_01hf…","status":"queued","encf":"E310000000124"}

Documentación que puedes leer antes de decidir

La documentación es pública: guías, referencia de las 24 operaciones y ejemplos de código. No hace falta una cuenta para evaluar si la API encaja con tu sistema.

Seguridad que se puede revisar

Los comprobantes fiscales y los certificados digitales son información sensible. Estas medidas forman parte de la plataforma.

Firma en un servicio aislado
Las claves privadas solo son accesibles para el componente que firma, nunca para la API pública.
Datos separados por cliente
El aislamiento se aplica en la base de datos, no solo en la aplicación.
Permisos mínimos
Cada API key tiene alcances y ambiente propios, y puede rotarse o revocarse.
Auditoría verificable
Las acciones relevantes quedan en un registro encadenado.

Qué puedes comprobar

  • El contrato OpenAPI está versionado en el repositorio.
  • Los webhooks usan HMAC y el encabezado webhook-signature.
  • Las escrituras requieren Idempotency-Key.
  • El repositorio incluye una suite de pruebas automatizadas.
Ver todas las medidas de seguridad

Preguntas frecuentes

Lo esencial sobre la plataforma de API e-CF, la acreditación y el soporte técnico.

¿Cuál es el estado actual de la plataforma ante la DGII?

La plataforma e-CF API está en proceso de acreditación. Mientras tanto, la integración se prueba contra un simulador local; la operación productiva queda sujeta a completar el proceso correspondiente.

¿Qué lenguaje o stack se requiere para consumir la API?

Ninguno en particular. Al tratarse de una API REST que opera con JSON y HTTPS estándar, puedes conectarte desde cualquier entorno: Laravel/PHP, .NET/C#, Node.js, Python, Go o directamente desde sistemas POS de escritorio.

¿Cómo gestiona la API la custodia del certificado digital?

Los certificados .p12 se almacenan cifrados en bóvedas aisladas. El sistema firma digitalmente los XML sin exponer la clave privada a interfaces públicas ni a otros usuarios.

¿Qué sucede ante una caída de red o fallo de conexión?

La API implementa idempotencia estricta mediante el encabezado Idempotency-Key. Si tu sistema reintenta una petición ante un corte de red, la API devuelve el comprobante original sin generar duplicados fiscales ni consumir secuencias adicionales.

¿Cómo funciona el portal de soporte técnico?

Puedes crear y consultar solicitudes en el centro de soporte de Devsdesign. El sitio explica las vías disponibles y los pasos para dar seguimiento.

Hablemos sobre tu integración

Conversemos sobre cómo conectar tus sistemas con nuestra plataforma de API e-CF. Si ya dispones de una cuenta y requieres asistencia, abre un ticket en el centro de soporte.

Correo: info@devsdesign.org

Teléfono: 809-528-8260

WhatsApp: (829) 467-8522

RNC: 132878061

Solicitar acceso a la API o información técnica

Atención formal para desarrolladores y empresas en República Dominicana.