> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://academy.zrupay.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Gestionar usuarios y roles

# ¿Qué puedes hacer desde Miembros del entorno?

En **Miembros del entorno** (**Configuración**) puedes:

- Ver los usuarios que tienen acceso al entorno en el que estás.
- Ver el rol asignado a cada usuario.
- Invitar a nuevos usuarios al entorno.
- Editar o eliminar usuarios existentes.

> 🧐 La gestión de **roles personalizados** (crear, editar, eliminar) se hace desde el menú de tu avatar ▶︎ **Empresa** ▶︎ **Miembros** ▶︎ **Gestionar roles**. Puedes leer más en [esta guía](https://academy.zrupay.com/es/article/miembros-de-la-empresa-y-gestion-de-roles-cp4ib/).

# Diferencia entre usuarios y roles

## Usuarios

Un usuario es una persona que tiene acceso a un entorno concreto. Al invitarle, le asignas un rol que determina a qué secciones puede acceder y qué acciones puede realizar.

## Roles

Un rol define los permisos de un usuario dentro del entorno. Puedes usar los roles predefinidos o crear roles personalizados adaptados a tus necesidades.

# Tipos de roles

## Roles predefinidos

Existen cinco roles predefinidos que no puedes modificar. Si necesitas uno similar pero con algún cambio, crea un rol personalizado partiendo de uno de ellos.

### Administrador

Tiene todos los permisos del entorno menos gestionar usuarios y roles.

### Comercial

Puede ver la sección de enlaces de pago. Es el rol ideal para alguien que solo necesite crear y enviar enlaces de pago.

### Desarrollador

Tiene acceso a las credenciales de API, a la sección **Desarrolladores** y a las secciones de **Configuración** relacionadas con la integración.

### Financiero

Tiene acceso a todo lo necesario para la gestión diaria del entorno.

### Lectura

Acceso de solo lectura a todo el panel: puede ver toda la información sin crear, editar ni eliminar nada.

> 🧐 **Propietario** tiene todos los permisos del entorno, pero no aparece entre los roles que puedes asignar desde **Miembros del entorno**. Se asigna automáticamente a quien crea el entorno, y puedes asignarlo al invitar a alguien desde el menú de tu avatar ▶︎ **Empresa** ▶︎ **Miembros**.

## Roles personalizados

Puedes crear roles completamente personalizados con los permisos que necesites. Para hacerlo, ve al menú de tu avatar ▶︎ **Empresa** ▶︎ **Miembros** ▶︎ **Gestionar roles**. Puedes leer más en [esta guía](https://academy.zrupay.com/es/article/miembros-de-la-empresa-y-gestion-de-roles-cp4ib/).

# Ver los permisos de un rol

Al asignar un rol, cada uno tiene un botón **"Ver permisos"** que abre el modal **Detalles del rol**. Ahí ves, agrupados y con un contador de cuántos están activos, todos los permisos de ese rol:

- **Empresa**
- **Entorno**
- **Actividad**
- **Marketplace**
- **Solicitudes**
- **Estadísticas**
- **Desarrolladores**
- **Configuración**

Al desplegar un grupo ves los permisos concretos. Por ejemplo, dentro de **Entorno** encontrarás **Conexiones**, **Orquestaciones** y **Checkouts**, cada uno con sus acciones: Ver, Crear, Editar, Detalle y, en Conexiones y Orquestaciones, también **Exportar**.

> 🧐 El permiso **Exportar** es el que controla quién puede usar el botón **Exportar CSV** de los listados de Conexiones y Orquestaciones. Checkouts no tiene exportación, así que tampoco tiene ese permiso.

> ✋ Los roles predefinidos no permiten editar permisos. Para eso tienes que crear un rol y asignarle los permisos personalizados.

# Gestionar los miembros

## Invitar a un usuario

- Ve a **Configuración** ▶︎ **Miembros del entorno**.
- Haz clic en **"Invitar usuario"**, arriba a la derecha.
- Se abrirá un wizard de 2 pasos a pantalla completa:
    - **Paso 1 — Usuario**: introduce el **correo electrónico** (obligatorio), y opcionalmente el **nombre** y los **apellidos**.
    - **Paso 2 — Rol**: selecciona el rol que quieres asignarle. Puede ser uno de los cinco roles predefinidos o uno personalizado que ya hayas creado.
- Confirma la invitación.

## Filtrar el listado de miembros

Desde la cabecera puedes filtrar por:

- **Todos los tipos**: filtra por rol (Administrador, Comercial, Desarrollador, Financiero, Lectura, Propietario o roles personalizados).
- **Todos los estados**: Activo o Invitado.

## Editar un usuario

- Ve a **Configuración** ▶︎ **Miembros del entorno**.
- Haz clic en el **icono de lápiz** a la derecha del usuario que quieras editar.
- Se abre el mismo wizard de la invitación, en el paso **Rol**.
- Cambia el rol y haz clic en **"Editar usuario"**.

## Eliminar un usuario

- Ve a **Configuración** ▶︎ **Miembros del entorno**.
- Haz clic en el **icono de papelera** a la derecha del usuario que quieras eliminar.
- Confirma la acción.

> ✋ Los usuarios con rol **Propietario** no muestran los iconos de editar ni de eliminar: su rol no se cambia desde aquí.