Tezora

Contingencia

Cuando Hacienda no responde, Tezora emite un DTE de contingencia legalmente válido y lo transmite cuando Hacienda se restablece. La venta responde 201 con document.status.value en pending_contingency; ya tiene generation_code, control_number y JSON, y el PDF desde que está firmado, y aún no tiene received_stamp. La venta no debe reenviarse: otro POST /sales con otra llave crearía otra venta.

flowchart TD
  A[POST /sales] --> B{Hacienda responde}
  B -->|sí| C[processed o rejected]
  B -->|no| D[pending_contingency]
  D --> E[Revisión cada 5 minutos]
  E -->|sin servicio| D
  E -->|servicio restablecido| G[contingency_notified]
  G --> F[Lotes de hasta 100]
  F --> C
document.status.value Qué significa
pending_contingency El documento se firmó en contingencia (o quedó retenido) y espera que Hacienda vuelva.
contingency_notified Hacienda ya recibió el evento de contingencia que declara el documento, y el documento espera su lote. Dura segundos en la misma pasada. Para el sistema integrado es lo mismo que pending_contingency: el documento no tiene sello todavía, no admite notas ni invalidación, y en un lote la venta sigue en contingency.

Documentos del comienzo de una caída

Tezora declara la contingencia tras varios intentos fallidos seguidos. Un documento transmitido al inicio de la falla, cuyo resultado se desconoce, conserva la firma de transmisión normal (identificacion.tipoModelo 1, tipoOperacion 1) y queda retenido. Los documentos posteriores se firman como contingencia (tipoModelo 2, tipoOperacion 2, con tipoContingencia). Ambos casos se ven igual para el sistema integrado:

Un pending que no avanza

Cuánto dura un pending depende de cómo viaja el documento:

Caso Duración habitual Tope Lo que ve el sistema integrado mientras tanto
Transmisión individual (POST /sales, una venta de un lote fuera de la ventana de Hacienda) Unos segundos 5 minutos con los reintentos que manda Hacienda; si la transmisión se interrumpe, unos 10 minutos (ver abajo) pending con hold_reason nulo; pasados 5 minutos, hold_reason.value interrupted_transmission
Documento dentro de un lote de Hacienda (POST /sales/batches dentro de la ventana) Lo que tarde Hacienda en procesar el lote; Tezora le pregunta al menos una vez por minuto 10 minutos desde que Hacienda recibió el lote; si un reinicio interrumpe el seguimiento, hasta 15 pending con hold_reason nulo, y en GET /sales/batches/{uuid} la venta en pending con su lot

Mientras un documento está en pending, pdf_url es nulo y GET /sales/{uuid}/document/pdf responde 404 document_not_issued: se pide de nuevo hasta que pdf_url traiga el enlace. Lo mismo vale para un pending_contingency sin firma. El JSON sí se entrega.

Un documento largo en contingencia (más de 100 líneas o más de 100000 caracteres de descripción) responde 422 document_too_long en la ruta del PDF. POST /sales/{uuid}/document/send lo envía igual, con el JSON y, hasta 200 líneas y 200000 caracteres de descripción, el PDF.

Si Hacienda no da el resultado de un lote en esos 10 minutos, Tezora deja de esperarlo y resuelve cada documento uno por uno: consulta su generation_code, toma el sello que Hacienda tenga y envía solo los que no recibió. Llega el webhook de siempre. Una alerta del sistema integrado sobre un pending sin hold_reason usa el tope de su caso: 5 minutos para una transmisión individual y 15 para un documento con lot.

Si el proceso que lo enviaba se detiene antes de la respuesta de Hacienda (un corte de luz, un reinicio, un tiempo de espera agotado), el documento queda firmado y sin respuesta:

Un documento en pending_contingency o contingency_notified no admite notas (adjustment_note_no_accepted_document) ni invalidación (document_not_sealed) hasta que Hacienda lo selle.

Entrega al receptor

Un documento firmado en contingencia (identificacion.tipoOperacion 2) se entrega sin esperar el sello: POST /sales/{uuid}/document/send lo envía en pending_contingency o contingency_notified, con selloRecibido nulo en el JSON. El correo dice que el sello falta y que se verifica en la consulta pública de Hacienda.

Cuando Hacienda lo sella, el JSON de GET /sales/{uuid}/document/json ya lo trae, y Tezora no le escribe al receptor por su cuenta. Para entregarle el documento con su sello, se llama de nuevo a POST /sales/{uuid}/document/send: cada llamada es un correo.

Un documento retenido del comienzo de una caída (tipoOperacion 1) no se envía hasta tener sello, ni uno rechazado: responden 422 bajo errors.email y 404 document_not_issued, respectivamente.