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

# Roles y permisos

> Cómo crear roles, invitar colaboradores y definir límites operativos sin dar accesos de más

## Para qué sirve

Esta guía te permite definir:

1. Qué puede ver y hacer cada puesto (rol).
2. Qué límites comerciales tiene cada persona (descuento y comisión).
3. En qué cajas, ubicaciones y puntos de venta puede operar cada colaborador.
4. Qué alcance de datos ve cada usuario.

En la práctica, evita errores operativos y accesos de más.

## Antes de empezar

1. Necesitás permisos de `Configuración`.
2. Conviene tener al menos un rol base creado (por ejemplo, `Vendedor`).
3. Si vas a restringir por operación, verificá que ya existan:
   * Cajas y ubicaciones.
   * Puntos de venta.

## Dónde está en la app

Tenés dos pestañas en la misma sección:

1. `Configuración > Colaboradores > Colaboradores`
   Menú: [/configuracion/colaboradores](https://app.lapyme.com.ar/?next=%2Fconfiguracion%2Fcolaboradores)
2. `Configuración > Colaboradores > Roles y permisos`
   Menú: [/configuracion/roles](https://app.lapyme.com.ar/?next=%2Fconfiguracion%2Froles)

## Flujo 1: crear un rol

1. Entrá a `Configuración > Colaboradores`.
2. Abrí la pestaña `Roles y permisos`.
3. Tocá `Nuevo rol`.
4. Completá `Nombre del rol`.
5. Definí permisos:
   * `Todos los módulos` para asignación rápida.
   * `Permisos por módulo` para ajustar fino.
   * `Reportes` por grupos (no solo todo/nada).
   * `Acciones especiales` para permisos sensibles.
6. Guardá con `Crear rol`.

## Flujo 2: editar, duplicar o eliminar un rol

En `Configuración > Colaboradores > Roles y permisos`, abrí el menú de acciones del rol:

1. `Editar rol`: cambia nombre y permisos.
2. `Duplicar rol`: crea una copia con sufijo `(copia)` y mismos permisos.
3. `Eliminar rol`: solo disponible si ese rol no tiene miembros activos.

Si el rol tiene miembros, la app bloquea el borrado y primero tenés que reasignarlos.

## Flujo 3: invitar un colaborador

1. Entrá a `Configuración > Colaboradores`.
2. Hacé clic en `Invitar`.
3. Completá:
   * Email del colaborador.
   * Rol.
   * Visibilidad de datos.
   * Descuento máximo.
   * Comisión.
   * Acceso a cajas/ubicaciones.
   * Puntos de venta.
4. Guardá.

La invitación se envía por email y vence a los 7 días.

## Flujo 4: editar un colaborador activo

1. En `Configuración > Colaboradores`, abrí acciones de la fila.
2. Elegí `Editar colaborador`.
3. Ajustá nombre, rol, límites y accesos.
4. Guardá.

Este cambio impacta sobre permisos y límites operativos de ese usuario.

## Flujo 5: desactivar o activar un colaborador

Desde acciones de la fila:

1. `Desactivar` para cortar acceso sin borrar historial.
2. `Activar` para restaurar el acceso luego.

## Flujo 6: reenviar o cancelar invitaciones

En filas de invitación:

1. `Reenviar invitación` cuando está pendiente o expirada.
2. `Cancelar invitación` para anularla.

Al reenviar, la invitación vuelve a estado pendiente y renueva vencimiento por 7 días.

## Qué cambia al guardar

### Si guardás un rol

1. Se actualizan los módulos y acciones habilitadas para quienes tengan ese rol.
2. Si el rol ya estaba asignado, el cambio impacta también en usuarios existentes.

### Si guardás un colaborador o invitación

1. Rol: define menú y acciones disponibles.
2. Visibilidad de datos:
   * `Solo sus operaciones`.
   * `Ubicaciones asignadas`.
   * `Todo el negocio`.
3. Descuento máximo: limita hasta qué porcentaje puede descontar.
4. Comisión: define porcentaje de comisión de ese usuario.
5. Cajas/ubicaciones/PV: limita dónde puede operar.

## Dónde se refleja

1. Menú lateral y pantallas habilitadas según rol.
2. Acciones permitidas dentro de cada módulo (ver, crear/editar, exportar, especiales).
3. Operación diaria en cajas, ubicaciones y puntos de venta según asignación.
4. Límite de descuento aplicado en la venta.
5. Cálculo de comisión del colaborador.

## Comportamientos no obvios (importante)

1. Si seleccionás una caja, la ubicación de esa caja también se asigna automáticamente.
2. `Seleccionar todas las cajas` asigna todas las cajas y todas las ubicaciones.
3. No podés eliminar un rol que tiene miembros activos.
4. No podés modificar ni desactivar al dueño de la organización.
5. No podés desactivarte a vos mismo.
6. Las invitaciones vencen a los 7 días y se pueden reenviar para renovar ese plazo.

## Errores comunes

1. `Ya existe un rol con este nombre`:
   * Renombrá el rol o duplicá y ajustá el nombre.
2. `No se puede eliminar (tiene miembros)`:
   * Reasigná los miembros a otro rol y volvé a intentar.
3. `Debés seleccionar al menos un permiso`:
   * Marcá permisos de lectura mínimos para el rol.
4. El colaborador “ve de menos”:
   * Revisá `Visibilidad de datos` y asignaciones de cajas/ubicaciones/PV.
5. La invitación no se puede aceptar:
   * Verificá que no esté vencida o cancelada; reenviá si hace falta.

## Atajos

1. Desde `Configuración > Colaboradores`, abrí la pestaña `Roles y permisos` para gestionar roles.
2. En la tabla de colaboradores, usá el buscador por nombre, email o rol.

## Guías relacionadas

1. [Colaboradores](/configuracion/colaboradores)
2. [Ubicaciones](/configuracion/ubicaciones)
3. [Puntos de venta](/configuracion/puntos-de-venta)