Ir al contenido

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).

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.

  1. 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.
  2. 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.
  3. Cuando la DGII lo recibe, llega invoice.status_changed con el trackId y, 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.

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):

  1. Imprime la representación impresa con la leyenda «e-CF emitido en modalidad de contingencia» al pie.
  2. Cuando vuelva la conexión, envía el mismo XML firmado, con la misma Idempotency-Key en 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-Key si 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.

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.