Roles y permisos

Para qué sirve

Un rol es un conjunto de permisos. Cada usuario tiene un rol, y el rol decide qué pantallas ve y qué acciones puede hacer: abrir un turno, anular una venta, cambiar precios, ver faltantes… Tu empresa nace con 9 roles base pensados para un grifo peruano; puedes ajustar sus permisos o crear roles propios.

Dónde está

Menú:Configuración›Roles y permisos/roles

Quién puede

Acción	Permiso
Ver los roles y sus permisos	Permisoroles.ver
Crear, editar, cambiar permisos y eliminar roles	Permisoroles.gestionar

De fábrica solo el Administrador gestiona roles. Solo lectura puede verlos.

Conceptos

Permiso

Cada permiso es una acción concreta con una clave del tipo modulo.accion, por ejemplo Permisoturnos.cerrar. El listado completo, agrupado por módulo y explicado uno por uno, está en el Catálogo de permisos.

Permiso efectivo = rol + plan

Un permiso solo funciona si además el plan de tu empresa incluye su módulo. Si marcas un permiso de un módulo que tu plan no trae, el editor lo muestra atenuado con la etiqueta «No incluido en tu plan»: queda asignado (por si mejoras el plan), pero no tiene efecto.

Roles del sistema y personalizados

• Del sistema (insignia Sistema con candado): los 9 roles base. Puedes cambiar sus permisos y su nombre, pero no eliminarlos.
• Personalizados: los que creas tú. Se pueden eliminar si no tienen usuarios.

Los cambios se aplican al instante

Al guardar los permisos de un rol, todos los usuarios con ese rol reciben los permisos nuevos en su siguiente acción, sin cerrar sesión.

La pantalla

• Cabecera con contadores: Roles, Usuarios asignados, Roles del sistema y Personalizados.
• Buscador Buscar rol… y filtros Todos, Del sistema y Personalizados.
• Una tarjeta por rol con: nombre, descripción, número de permisos y de usuarios, una barra de Alcance (porcentaje del catálogo de permisos que tiene el rol) y los botones Gestionar permisos, editar (lápiz) y eliminar (papelera, solo en personalizados).

Paso a paso

Crear un rol propio

1. Pulsa «Nuevo rol»
   Se abre Nuevo rol.
2. Escribe nombre y descripción
   Nombre (obligatorio, único) y Descripción.
3. Crea
   Pulsa Crear rol. Verás «Rol creado.». El rol nace sin permisos.
4. Asigna sus permisos
   En su tarjeta pulsa Gestionar permisos (ver abajo).

Editar los permisos de un rol

1. Pulsa «Gestionar permisos»
   Se abre Permisos · nombre del rol.
2. Ubica el módulo
   Los permisos están agrupados como en el menú (Dashboard, Configuración, Operación, Comprobantes, Finanzas, Catálogo, Reportes y Otros). Cada módulo es un desplegable con un contador «marcados/total».
3. Marca o desmarca
   Abre el módulo y marca cada permiso, o usa Marcar todos. Los permisos con la insignia roja Sensible merecen especial cuidado.
4. Guarda
   Pulsa Guardar permisos. Verás «Permisos actualizados.».

Editar nombre o descripción

Botón del lápiz → Editar rol → Guardar cambios («Rol actualizado.»).

Eliminar un rol personalizado

Botón de la papelera → Confirmar eliminación → Eliminar («Rol eliminado.»). Si el rol tiene usuarios (incluso usuarios eliminados), el sistema no lo deja borrar: primero reasígnalos con Asignar rol en Usuarios.

:::danger No te quites el acceso a ti mismo Los permisos del rol Administrador también son editables. Si le quitas roles.gestionar o usuarios.editar, podrías quedarte sin forma de devolverlos. Antes de recortar el rol Administrador, crea un rol propio para probar. :::

Los 9 roles base

Se crean al dar de alta la empresa. Después, tu empresa es dueña de sus roles: los cambios que hagas no se pierden.

