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

# Roles y empleados

> Guía simple para entender empleados, roles, permisos y restricciones de acceso.

# Roles y empleados

Los roles sirven para decidir **qué puede ver y hacer cada persona** dentro de FinSync.

Pensalo así:

* un **empleado** es una persona de tu equipo que entra al dashboard;
* un **rol** es el conjunto de accesos que le das a esa persona;
* un **permiso** es una acción concreta, como ver clientes, crear operaciones, aprobar cheques o administrar empleados.

La idea es que cada persona tenga acceso solo a lo que necesita para trabajar.

## Conceptos principales

| Concepto                | Qué significa                                                | Dónde se administra                |
| ----------------------- | ------------------------------------------------------------ | ---------------------------------- |
| **Empleado**            | Persona interna de tu empresa que ingresa con magic link.    | `Configuración > Empleados`        |
| **Rol**                 | Perfil de acceso que podés asignar a uno o varios empleados. | `Configuración > Roles`            |
| **Permiso**             | Acción que ese rol puede realizar.                           | Al crear o editar un rol           |
| **Alcance por cliente** | Restricción para que un rol vea solo ciertos clientes.       | Al configurar permisos de clientes |

## Roles del sistema

Cada empresa nace con dos roles predefinidos:

| Rol               | Uso recomendado                                                       | Acceso incluido                                                                                                                                         |
| ----------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Administrador** | Dueños, responsables financieros o personas que configuran la cuenta. | Puede usar casi todo lo que esté habilitado para la empresa: empleados, roles, configuración, clientes, operaciones, cheques, reportes e integraciones. |
| **Operador**      | Personas que cargan y gestionan operaciones del día a día.            | Puede trabajar con clientes, operaciones y cheques, pero no administra empleados, roles, configuración avanzada, claves API ni auditoría.               |

Si necesitás algo más específico, podés crear **roles personalizados**.

## Roles personalizados

Los roles personalizados son útiles cuando querés separar responsabilidades. Por ejemplo:

* **Contador:** puede ver métricas y exportar información, pero no cargar operaciones.
* **Mesa operativa:** puede crear operaciones y cheques, pero no cambiar la configuración.
* **Auditor:** puede revisar información y auditoría, pero no modificar datos.
* **Responsable de equipo:** puede gestionar empleados y roles, pero no necesariamente usar todos los módulos financieros.
* **Solicitante de compensaciones:** puede crear y ver sus propias solicitudes, pero no aprobar las de otros.

Cuando creás un empleado nuevo, FinSync selecciona un rol predeterminado. Por defecto suele ser **Operador**, salvo que lo cambies desde la configuración de roles.

## Qué restringen los permisos

Los permisos afectan tres cosas principales:

1. **Qué aparece en el menú.** Si una persona no tiene acceso a un módulo, normalmente no lo ve en la barra lateral.
2. **A qué pantallas puede entrar.** Aunque tenga el link, FinSync bloquea las páginas para las que no tiene permiso.
3. **Qué acciones puede hacer.** Por ejemplo: ver, crear, editar, aprobar, exportar o administrar.

### Acciones habituales

| Acción          | Qué permite                                                                         |
| --------------- | ----------------------------------------------------------------------------------- |
| **Ver**         | Entrar al módulo y consultar información.                                           |
| **Crear**       | Cargar nuevos registros, como clientes, operaciones, cheques o solicitudes.         |
| **Editar**      | Modificar información existente.                                                    |
| **Eliminar**    | Borrar registros cuando el módulo lo permite.                                       |
| **Aprobar**     | Confirmar, completar, cancelar o avanzar operaciones que requieren revisión.        |
| **Exportar**    | Descargar información o reportes.                                                   |
| **Administrar** | Cambiar configuraciones del módulo, como empleados, roles, límites o integraciones. |

Cuando elegís permisos en un rol, FinSync puede agregar permisos relacionados automáticamente. Por ejemplo, si alguien puede aprobar operaciones, también necesita poder verlas.

## Qué controla cada módulo

