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
- Tratá la consulta como opcional — enviá el
nombredel receptor manualmente y seguí con la factura sin depender de esta consulta. - Reintentá después de 30-60 segundos si igual la necesitás.
- Si persiste más de 5 minutos, reportá a soporte con el
X-Request-ID.