Rol	Para quién	Qué trae
Administrador	Dueño o gerente	Todos los permisos del catálogo. Es el rol del usuario administrador inicial.
Administrador de Estación	Administrador de una estación	Todos los permisos de dashboard, multi-estación, terminales, clientes, personal, proveedores, documentos, productos, tanques, playa, precios, turnos, POS, ventas, compras, inventario, regulatorio, caja, tesorería, market, GNV, guías y reportes; además ver estaciones, medios de pago, cuentas bancarias, notas de despacho, créditos, cobranzas y usuarios; ver, descargar, reenviar, corregir y exportar comprobantes y emitir notas; notificaciones y bitácora de envíos; ver y editar ajustes; ver y canjear fidelización. Sin: credenciales de facturación, gestionar roles, eliminar usuarios, crear o eliminar estaciones, acceso a todas las estaciones, asistente ni aceptar SIRE.
Jefe de Playa	Supervisor de turno	Dashboard; ver playa, precios y tanques; varillar; turnos (ver, abrir, asignar, lecturas, corregir lectura, despachos no comerciales y su aprobación, cerrar y aprobar cierre); ver faltantes; POS (acceder, vender, offline, consumo interno, contingencia); ventas (ver, reimprimir, anular, enviar, canjear, resolver conflictos offline); clientes (ver, crear, editar); ver medios de pago y cuentas; ver inventario y regulatorio, marcar reportado; ver caja; reportes de playa y ventas; notificaciones; fidelización (ver, canjear); autorizar excepciones de crédito.
Playero	Personal de isla	POS (acceder, vender, offline, al crédito); entregar efectivo; vender market; ver, reimprimir y enviar ventas; ver y crear clientes; ver turnos y declarar su dinero; ver playa, precios, medios de pago y cuentas; fidelización (ver, canjear).
Cajero	Caja y tesorería	Caja operativa propia (recibir entregas y traspasos, registrar egresos, depositar, cerrarla con arqueo); ver Tesorería y cajas y revertir movimientos; ver cajas recaudadoras; confirmar entregas (Por confirmar); entregar efectivo; además trae los permisos heredados de la antigua caja de estación (caja.abrir_estacion, caja.cerrar, caja.registrar_movimiento), que hoy no habilitan pantallas nuevas; ver GNV y rendir su recaudo; tesorería (ver, depositar, conciliar); ver turnos y ventas; canjear boletas por factura; ver medios de pago y cuentas; reportes de tesorería; notificaciones; cuentas por pagar (ver, pagar); cobranzas (ver, registrar).
Créditos y Cobranzas	Área de créditos	Todo de clientes, créditos, notas de despacho y cobranzas (excepto vender al crédito en el POS); ver precios, ventas y comprobantes, descargar comprobantes; ver medios de pago y cuentas; reportes de crédito; ver caja; notificaciones.
Almacén	Almacén y compras	Todo de productos, proveedores, tanques, compras, market y guías de remisión; ver y ajustar inventario; ver regulatorio; ver y subir documentos; reportes de inventario y compras.
Vendedor de Market	Tienda	POS (acceder, vender, offline); vender y ver market; ver productos; ver y crear clientes; ver, reimprimir ventas; ver turnos y declarar; ver medios de pago; fidelización (ver, canjear).
Solo lectura	Contador o auditor	Todos los permisos de ver del catálogo, todos los reportes, y además descargar y exportar comprobantes, exportar inventario y regulatorio, y el reporte de percepciones. Ninguna acción que modifique datos.

:::info Permisos nuevos en actualizaciones Cuando el sistema incorpora permisos nuevos, el proveedor puede sincronizarlos con los roles base. Tus roles propios no se tocan. :::

:::note Cajero y la pantalla GNV El rol base Cajero trae Ver GNV (Permisognv.ver) para poder llegar a la pantalla donde rinde el recaudo de GNV. En empresas creadas antes de este cambio, añádelo a mano: en Roles y permisos, pulsa Gestionar permisos del rol Cajero, marca Ver GNV y pulsa Guardar permisos. :::

Permisos sensibles

Estos permisos aparecen con la insignia Sensible en el editor porque habilitan operaciones críticas que quedan auditadas como eventos críticos. Asígnalos solo a personas de confianza:

Permiso	Por qué es sensible
Permisoplaya.cambiar_tanque_producto	Cambia de qué tanque o producto despacha una manguera; afecta inventario y precios.
Permisoventas.canjear	Canjea boletas por factura (emite factura y nota de crédito).
Permisocomprobantes.emitir_nota	Emite notas de crédito o débito ante SUNAT.
Permisopos.registrar_contingencia	Registra ventas hechas durante una caída del sistema, con fecha pasada.
Permisopos.vender_offline	Vende sin conexión, sin validación en línea.
Permisoventas.resolver_conflicto_offline	Decide qué hacer con ventas offline que chocaron al sincronizar.
Permisoterminales.configurar_offline	Habilita el modo offline de un terminal.
Permisoventas.registrar_panel	Digita ventas desde el panel sin tablet, a nombre del responsable de la manguera.
Permisocaja.operativa	Tiene caja operativa propia: recibe liquidaciones y traspasos, paga y deposita.
Permisocaja.ver_recaudadoras	Supervisa las cajas recaudadoras, incluido cerrar la caja del día en nombre del vendedor.

Además, hay permisos que por su naturaleza conviene restringir: empresa.editar_facturacion (credenciales de Nubefact), usuarios.establecer_password, usuarios.gestionar_pin, roles.gestionar, estaciones.acceso_total, ajustes.editar, turnos.liquidar, turnos.reabrir, faltantes.condonar, ventas.anular y precios.cambiar.

Segregación de funciones

Aunque un rol tenga todos los permisos, el sistema aplica reglas antifraude sobre los hechos: por ejemplo, quien fue playero de un turno no puede aprobar su cierre aunque su rol tenga turnos.liquidar. Ver Seguridad y antifraude.

Mensajes de error frecuentes

Mensaje	Por qué pasa	Qué hacer
«El nombre del rol es obligatorio.»	Nombre vacío.	Escríbelo.
«Ya existe un rol con ese nombre.»	Nombre repetido.	Usa otro.
«Es un rol del sistema y no se puede eliminar.»	Intentaste borrar un rol base.	Puedes recortar sus permisos, pero no borrarlo.
«El rol tiene usuarios (incluidos eliminados); reasígnalos antes de eliminarlo.»	Hay usuarios con ese rol.	Cambia el rol de esos usuarios primero.
«No tienes permiso para esta acción.»	A tu rol le falta el permiso de la acción.	Pide a un administrador que lo agregue.

Relación con otros módulos

• Catálogo de permisos · Usuarios · Planes y límites · Seguridad y acceso.