QAPI está en beta — la API puede cambiar sin previo aviso. Usá sandbox para pruebas.
QAPIQAPIDocs · by DTEVIA
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:

CausaQué pasó
Scope insuficienteTu API key es de solo lectura y estás intentando escribir (emitir o anular). Necesita el scope invoices:write
Listado de otro proyectoPediste 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 archivadoEl proyecto emisor está archivado. Un proyecto archivado conserva sus facturas pero no puede emitir: reactivalo y generá una key nueva
Cuenta inactivaLa 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

  1. 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.
  2. Si filtrás por proyecto, usá la key de ese proyecto o quitá el project_id.
  3. Revisá el estado del proyecto si el detail habla de un archivado: reactivalo desde Proyectos y generá una key nueva, porque vuelve sin keys.
  4. Si el detail menciona una cuenta inactiva, contactá a soporte con el X-Request-ID del request fallido.

En esta página