| Módulo o permiso                     | Qué restringe                                                                                                                           |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Dashboard**                        | Permite entrar a la pantalla principal.                                                                                                 |
| **Clientes**                         | Controla si la persona puede ver, crear, editar, eliminar o exportar clientes y cuentas asociadas.                                      |
| **Clientes con alcance restringido** | Permite que una persona vea solo algunos clientes. También limita operaciones, cheques y reportes relacionados con esos clientes.       |
| **Operaciones**                      | Controla si puede ver operaciones, crear nuevas, aprobar/completar/cancelar movimientos o exportar transacciones.                       |
| **Cheques**                          | Controla si puede ver, crear, liberar, aprobar, ajustar o exportar cheques. Solo aparece si el módulo Cheques está habilitado.          |
| **Métricas**                         | Controla si puede entrar a los reportes financieros. Las métricas pueden pedir además una contraseña especial.                          |
| **Omitir contraseña de métricas**    | Permite entrar a métricas sin pedir esa contraseña adicional. Usalo solo para personas de confianza.                                    |
| **Auditoría**                        | Permite consultar el historial de cambios y actividad.                                                                                  |
| **Configuración**                    | Permite entrar al área de configuración. Después, cada sub-sección tiene su propio permiso.                                             |
| **Monedas**                          | Permite administrar monedas y tipos de cambio.                                                                                          |
| **Bancos**                           | Permite administrar bancos usados en cheques.                                                                                           |
| **Etiquetas**                        | Permite crear y modificar etiquetas.                                                                                                    |
| **Tipos**                            | Permite administrar tipos de operaciones y transacciones.                                                                               |
| **Empleados y roles**                | Permite invitar empleados, cambiar roles, administrar roles y gestionar configuraciones avanzadas del equipo.                           |
| **Límites**                          | Permite configurar límites y excepciones. Solo aparece si el módulo Límites está habilitado.                                            |
| **Centros de costo**                 | Permite administrar centros de costo y presupuestos. Solo aparece si el módulo está habilitado.                                         |
| **Claves API**                       | Permite crear y administrar claves para que sistemas externos se conecten a FinSync.                                                    |
| **Intereses**                        | Permite configurar tasas y aplicar intereses. Solo aparece si el módulo Intereses está habilitado.                                      |
| **WhatsApp**                         | Permite configurar empleados autorizados, herramientas del bot y alias CBU/CVU. Solo aparece si el módulo WhatsApp está habilitado.     |
| **Compensaciones**                   | Controla quién puede ver compensaciones, crear solicitudes propias, aprobar solicitudes o administrar toda la configuración del módulo. |

## Alcance por cliente

El alcance por cliente sirve para limitar qué cartera puede ver un rol.

Hay dos formas:

| Modo                 | Qué pasa                                                     |
| -------------------- | ------------------------------------------------------------ |
| **Incluir clientes** | El empleado solo ve los clientes que selecciones.            |
| **Excluir clientes** | El empleado ve todos los clientes menos los que selecciones. |

Esta restricción no afecta solo la lista de clientes. También puede afectar:

* operaciones donde participan esos clientes;
* cheques relacionados;
* formularios donde se eligen clientes o cuentas;
* exportaciones y algunos reportes.

Los administradores y las claves API tienen alcance completo de la empresa.

## Controles que no dependen solo del rol

Aunque un rol tenga permisos, también pueden existir otras restricciones:

| Control                    | Qué significa                                                                                            |
| -------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Módulos habilitados**    | Si un módulo no está habilitado para tu empresa, no aparecerá aunque el rol tenga permisos relacionados. |
| **Plan**                   | Algunas funciones dependen del plan contratado.                                                          |
| **Contraseña de métricas** | Las métricas pueden pedir una contraseña adicional por seguridad.                                        |
| **Accesos externos**       | Los clientes externos no usan roles de empleados; solo ven su vista limitada.                            |
| **Claves API**             | Son accesos para sistemas externos. No funcionan como un empleado con rol propio.                        |

## Flujo recomendado

1. **Definí qué tareas hace cada persona.** Por ejemplo: operar, aprobar, revisar reportes o administrar la cuenta.
2. **Usá Administrador solo para pocas personas.**
3. **Creá roles personalizados** para equipos o responsabilidades específicas.
4. **Si hace falta, limitá clientes** con el alcance por cliente.
5. **Probá el rol** con un usuario antes de asignarlo a todo un equipo.
6. **Revisá roles periódicamente**, sobre todo cuando cambian responsabilidades o se habilitan módulos nuevos.

## Buenas prácticas

* Usá **Administrador** para pocas personas.
* No compartas usuarios: cada persona debería tener su propio empleado.
* Separá quién **carga** información de quién la **aprueba** cuando tu operación lo requiera.
* Usá alcance por cliente para equipos que trabajan con una cartera específica.
* Usá la contraseña de métricas para proteger reportes sensibles.
* Revisá claves API como un acceso de empresa: guardalas como secretos y desactivalas cuando una integración deje de usarse.
