Ir al contenido
Open Factura

Contingencia

Si el MH no responde al emitir, Open Factura no pierde la venta: emite el documento en contingencia (modelo diferido). Responde 202 Accepted con estado contingencia.

  • El documento ya es válido: quedó firmado y tiene número de control. Entréguelo normalmente.
  • No lo vuelva a emitir.
  • Debe transmitirse al MH después, con el evento de contingencia.

Transmitir

Sección titulada «Transmitir»
Ventana de terminal
curl -X POST https://openfactura.co/api/v1/contingencia/transmitir \
  -H "Authorization: Bearer $OPENFACTURA_API_KEY"

Requiere el permiso dte:invalidate y el responsable configurado en los datos del emisor. Open Factura envía el evento de contingencia con hasta 40 documentos del ambiente activo y luego transmite cada uno. La respuesta:

{ "evento": { "id": "…", "codigoGeneracion": "…" }, "procesados": [], "rechazados": [], "restantes": 0 }
  • procesados: documentos que recibieron sello.
  • rechazados: documentos que el MH rechazó.
  • restantes: si es mayor que 0, vuelva a llamar.
  • Si el MH vuelve a caer, lo que falta sigue en contingencia para el próximo intento.
  • Si el MH rechaza el evento: 422 contingencia_rechazada con details.mh.

Contingencia no es emisión incierta

Sección titulada «Contingencia no es emisión incierta»
Situación Código / estado Qué hacer
El MH no respondió 202, estado contingencia Entregue el documento y transmita la contingencia.
Resultado desconocido 502 emision_incierta, pendiente No emita otro. Consulte GET /dte/{details.codigoGeneracion}; el servidor lo concilia solo con el MH cada pocos minutos.
El MH no estaba disponible antes de firmar 502 mh_no_disponible No se consumió número de control: reintente con la misma Idempotency-Key.