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:
export DD_API_KEY="dd_test_…"
3. Prepara la empresa emisora
Antes de emitir, la empresa necesita tres cosas, todas configurables desde el portal:
- Datos fiscales y dirección. La API rechaza la emisión si la empresa no tiene dirección registrada.
- Certificado digital (.p12). Se carga una sola vez y queda custodiado cifrado.
- 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:
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" }
}]
}'
import { Client } from '@devsdesign/ecf';
const dd = new Client(process.env.DD_API_KEY);
const doc = await dd.documents.create({
company_id: process.env.DD_COMPANY_ID,
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' },
}],
});
console.log(doc.id, doc.encf);
use DevsDesign\Ecf\Client;
$client = new Client(getenv('DD_API_KEY'));
$doc = $client->documents->create([
'company_id' => getenv('DD_COMPANY_ID'),
'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'],
]],
]);
echo $doc['id'], ' ', $doc['encf'];
import os, requests
respuesta = requests.post(
"https://api.devsdesign.cloud/v1/documents",
headers={
"Authorization": f"Bearer {os.environ['DD_API_KEY']}",
"Idempotency-Key": "factura-10482",
},
json={
"company_id": os.environ["DD_COMPANY_ID"],
"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"},
}],
},
timeout=30,
)
doc = respuesta.json()
print(doc["id"], doc["encf"])
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:
{
"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.
curl https://api.devsdesign.cloud/v1/documents/doc_01hf…/status \
-H "Authorization: Bearer $DD_API_KEY"
7. Descarga el XML y el PDF
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
- Conoce todos los campos en Emitir comprobantes.
- Prepara tu código para reintentos con Idempotencia y límites.
- Revisa cómo se reportan los problemas en Errores.
¿Algo no está claro o falta en esta página? Escríbenos por el centro de soporte.