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
idde 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:
- El
idcomienza coninv_seguido de caracteres válidos - 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.