QAPI está en beta — la API puede cambiar sin previo aviso. Usá sandbox para pruebas.
QAPIQAPIDocs · by DTEVIA
Errores

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

  1. Confirmá el estado real de la factura con GET /v1/invoices/:id (debería seguir CERTIFIED).
  2. Reintentá la anulación en unos segundos — la mayoría de estos fallos son transitorios (comunicación con el certificador).
  3. Si persiste, reportá a soporte con el X-Request-ID y el id de la factura.

Ver Anular una Factura.

En esta página