Saltar al contenido
Vintu API
Tema de la documentación
Ir a la app

Permisos

Cada clave lleva una lista de permisos que se elige al crearla. Una operación que pide un permiso que la clave no tiene responde 403 SCOPE_REQUIRED, aunque la clave sea válida.

Permisos de lectura

PermisoQué permite leer
empresas:leerLas empresas (RUC y razón social) registradas en la cuenta.
comprobantes:leerLos comprobantes y la descarga de sus originales.
avisos:leerLos avisos de los buzones SUNAT y SUNAFIL.
vencimientos:leerLos próximos vencimientos tributarios de cada empresa.

Al crear una clave vienen marcados los cuatro. Desmarca los que la integración no use: una clave que solo sincroniza comprobantes no necesita leer avisos.

Qué pide cada operación

Generado de la extensión x-vintu-permisos del OpenAPI:

Permiso Operaciones
avisos:leer
comprobantes:leer
empresas:leer
vencimientos:leer
Ninguno

Cambiar los permisos de una clave

Los permisos no se editan después de crear la clave. Para cambiarlos, crea una clave nueva con los permisos que quieras, despliégala y revoca la anterior, como en una rotación.

Alcance de empresas

En esta versión, toda clave alcanza todas las empresas de la cuenta. Para leer solo las de una empresa, usa el filtro empresa_id de los listados; no es un permiso, y no limita lo que la clave puede pedir.