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

BAD_GATEWAY (502)

La consulta de NIT/CUI al certificador falló por un error de comunicación. Exclusivo de GET /v1/receptores.

HTTP 502 Bad Gateway

Exclusivo de GET /v1/receptores/nit/{nit} y GET /v1/receptores/cui/{cui}: QAPI no pudo comunicarse correctamente con el servicio de información del certificador para esa consulta.

No tiene relación con emitir o certificar una factura

La emisión (POST /v1/invoices) es asíncrona y nunca devuelve este código. Este error es solo de la consulta opcional de NIT/CUI para pre-llenar el receptor.

Ejemplo

{
  "type": "https://docs.dtevia.com.gt/errors/bad-gateway",
  "title": "BAD_GATEWAY",
  "status": 502,
  "detail": "La consulta al certificador falló: servicio no disponible",
  "instance": "/v1/receptores/nit/1514318"
}

Cómo resolverlo

  1. Tratá la consulta como opcional — enviá el nombre del receptor manualmente y seguí con la factura sin depender de esta consulta.
  2. Reintentá después de 30-60 segundos si igual la necesitás.
  3. Si persiste más de 5 minutos, reportá a soporte con el X-Request-ID.

En esta página