> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stockshift.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Permisos y alcances

> En cada llamada se hacen dos comprobaciones: el permiso del miembro y el alcance del token.

En cada llamada se hacen dos comprobaciones, y ambas tienen que pasar:

1. El miembro detrás del token necesita el **permiso**, como `catalog.items.create`. Los permisos vienen del rol del miembro en la organización.
2. El token necesita el **alcance**, como `catalog:write`. Los alcances se eligen al crear la clave o cuando un miembro aprueba una app OAuth.

Una clave con `catalog:write` sigue sin poder crear artículos si el rol de su propietario no lo permite, y la clave de un propietario limitada a `inventory:read` no puede registrar ajustes. Cualquiera de los dos fallos responde `403` con el código `forbidden`. Cada endpoint de la referencia de la API indica el permiso y el alcance que necesita.

## Alcances

Los alcances vienen en pares de lectura y escritura para cada área de la app. Lectura cubre todo lo que solo consulta. Escritura cubre todo lo que cambia algo. Una clave de API también puede tener `*`, que equivale a todos los alcances; una app OAuth no.

| Área | Alcances |
| - | - |
| Acceso | `access:read` |
| Historial de auditoría | `audit:read` |
| Direcciones | `address:read`, `address:write` |
| Automatización | `automation:read`, `automation:write` |
| Facturación | `billing:read` |
| Catálogo | `catalog:read`, `catalog:write` |
| Panel | `dashboard:read`, `dashboard:write` |
| Desarrolladores | `developer:read`, `developer:write` |
| Dispositivos | `devices:read`, `devices:write` |
| Documentos | `documents:read`, `documents:write` |
| Ingeniería | `engineering:read`, `engineering:write` |
| Análisis | `insights:read`, `insights:write` |
| Integraciones | `integrations:read`, `integrations:write` |
| Inventario | `inventory:read`, `inventory:write` |
| Etiquetas | `labels:read`, `labels:write` |
| Biblioteca de productos | `library:read` |
| Fabricación | `manufacturing:read`, `manufacturing:write` |
| Notificaciones | `notifications:read`, `notifications:write` |
| Organización | `organization:read`, `organization:write` |
| Planificación | `planning:read`, `planning:write` |
| Compras | `purchasing:read`, `purchasing:write` |
| Calidad | `quality:read`, `quality:write` |
| Ventas | `sales:read`, `sales:write` |
| Sincronización | `sync:read`, `sync:write` |

Dale a cada clave solo los alcances que necesita para su trabajo. Una clave que alimenta un panel de existencias necesita `inventory:read` y nada más.

## Límites del plan

Algunas funciones dependen del plan de la organización. Una llamada a una función que el plan no incluye responde `403` con el código `plan_upgrade_required`, y `feature` indica qué falta. No se escribe nada.


## Related topics

- [Autenticación](https://docs.stockshift.io/es/guides/authentication.md)
- [Inicio rápido](https://docs.stockshift.io/es/quickstart.md)
- [Referencia de la API](https://docs.stockshift.io/es/api-reference/introduction.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.