Errores
FORBIDDEN (403)
Tu API key no tiene permisos para este recurso o acción.
HTTP 403 Forbidden
La autenticación fue exitosa pero tu API key no tiene permisos para ejecutar esta acción.
Ejemplo
{
"type": "https://docs.dtevia.com.gt/errors/forbidden",
"title": "FORBIDDEN",
"status": 403,
"detail": "Tu API key no tiene el scope requerido para esta operación: invoices:write",
"instance": "/v1/invoices"
}Causas
El detail dice cuál de las cuatro es:
| Causa | Qué pasó |
|---|---|
| Scope insuficiente | Tu API key es de solo lectura y estás intentando escribir (emitir o anular). Necesita el scope invoices:write |
| Listado de otro proyecto | Pediste GET /v1/invoices?project_id=… con el id de un proyecto distinto al de tu key. Cada key solo lista las facturas de su propio proyecto: omití project_id o usá la key de ese proyecto |
| Proyecto archivado | El proyecto emisor está archivado. Un proyecto archivado conserva sus facturas pero no puede emitir: reactivalo y generá una key nueva |
| Cuenta inactiva | La cuenta fue desactivada. Acá no hay nada que hacer del lado del código — contactá a soporte |
Una factura de otra cuenta o de otro proyecto da 404, no 403
Pedir una factura que pertenece a otra cuenta, o a otro proyecto de tu cuenta, devuelve
NOT_FOUND. O sea que si recibís un 403, el problema es de
permisos sobre algo tuyo, no de propiedad — eso acota bastante dónde buscar.
Cómo resolverlo
- Revisá el scope de tu API key: si emite o anula, necesita acceso completo, no solo lectura. En el dashboard, cada proyecto puede tener una key de cada tipo.
- Si filtrás por proyecto, usá la key de ese proyecto o quitá el
project_id. - Revisá el estado del proyecto si el
detailhabla de un archivado: reactivalo desde Proyectos y generá una key nueva, porque vuelve sin keys. - Si el
detailmenciona una cuenta inactiva, contactá a soporte con elX-Request-IDdel request fallido.