QAPI está en beta — la API puede cambiar sin previo aviso. Usá sandbox para pruebas.
QAPIQAPIDocs · by DTEVIA
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.
GET
/v1/invoices/{id}

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"
}