QAPI está en beta — la API puede cambiar sin previo aviso. Usá sandbox para pruebas.
QAPIQAPIDocs · by DTEVIA
Errores

NOT_FOUND (404)

El recurso solicitado no existe o tu API key no tiene acceso a él.

HTTP 404 Not Found

El ID del recurso no existe, o existe pero tu API key no tiene acceso a él: es de otra cuenta o de otro proyecto de tu cuenta.

No es exclusivo de facturas. El mismo código cubre cualquier recurso que se pida por id, y el detail dice cuál: la factura, o el NIT/CUI que no aparece en el padrón. También responde así cualquier ruta que no exista.

Una factura de otro proyecto también da 404

Cada API key ve solo las facturas de su proyecto. Si el id existe pero es de otro proyecto —tuyo o de otra cuenta—, la respuesta es 404, no 403. Tenelo en cuenta al depurar: un 404 sobre un id que sabés que existe suele significar que estás usando la key de otro proyecto.

Ejemplo

{
  "type": "https://docs.dtevia.com.gt/errors/not-found",
  "title": "NOT_FOUND",
  "status": 404,
  "detail": "Factura no encontrado",
  "instance": "/v1/invoices/inv_V1StGXR8_Z5jdHi6"
}

Causas comunes

  • El id de la factura está mal escrito o fue copiado incorrectamente
  • La factura se emitió con la key de otro proyecto: consultala con la key del proyecto que la emitió

Cómo resolverlo

Verificá que:

  1. El id comienza con inv_ seguido de caracteres válidos
  2. La API key que usás es del mismo proyecto con el que se emitió la factura

No hay un GET separado para sandbox

GET /v1/invoices/:id consulta cualquier factura del proyecto de tu key, sea de prueba o real — no existe un GET /v1/sandbox/invoices/:id aparte. /v1/sandbox/invoices solo tiene el POST de creación; la consulta siempre es por el endpoint normal.

En esta página