DEVSDESIGN — DEVELOPERS & DESIGN

API v1 · contrato 1.0.0

Primeros pasos

De la solicitud de acceso a tu primer comprobante en el ambiente de pruebas.

Esta guía te lleva desde cero hasta un comprobante aceptado en el ambiente de pruebas.

1. Solicita acceso

El acceso a la API se habilita por solicitud. Escríbenos indicando qué sistema quieres integrar. Recibirás una cuenta con acceso al portal.

2. Crea una API key de pruebas

En el portal, abre tu aplicación y genera una API key. La administración de credenciales exige verificación en dos pasos (MFA) y una confirmación reciente de identidad.

Las claves de pruebas empiezan por dd_test_. Guarda la clave en una variable de entorno de tu servidor:

Terminal
export DD_API_KEY="dd_test_…"

3. Prepara la empresa emisora

Antes de emitir, la empresa necesita tres cosas, todas configurables desde el portal:

  1. Datos fiscales y dirección. La API rechaza la emisión si la empresa no tiene dirección registrada.
  2. Certificado digital (.p12). Se carga una sola vez y queda custodiado cifrado.
  3. Rangos de secuencia e-NCF para cada tipo de comprobante que vayas a emitir, con su fecha de vencimiento.

También puedes registrar la empresa por API:

Registrar una empresa
curl https://api.devsdesign.cloud/v1/companies \
  -H "Authorization: Bearer $DD_API_KEY" \
  -H "Idempotency-Key: alta-empresa-001" \
  -H "Content-Type: application/json" \
  -d '{
    "rnc": "101000000",
    "legal_name": "Empresa de Ejemplo SRL",
    "slug": "empresa-ejemplo",
    "address": "Av. Ejemplo 123, Santo Domingo"
  }'

4. Envía tu primer comprobante

Este ejemplo emite una Factura de Crédito Fiscal Electrónica (tipo 31) por un servicio de RD$1,000 más ITBIS.

curl https://api.devsdesign.cloud/v1/documents \
  -H "Authorization: Bearer $DD_API_KEY" \
  -H "Idempotency-Key: factura-10482" \
  -H "Content-Type: application/json" \
  -d '{
    "company_id": "cmp_…",
    "type": "31",
    "issue_date": "2026-11-16",
    "income_type": "01",
    "payment": { "type": "cash" },
    "buyer": { "rnc": "101000000", "name": "Comprador de Ejemplo SRL" },
    "currency": { "code": "DOP" },
    "items": [{
      "line": 1,
      "kind": "service",
      "name": "Servicio de consultoría",
      "quantity": "1.0000",
      "unit_price": "1000.0000",
      "tax": { "itbis_rate": "18" }
    }]
  }'

No hay SDK oficial para Python: el ejemplo usa la API REST directamente, igual que harías desde C#, Java o Go.

5. Interpreta la respuesta

La API responde 202 Accepted. El comprobante quedó en cola y ya tiene su e-NCF asignado:

Respuesta 202
{
  "id": "doc_01hf…",
  "object": "document",
  "status": "queued",
  "encf": "E310000000124",
  "is_rfce": false
}

6. Consulta el resultado

Consulta el estado hasta que sea terminal (accepted, accepted_conditional, rejected o invalid), o mejor aún, suscríbete a los webhooks para recibirlo sin consultar.

Consultar estado
curl https://api.devsdesign.cloud/v1/documents/doc_01hf…/status \
  -H "Authorization: Bearer $DD_API_KEY"

7. Descarga el XML y el PDF

Descargar artefactos
curl https://api.devsdesign.cloud/v1/documents/doc_01hf…/xml -H "Authorization: Bearer $DD_API_KEY" -o factura.xml
curl "https://api.devsdesign.cloud/v1/documents/doc_01hf…/pdf?format=a4" -H "Authorization: Bearer $DD_API_KEY" -o factura.pdf

Qué sigue

¿Algo no está claro o falta en esta página? Escríbenos por el centro de soporte.