Roles y permisos

Qué puede hacer el propietario, qué puede hacer un agente y el catálogo completo de permisos.

En Prestafolio hay dos roles, y solo dos:

Propietario. Tú, el dueño del negocio. Puede todo, sin excepción, y es el único que gestiona agentes y la facturación.
Agente (cobrador). No tiene un paquete fijo de permisos: tiene los que tú le concedas, uno por uno. Dos cobradores del mismo negocio pueden tener permisos completamente distintos.

Cómo conceder o quitar permisos

Al invitar a un cobrador marcas sus permisos iniciales. Después, en Agentes → menú de la fila → Editar permisos, puedes cambiarlos cuando quieras.

Importante: editar permisos reemplaza el conjunto completo, no suma. Lo que dejes marcado es exactamente lo que tendrá. Si desmarcas todo, se queda sin permisos (podrá entrar, pero no hacer nada). Y el cambio es inmediato: si el agente está trabajando en ese momento, su sesión se refresca para aplicar los permisos nuevos.

Dos reglas que el sistema aplica siempre, marques lo que marques en la pantalla:

Un agente nunca puede gestionar agentes. Los permisos de agentes no se pueden delegar a nadie: es la protección contra que un cobrador se auto-suba de privilegios o invite a gente por su cuenta.
No puedes conceder permisos de un módulo que tu plan no incluye. Si intentas, verás Algunos de esos permisos no están disponibles en tu plan.

Lo que un agente ve sin ningún permiso

Aunque no le concedas nada, un agente que ya aceptó puede:

Entrar a la app y ver su propio panel: lo que él cobró hoy y este mes, su cartera asignada, sus servicios y su turno de caja. Son sus cifras, nunca las del negocio completo. Ver Desempeño de cobradores.
Consultar la lista y el detalle de clientes y préstamos (leerlos no requiere permiso; lo que se controla es crear, editar y eliminar).

Todo lo demás hay que concederlo.

Catálogo completo de permisos

Estos son los permisos reales del sistema, agrupados por módulo. La columna Permiso es el identificador técnico que verás en la app y en los mensajes de error.

Clientes

Permiso	Qué permite
`clients:create`	Crear clientes.
`clients:update`	Editar clientes (incluye subir y borrar sus archivos).
`clients:delete`	Eliminar clientes.
`clients:stats`	Ver estadísticas de clientes.

Préstamos

Permiso	Qué permite
`loans:create`	Crear préstamos (y renovarlos).
`loans:update`	Editar préstamos, archivarlos y marcarlos incobrables.
`loans:delete`	Eliminar préstamos.
`loans:updateArrears`	Modificar la mora del préstamo.

Pagos

Permiso	Qué permite
`payments:create`	Registrar un abono.
`payments:createMultiple`	Registrar abonos en lote.
`payments:updateInterest`	Modificar el interés de un pago.
`payments:updateArrears`	Modificar la mora de un pago.
`payments:makeUncollectible`	Marcar un pago como incobrable.

Atrasos (mora)

Permiso	Qué permite
`delays:create`	Registrar el cobro de un atraso.
`delays:createMultiple`	Registrar atrasos en lote.
`delays:updateInterest`	Modificar el interés de mora.
`delays:updateArrears`	Modificar días o tasa de mora.
`delays:makeUncollectible`	Marcar un atraso como incobrable.

Servicios recurrentes

Permiso	Qué permite
`services:read`	Ver servicios y sus cargos.
`services:write`	Crear y editar contratos de servicio.
`services:collect`	Registrar el cobro de un cargo.
`services:cancel`	Pausar, reactivar o cancelar un servicio.
`services:override-mora`	Condonar la mora de un cargo al cobrarlo.
`services:partial-payment`	Aceptar un pago parcial (incompleto) de un cargo.

Los dos últimos son permisos de excepción: dejan que el cobrador cobre menos de lo debido. Concédelos solo a quien de verdad confíes esa decisión.

Caja

Permiso	Qué permite
`cash:read`	Ver la caja.
`cash:stats`	Ver las estadísticas de caja del negocio completo (prestado/cobrado), no solo del turno.
`cash:open`	Abrir el turno de caja.
`cash:close`	Cerrar el turno (arqueo).

Contabilidad

Permiso	Qué permite
`accounting:read`	Ver el resumen contable (el libro mayor).
`accounting:write`	Crear, postear y reversar asientos manuales.
`accounting:close-period`	Cerrar un periodo fiscal.
`accounting:provision`	Fijar el objetivo de provisión para incobrables.
`accounting:coa.manage`	Crear, editar y desactivar cuentas del plan de cuentas (Premium).

Reportes, documentos y otros

Permiso	Qué permite
`reports:read`	Ver los reportes de negocio (Gold y Premium).
`legal:create`	Crear personas legales y documentos (pagaré).
`legal:update`	Editar personas legales y documentos.
`legal:delete`	Eliminar personas legales.
`calculator:read`	Acceder a la calculadora.
`request:read`	Ver solicitudes de préstamo (Gold y Premium).

Nunca delegables

Permiso	Por qué no aparece en el selector
`agents:create`, `agents:update`, `agents:delete`	Gestionar cobradores es exclusivo del propietario. Ningún agente puede recibirlos.
`billing:manage`	La suscripción y el pago de Prestafolio los gestiona solo el propietario.

El plan también manda

Aunque un permiso exista en el catálogo, solo puedes concederlo si tu plan incluye ese módulo. Por ejemplo, reports:read y request:read requieren Gold o Premium; el módulo de agentes en sí ya lo requiere. Los permisos que tu plan no habilita simplemente no aparecen en el selector. Ver Planes y facturación.

Errores frecuentes

Mensaje	Qué pasó
Algunos de esos permisos no están disponibles en tu plan	Se intentó conceder un permiso de un módulo que tu plan no incluye. No se aplica ninguno del lote: corrige y reintenta.
No tienes permiso para realizar esta acción	El agente intentó algo que no le concediste. Si debería poder hacerlo, márcaselo en Editar permisos.
Solo el propietario	Un agente intentó abrir la sección de Agentes. No es concedible: es del propietario y punto.