1. Preparar
Confirma el estado del emisor, el ambiente y quién custodia el certificado y las secuencias. Revisar requisitos →
De tu operación comercial a un resultado fiscal trazable
Integra una vez, evita la doble emisión y sigue cada e-CF hasta conocer la respuesta oficial.
Referencia contractualOpenAPI 3.1 disponible
Abrir referencia API La referencia navegable se genera desde el mismo contrato tipado que usa la API.
El recorrido de una integración
Sección titulada «El recorrido de una integración»2. Emitir
Envía datos estructurados, conserva tu external_id y trata la primera respuesta como
recepción técnica, no como aceptación DGII.
Crear la primera factura →
3. Seguir
Consulta siempre el estado; en ambientes DGII habilitados, recibe además webhooks firmados. Entender los estados →
4. Operar
Reconcilia artefactos, atiende excepciones y preserva evidencia sin repetir una emisión incierta. Diseñar reintentos →
Dos fuentes de verdad, una sola emisión
Sección titulada «Dos fuentes de verdad, una sola emisión»Tu software continúa siendo la fuente de la operación comercial: cliente, productos, precios y acuerdo de pago. CierreListo conserva la fuente fiscal resultante: e-NCF, XML firmado, TrackId, estados DGII, representaciones y evidencia.
Esta separación evita dos errores comunes:
- interpretar
202 Acceptedcomo aprobación fiscal; - volver a emitir porque una respuesta tardó o una conexión se interrumpió.
Antes de escribir código
Sección titulada «Antes de escribir código»- Define un identificador externo inmutable para cada operación.
- Acuerda qué sistema puede crear, corregir o anular.
- Define el punto de corte para impedir doble emisión.
- Confirma el ambiente y los tipos e-CF habilitados.
- Diseña idempotencia y reconciliación antes del primer
POST.