Errores
PDF_URL_UNTRUSTED (502)
La URL del PDF guardada no corresponde a un dominio de certificador confiable. Red de seguridad interna.
HTTP 502 Bad Gateway
Exclusivo de facturas certificadas en live: GET /v1/invoices/:id/pdf se niega a
redirigirte porque el pdf_url guardado no apunta a un dominio de certificador conocido.
No aplica a MOCK — ahí QAPI genera el PDF él mismo, sin redirigir a ningún lado.
No deberías ver esto en uso normal
El pdf_url de una factura live lo genera el pipeline de certificación a partir del
dominio del certificador (nunca lo elige el cliente). Este chequeo solo se dispara si
esos datos quedaron corruptos o mal configurados. Si te aparece, es un problema del lado de QAPI, no de tu integración.
Ejemplo
{
"type": "https://docs.dtevia.com.gt/errors/pdf-url-untrusted",
"title": "PDF_URL_UNTRUSTED",
"status": 502,
"detail": "La URL del PDF no corresponde a un dominio confiable"
}Cómo resolverlo
- El campo
pdf_urldel objeto de la factura (GET /v1/invoices/:id) sigue disponible aunque el redirect esté bloqueado — podés leerlo directo en vez de usar/pdf. - Reportá a soporte con el
idde la factura y elX-Request-ID.
Ver Emitir una Factura.