CERTIFIER_ERROR (502)
El certificador rechazó la anulación de una factura. Es exclusivo de POST /v1/invoices/:id/cancel.
HTTP 502 Bad Gateway
Exclusivo de POST /v1/invoices/:id/cancel: el certificador recibió la solicitud de
anulación y la rechazó (o falló la comunicación al anular).
No es un error de la emisión
La emisión (POST /v1/invoices) es asíncrona y nunca devuelve este código — siempre
responde 202. Si el certificador falla al firmar o certificar un DTE nuevo, eso no es un
error HTTP: la factura queda con status: "FAILED" y su propio error_code
(SIGN_FAILED o CERT_FAILED, un namespace interno distinto). Ver
Estados de Factura para ese caso.
Ejemplo
{
"type": "https://docs.dtevia.com.gt/errors/certifier-error",
"title": "CERTIFIER_ERROR",
"status": 502,
"detail": "Error al anular la factura en el certificador",
"instance": "/v1/invoices/inv_01jxyz/cancel"
}Qué significa
Un 502 en /cancel no anula nada: la factura queda exactamente como estaba —
CERTIFIED y vigente ante la SAT — porque QAPI solo marca CANCELLED después de que el
certificador confirma la anulación. Es seguro reintentar el mismo POST .../cancel.
Cómo resolverlo
- Confirmá el estado real de la factura con
GET /v1/invoices/:id(debería seguirCERTIFIED). - Reintentá la anulación en unos segundos — la mayoría de estos fallos son transitorios (comunicación con el certificador).
- Si persiste, reportá a soporte con el
X-Request-IDy elidde la factura.
Ver Anular una Factura.