Api
Obtener factura
Devuelve el estado actual de una factura, incluidas las creadas vía Sandbox.
Campos presentes según el estado
CERTIFIED:uuid_sat,serie,numero_dte,pdf_url,certified_at.FAILED:error_code,error_message.CANCELLED:cancelled_at.
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/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/invoices/inv_V1StGXR8_Z5jdHi6"{
"id": "inv_V1StGXR8_Z5jdHi6",
"status": "PENDING",
"tipo_dte": "FACT",
"moneda": "GTQ",
"gran_total": 112,
"numero_acceso": 543219876,
"certificador": "MOCK",
"origen": "api",
"project_id": "prj_8kQm2Xb1",
"project_nombre": "POS MARKET",
"modo": "sandbox",
"uuid_sat": "91cfb67b-89f6-4d15-a97b-76fa68e0db9c",
"serie": "QAPI",
"numero_dte": 42,
"pdf_url": "http://example.com",
"referencia_interna": "string",
"integrity_checksum": "string",
"error_code": "string",
"error_message": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"certified_at": "2019-08-24T14:15:22Z",
"cancelled_at": "2019-08-24T14:15:22Z"
}{
"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"
}{
"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"
}{
"type": "https://docs.dtevia.com.gt/errors/not-found",
"title": "NOT_FOUND",
"status": 404,
"detail": "Factura no encontrado",
"instance": "/v1/invoices/inv_V1StGXR8_Z5jdHi6"
}{
"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"
}