Api
PDF de la factura
Devuelve el PDF de la factura. Un solo endpoint para los dos casos — quien integra no necesita saber ni importarle si la factura es de prueba o real, QAPI decide del lado del servidor:
- Real (certificador ≠ MOCK): redirige (
302) a la representación gráfica provista por el certificador. - MOCK (sandbox): QAPI genera el PDF y devuelve los bytes directo (
200,application/pdf) — no hay certificador externo al cual redirigir.
Disponibilidad
- Facturas
CERTIFIEDy tambiénCANCELLED: el DTE anulado conserva su PDF, con la marca ANULADO (la agrega el certificador en las reales, QAPI mismo en las MOCK).
data.test también aplica acá
Igual que en los webhooks, tratá MOCK como "sin validez fiscal": el PDF de una factura de prueba lleva su propia marca de agua "DOCUMENTO DE PRUEBA", visible en el archivo.
Autorización
ApiKeyAuth AutorizaciónBearer <token>
API key con prefijo qapi_test_ (Sandbox) o qapi_live_ (producción), enviada en el header Authorization: Bearer <api_key>. Se genera en el dashboard, dentro de cada proyecto.
Va en: header
Parámetros de ruta
id*string
Cuerpo de la respuesta
application/pdf
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/invoices/inv_V1StGXR8_Z5jdHi6/pdf""string"Vacío
{
"type": "https://docs.dtevia.com.gt/errors/invalid-api-key",
"title": "INVALID_API_KEY",
"status": 401,
"detail": "API key inválida o revocada",
"instance": "/v1/invoices/inv_V1StGXR8_Z5jdHi6/pdf"
}{
"type": "https://docs.dtevia.com.gt/errors/email-not-verified",
"title": "EMAIL_NOT_VERIFIED",
"status": 403,
"detail": "Confirmá el correo de tu cuenta para usar Facturas y Sandbox.",
"instance": "/v1/invoices/inv_V1StGXR8_Z5jdHi6/pdf"
}{
"type": "https://docs.dtevia.com.gt/errors/not-found",
"title": "NOT_FOUND",
"status": 404,
"detail": "Factura no encontrado",
"instance": "/v1/invoices/inv_V1StGXR8_Z5jdHi6/pdf"
}{
"type": "https://docs.dtevia.com.gt/errors/pdf-not-available",
"title": "PDF_NOT_AVAILABLE",
"status": 409,
"detail": "El PDF solo está disponible para facturas certificadas. Estado actual: PROCESSING",
"instance": "/v1/invoices/inv_V1StGXR8_Z5jdHi6/pdf"
}{
"type": "https://docs.dtevia.com.gt/errors/rate-limited",
"title": "RATE_LIMITED",
"status": 429,
"detail": "Límite de requests excedido. Reintentar en 60s",
"instance": "/v1/invoices"
}{
"type": "https://docs.dtevia.com.gt/errors/internal-error",
"title": "INTERNAL_ERROR",
"status": 500,
"detail": "Error interno del servidor",
"instance": "/v1/invoices"
}{
"type": "https://docs.dtevia.com.gt/errors/pdf-url-untrusted",
"title": "PDF_URL_UNTRUSTED",
"status": 502,
"detail": "La URL del PDF del certificador no es de un dominio confiable",
"instance": "/v1/invoices/inv_V1StGXR8_Z5jdHi6/pdf"
}