Contingencia
La DGII exige entregar la representación impresa después de enviar el e-CF y recibir su respuesta (el TrackID). Si la DGII no responde, su norma (Informe Técnico e-CF, sección 19) permite emitir en contingencia: imprimir con una leyenda y enviar el e-CF cuando vuelva la comunicación, en un plazo máximo de 72 horas.
La contingencia automática está disponible cuando tu cuenta tiene activado «TrackID por defecto y contingencia»
(portal, Configuración → Cuenta). Sin ese ajuste, una falla de la DGII deja el comprobante en Failed y se reintenta
con el reenvío (POST /v1/invoices/{id}/resend).
Cómo lo ves en la API
Sección titulada «Cómo lo ves en la API»Con ?wait=sent, si la DGII no responde a tiempo, responde con un error de red o de servidor, la respuesta trae:
{ "status": "Signed", "sentWait": "Contingency", "encf": "E310000000123", "securityCode": "Ab3dE9", "signedAt": "2026-11-16T10:15:02-04:00", "timbreUrl": "https://…", "contingency": { "since": "2026-11-16T14:15:06Z", "deadline": "2026-11-19T14:15:02Z", "legend": "e-CF emitido en modalidad de Contingencia, el cual podrá ser consultado para su validez fiscal, a partir de las setenta y dos (72) horas." }}También llega el webhook invoice.contingency.
Qué haces tú
Sección titulada «Qué haces tú»- Imprime con los datos de siempre (e-NCF, código de seguridad, fecha de firma y QR) y agrega al pie el texto
de
contingency.legend, que es el del modelo de la DGII. - Nada más. El envío sigue solo: reintentamos a los 30 s, 1, 2 y 5 minutos y luego cada 10 minutos, siempre consultando antes a la DGII para no duplicarlo.
- Cuando la DGII lo recibe, llega
invoice.status_changedcon eltrackIdy, después, el resultado.
El PDF de la API (GET /v1/invoices/{id}/pdf) ya incluye la leyenda, y la conserva después del TrackID porque es lo
que recibió el comprador.
Lo que no es contingencia
Sección titulada «Lo que no es contingencia»| Caso | Qué pasa |
|---|---|
| La DGII rechaza el comprobante | Es Rejected, no contingencia. No se imprime: se corrige y se reenvía. |
| Nuestra respuesta no alcanzó a enviar en su tiempo, sin falla de la DGII | sentWait: TimedOut. Espera el webhook o repite con la misma Idempotency-Key. |
| Tu sistema no puede comunicarse con nosotros | Depende de quién firma el XML: ver la sección siguiente. |
Si tu sistema no puede comunicarse con nosotros
Sección titulada «Si tu sistema no puede comunicarse con nosotros»El código de seguridad y el QR salen de la firma del e-CF. Por eso lo que puedes hacer sin conexión depende de quién numera y firma.
Tu sistema numera y firma el XML (POST /v1/invoices/signed)
Sección titulada «Tu sistema numera y firma el XML (POST /v1/invoices/signed)»Tu sistema ya tiene el e-NCF, la firma, el código de seguridad y el QR, así que es la contingencia por falta de conectividad del Informe Técnico e-CF (§19.1):
- Imprime la representación impresa con la leyenda «e-CF emitido en modalidad de contingencia» al pie.
- Cuando vuelva la conexión, envía el mismo XML firmado, con la misma
Idempotency-Keyen cada intento, dentro de las 72 horas desde la firma.
Envías JSON y nosotros numeramos y firmamos (POST /v1/invoices)
Sección titulada «Envías JSON y nosotros numeramos y firmamos (POST /v1/invoices)»Sin conexión con nosotros no hay e-CF: no hay e-NCF asignado, ni firma, ni código de seguridad, ni QR. No se puede imprimir una representación impresa en contingencia.
- Si la operación puede esperar, envía la factura cuando vuelva la conexión (con la misma
Idempotency-Keysi ya la habías intentado enviar). - Si no puede esperar, el Informe Técnico e-CF (§19.2, «cuando no sea posible la emisión del e-CF») indica usar secuencias autorizadas de comprobantes fiscales no electrónicos, por un máximo de 15 días, y regularizar después ante la DGII en un plazo de 30 días. Ese procedimiento es entre tu empresa y la DGII; consulta el documento antes de aplicarlo.
Plazo de 72 horas
Sección titulada «Plazo de 72 horas»El plazo se cuenta desde la firma (contingency.deadline). Mientras el comprobante siga sin llegar a la DGII, los
reintentos continúan y el sistema:
- envía un correo a los dueños de la cuenta a las 24, las 48 y las 66 horas (este último, «quedan 6 horas»);
- a las 72 horas envía otro correo y marca el comprobante «fuera de plazo» en su historial. Los reintentos siguen igual.