# Equipo y roles

El Dashboard de Fluxis permite a los Owners y Admins de la organización gestionar colaboradores — miembros del equipo que pueden acceder al dashboard, configurar integraciones y gestionar credenciales API.

## Acceso al dashboard

Gestiona tu equipo en:

**`/app/team`**

Solo los colaboradores con roles **Owner** o **Admin** pueden acceder a esta sección.

## Roles de colaborador

| Rol | Acceso al dashboard |
| ---- | ---------------- |
| **Owner** | Acceso completo; puede modificar roles de otros Owners |
| **Admin** | Gestionar miembros del equipo, claves API, cuentas y la mayoría de configuraciones |
| **Operator** | Tareas operativas (alcance definido por permisos del dashboard) |
| **Guest** | Acceso limitado orientado a lectura |

Los roles se asignan como un array — un colaborador puede tener varios roles, aunque las asignaciones típicas usan un rol principal único.

## Acciones de gestión de equipo

| Acción | Quién puede realizarla | Descripción |
| ------ | --------------- | ----------- |
| List members | Owner, Admin | Lista paginada (`page`, `page_size`) |
| Invite / create | Owner, Admin | Agregar colaborador con nombre, email y roles |
| Update profile | Owner, Admin | Cambiar nombre, teléfono, país |
| Update roles | Owner, Admin | Cambiar asignación de roles de un colaborador (`PUT /team/roles/:id`) |
| Remove member | Owner, Admin | Eliminar un colaborador (los Owners no pueden eliminarse) |

::::warning
**Los Owners no pueden eliminarse.** Los intentos de eliminar un colaborador con rol Owner son rechazados.
::::

::::note
Las actualizaciones de perfil (`PUT /team/:id`) aplican solo a colaboradores que actualmente tienen roles **Admin** u **Owner**. Los Operators y Guests no pueden actualizarse mediante este endpoint.
::::

## Crear un miembro del equipo

Proporciona:

| Campo | Requerido | Descripción |
| ----- | -------- | ----------- |
| `first_name` | Sí | Nombre |
| `last_name` | Sí | Apellido |
| `email` | Sí | Email de inicio de sesión (debe ser único) |
| `roles` | Sí | Array de cadenas de rol (`owner`, `admin`, `operator`, `guest`) |
| `phone` | No | Teléfono de contacto |
| `country` | No | Código de país |

Los nuevos colaboradores reciben credenciales mediante el flujo de incorporación del dashboard (establecer contraseña en el primer inicio de sesión).

## Jerarquía de roles

```mermaid
flowchart TD
    O[Owner] --> A[Admin]
    A --> Op[Operator]
    Op --> G[Guest]
```

- **Owner** — máximo privilegio; no puede eliminarse vía la API de equipo
- **Admin** — gestión diaria incluyendo claves API en `/app/api-keys`
- **Operator / Guest** — alcance reducido para necesidades operativas específicas

::::note
Los nombres de rol del dashboard (`owner`, `admin`, …) son distintos de los **roles de credencial API** (`read`, `write`) en las claves API. El rol del dashboard de un colaborador controla el acceso a la UI; los roles de clave API controlan permisos de la REST API.
::::

## Gestión de claves API por rol

| Rol del dashboard | Acceso a `/app/api-keys` |
| -------------- | ---------------------- |
| Owner | CRUD completo |
| Admin | CRUD completo |
| Operator | Sin acceso |
| Guest | Sin acceso |

Crear claves API requiere verificación 2FA — consulta [Autenticación de dos factores](/es/docs/developers/two-factor-auth).

## Mejores prácticas

1. **Minimiza Owners** — mantén el conteo de Owners pequeño; usa Admin para la mayoría del equipo
2. **Usa acceso acorde al rol** — Operators y Guests no deben gestionar credenciales
3. **Elimina miembros que se van con prontitud** — elimina colaboradores cuando dejen tu organización
4. **Separa claves API por servicio** — crea claves distintas por integración en lugar de compartir una clave entre equipos

## Alcance organización vs cuenta

Los colaboradores pertenecen a una **organización**. Las claves API a nivel de organización pueden acceder a todas las cuentas bajo esa organización (sujeto a permisos de rol API). Los recursos específicos de cuenta (webhooks, direcciones de liquidación por cuenta) se gestionan en contexto de cuenta dentro del dashboard.

## Documentación relacionada

- [Credenciales API](/es/docs/developers/api-credentials) — claves REST API (solo Owner/Admin)
- [Autenticación de dos factores](/es/docs/developers/two-factor-auth) — requerida para acciones sensibles
- [Registro](/es/docs/merchant-integration/sign-up) — cómo se provisionan las organizaciones