QAPI está en beta — la API puede cambiar sin previo aviso. Usá sandbox para pruebas.
QAPIQAPIDocs · by DTEVIA
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_url del 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 id de la factura y el X-Request-ID.

Ver Emitir una Factura.

En esta página