> ## Documentation Index
> Fetch the complete documentation index at: https://muveya.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Equipo
> Consulta las personas de tu clínica dental, invita a nuevas y cambia su rol, sus permisos y su acceso a sedes, o suspéndelas, reactívalas y retíralas.
Las pantallas de **Equipo** son donde decides quién trabaja en tu clínica dental y a qué tiene acceso cada persona. El acceso de una persona tiene tres partes, y aquí defines cada una:
* un **rol** (**Propietario**, **Administrador** o **Miembro**), que es una plantilla con algunos permisos incluidos;
* **permisos**, las acciones y la información que la persona puede usar;
* **sedes y bodegas**, los lugares donde aplican esos permisos.
[Roles y permisos](/docs/es/account/roles-and-permissions) explica qué significa cada uno.
## Quién puede hacerlo
| Eres | Lo que puedes hacer en Equipo |
| - | - |
| **Propietario** | Todo lo que sigue, incluido invitar administradores, cambiar roles y transferir la propiedad. |
| **Administrador** | Consultar el equipo, invitar miembros, reenviar y revocar invitaciones, cambiar permisos y acceso a sedes, suspender, reactivar y retirar. No puedes invitar a un administrador, cambiar roles ni transferir la propiedad, y no puedes suspender, reactivar, retirar ni cambiar el acceso a sedes de un propietario. |
| **Miembro** con `members.manage` | Lo mismo que un administrador. |
| **Miembro** sin `members.manage` | Nada. **Equipo** no aparece en tu menú, y abrir `/members` muestra **No tienes acceso a la administración del equipo. Consulta con el administrador de tu clínica.** |
Propietarios y administradores siempre tienen `members.manage` por su rol. Además del rol, algunas acciones tienen límites propios, indicados en cada sección: nadie cambia su propio acceso a sedes, y solo puedes otorgar acceso a las sedes y bodegas a las que tú tienes acceso.
## Dónde
* **Equipo** en el menú principal, `console.muveya.com/members`: la lista de personas y **Invitaciones pendientes**.
* **Invitar persona**, `console.muveya.com/members/invite`.
* La página de una persona, `console.muveya.com/members/` seguido de su id, que se abre al seleccionar su nombre.
En **Inicio**, una clínica nueva muestra la tarjeta **Invita a tu equipo** (**Eres la única persona de esta cuenta de clínica.**) a quienes pueden invitar.
## Consulta el equipo
La pantalla **Equipo** (**Administra el equipo de tu clínica dental y su acceso.**) muestra una tabla con tres columnas:
| Columna | Qué muestra |
| - | - |
| **Persona** | El nombre de la persona (un enlace a su página) y, debajo, su correo. **Perfil no disponible** si el perfil no se puede leer. |
| **Rol** | **Propietario**, **Administrador** o **Miembro**. |
| **Estado** | **Activo** o **Suspendido**. **Cuenta deshabilitada** si la propia cuenta de muveya de la persona está deshabilitada. |
* Usa el filtro **Estado** para ver **Todos los estados**, **Activo** o **Suspendido**.
* La tabla muestra 50 personas por página. Usa **Página anterior** y **Página siguiente**; la página actual aparece como **Página** seguido de su número.
* Las personas retiradas no aparecen.
Estados vacíos y de error: **No hay miembros suspendidos**, **No hay miembros en esta página. Vuelve a la página anterior.**, **El equipo no está disponible. Vuelve a intentarlo.** (con **Volver a intentar**) y **Cargando el equipo…** mientras carga.
Esta pantalla no tiene buscador.
## Invita a una persona
**Quién puede hacerlo:** cualquier persona con `members.manage`. Solo un **Propietario** puede invitar a un **Administrador**.
En **Equipo**, selecciona **Invitar persona**. La pantalla dice **Invita por correo a una persona a unirse a esta clínica dental con el acceso que elijas.**
Escribe el **Correo electrónico**, elige el **Idioma del correo** (English, Español o Português; viene seleccionado el idioma de la consola) y el **Rol**: **Miembro**, o **Administrador** si eres propietario.
Marca los permisos que la persona recibe **además** de su rol. La ayuda dice **Selecciona los permisos que recibe esta persona además de los incluidos en su rol. Solo puedes otorgar accesos que tienes.** Los permisos se agrupan en **Catálogo**, **Inventario**, **Pedidos**, **Aprobaciones**, **Abastecimiento**, **Reportes y auditoría** y **Administración**.
En **Acceso a sedes** elige **Todas las sedes de esta cuenta** o **Sedes seleccionadas**; en **Acceso a bodegas** elige **Todas las bodegas de esta cuenta** o **Bodegas seleccionadas**. Con una opción "seleccionadas", marca al menos un lugar en la lista.
Selecciona **Crear invitación**. La pantalla muestra **Invitación creada para** el correo, con **Estamos enviando el correo. Esto no confirma que lo haya recibido; puedes reenviarla desde la página del equipo cuando el reenvío esté disponible.** Selecciona **Volver al equipo** o **Invitar a otra persona**.
En las listas de lugares, los inactivos aparecen marcados **(inactiva)**, y cada bodega se muestra con su sede, o con **Bodega central** si es una bodega central. Si todavía no hay lugares, la lista dice **Todavía no hay sedes para asignar.** o **Todavía no hay bodegas para asignar.** "Todas" también cubre las sedes y bodegas que se creen después.
Al marcar **Ajustar y contar stock**, la consola también marca y bloquea **Recibir entregas**, **Registrar consumo** y **Trasladar cajas entre bodegas**, con la nota **(Incluido en Ajustar y contar stock)**, porque ese permiso los incluye.
**Reglas y límites**
* **Correo:** una dirección válida, hasta 320 caracteres. Se guarda en minúsculas.
* **Rol:** **Miembro** o **Administrador**. Nadie puede ser invitado como **Propietario**; la propiedad se transfiere después.
* **Permisos:** cada permiso que marques debe ser uno que tú tengas (incluidos los que te da tu rol). El formulario muestra todos los permisos; el servidor rechaza el resto.
* **Lugares:** si tu propio acceso se limita a algunas sedes o bodegas, solo puedes ofrecer esas, y no puedes ofrecer "todas". Una invitación siempre otorga al menos una sede y una bodega, o todas; "ninguna sede" solo se puede definir después, en la página de la persona.
* **Una invitación por correo:** mientras haya una invitación pendiente para ese correo, no puedes crear otra. Reenvía o revoca la existente.
* **Vencimiento:** el enlace vale 24 horas.
**Qué registra el sistema:** una invitación pendiente con el rol, los permisos y los lugares que elegiste, los nombres de esos lugares (para que la persona invitada vea nombres y no ids), quién la envió y un registro de auditoría. El correo se envía en segundo plano, así que la confirmación nunca significa que se entregó. No se crea nada para la persona invitada hasta que acepta. Lo que ve la persona invitada se describe en [Iniciar sesión](/docs/es/account/sign-in), sección **Acepta una invitación**.
## Gestiona las invitaciones pendientes
Debajo de la lista de personas, **Invitaciones pendientes** muestra cada invitación que sigue en `pending`, de 50 en 50 (**Invitaciones anteriores** y **Más invitaciones** cambian de página).
| Columna | Qué muestra |
| - | - |
| **Correo electrónico** | La dirección invitada. |
| **Rol** | El rol ofrecido. |
| **Vence** | Fecha y hora en que el enlace actual deja de funcionar. |
| **Acciones** | **Reenviar invitación** y **Revocar invitación**. |
Cuando no hay ninguna, la sección dice **No hay invitaciones pendientes.**
### Reenvía una invitación
1. Selecciona **Reenviar invitación** en la fila.
2. El diálogo dice **Confirmar para** el correo, y **Enviaremos un nuevo correo con un enlace nuevo y el enlace anterior dejará de funcionar. El acceso ofrecido no cambia.**
3. Selecciona **Reenviar esta invitación**. La sección muestra **Se está enviando un nuevo correo a** seguido de la dirección, y **Esto no confirma que lo haya recibido.**
Un reenvío crea un enlace nuevo válido por 24 horas y anula el anterior. Puedes reenviar una invitación como máximo una vez por minuto; hasta entonces el botón está desactivado y la fila muestra **Podrás reenviarla desde** seguido de la hora. Para reenviar, debes poder emitir hoy esa misma invitación (su rol, sus permisos y sus lugares). La invitación conserva a quien la envió originalmente.
### Revoca una invitación
1. Selecciona **Revocar invitación** en la fila.
2. El diálogo dice **La invitación se cancela y el enlace del correo deja de funcionar. Para invitar de nuevo a esta persona, crea una nueva invitación.**
3. Selecciona **Revocar esta invitación**. La sección muestra **Se revocó la invitación a** la dirección.
Selecciona **Cancelar** o **Cerrar** para salir de cualquiera de los dos diálogos sin cambios.
### Ciclo de vida de una invitación
| Estado | Qué significa | Dónde lo ves |
| - | - | - |
| `pending` | Enviada y esperando a la persona invitada. | **Invitaciones pendientes**. |
| `accepting` | La persona invitada está terminando de aceptar en este momento. | No aparece en la lista. |
| `accepted` | La persona se unió. | La persona aparece en la lista del equipo. |
| `revoked` | La revocaste. El enlace ya no funciona. | Sale de la lista. |
| `expired` | No se usa por ahora: una invitación cuyo tiempo se acabó sigue en `pending` (consulta la nota de abajo). | No aparece en la lista. |
Una invitación cuya hora de **Vence** ya pasó sigue en **Invitaciones pendientes**: su enlace ya no funciona, pero la invitación sigue pendiente y todavía impide crear otra para el mismo correo. Reenvíala para mandar un enlace nuevo de 24 horas, o revócala.
Si la persona invitada ve **El administrador de la clínica debe revisar esta invitación**, quien la envió ya no tiene el rol, los permisos o los lugares que ofrece (por ejemplo, porque se suspendió su acceso). Un reenvío conserva a ese remitente, así que no lo soluciona: revoca la invitación y crea una nueva tú mismo.
La consola no muestra invitaciones aceptadas, revocadas ni vencidas.
## Abre la página de una persona
Selecciona un nombre en la lista. La página (**Revisa el rol, los permisos y el acceso operativo de esta persona.**) muestra **Correo electrónico**, **Rol** y **Estado**, y luego las secciones siguientes. **Volver al equipo** regresa a la lista.
* Si el estado de la persona es **Activo**, ves **Rol** (solo propietarios), **Permisos**, **Sedes y bodegas** y las acciones disponibles.
* Si el estado es **Suspendido**, ves **Esta membresía está suspendida. Sus permisos no se pueden editar.**, la lista de permisos que tiene, y **Reactivar acceso** y **Retirar de la clínica**.
* Si el perfil no se puede leer, la página muestra **Este perfil está incompleto. Actualiza el miembro antes de editar su acceso.** y ningún editor.
### Cambia el rol
**Quién puede hacerlo:** un **Propietario**, para una persona que no es propietaria. En otros casos la sección no aparece.
1. En **Rol**, elige **Administrador** o **Miembro**. La sección explica **Solo un propietario puede cambiar los roles. La propiedad se transfiere por separado.**
2. Selecciona **Guardar rol**. La sección muestra **Rol guardado**.
**Qué ocurre:** el nuevo rol aplica de inmediato. Los permisos que otorgaste además del rol se conservan (**El rol incluye los permisos señalados. Las asignaciones adicionales se conservan al cambiar el rol.**). La sesión de la persona se cierra en todos sus dispositivos y debe volver a iniciar sesión.
**Límites:** no puedes cambiar el rol de un propietario (transfiere la propiedad en su lugar). Para promover a alguien a **Administrador**, tu propio acceso a sedes y bodegas debe cubrir el suyo.
### Cambia los permisos
**Quién puede hacerlo:** cualquier persona con `members.manage`, para cualquier persona activa, incluso para ti.
1. En **Permisos** (**Elige a qué información y operaciones puede acceder esta persona.**), marca o desmarca permisos.
2. Selecciona **Guardar permisos**. La sección muestra **Permisos guardados**.
* Los permisos que vienen del rol aparecen marcados, bloqueados y con la nota **(Incluido en el rol)**.
* Los permisos incluidos en **Ajustar y contar stock** aparecen marcados, bloqueados y con la nota **(Incluido en Ajustar y contar stock)**.
* La consola guarda solo lo que marcaste. La lista guardada reemplaza por completo a la anterior.
**Qué ocurre:** el cambio aplica desde la siguiente acción de la persona. Su sesión no se cierra.
**Límites:** otorgar **Gestionar acceso del equipo** (`members.manage`) también le da autoridad sobre sus propios lugares, así que tu acceso a sedes y bodegas debe cubrir el suyo.
Así es también como un **Propietario** nuevo obtiene acceso operativo: abre tu propia página y marca, por ejemplo, **Ver inventario**, **Crear pedidos de insumos** o **Ver reportes**. Ningún rol los incluye.
### Cambia el acceso a sedes y bodegas
**Quién puede hacerlo:** cualquier persona con `members.manage`, para otra persona. Solo un propietario puede cambiar el acceso de un propietario.
1. En **Sedes y bodegas**, el texto dice **Para cada una, elige si esta persona accede a todas, a algunas o a ninguna. «Todas» incluye las que se creen después.**
2. En **Acceso a sedes** elige **Todas las sedes de esta cuenta**, **Sedes seleccionadas** o **Ninguna sede**. En **Acceso a bodegas** elige **Todas las bodegas de esta cuenta**, **Bodegas seleccionadas** o **Ninguna bodega**.
3. Con una opción "seleccionadas", marca los lugares.
4. Selecciona **Guardar acceso a ubicaciones**. La sección muestra **Acceso a ubicaciones guardado** y un resumen como **Sedes: todas · Bodegas:** seguido de los nombres de las bodegas.
Las notas bajo cada opción la explican:
* **Incluye las sedes que se creen después.** / **Incluye las bodegas que se creen después.**
* **No verá pedidos, aprobaciones ni custodia de ninguna sede.** (con **Ninguna sede**)
* **No verá ni moverá stock en ninguna bodega.** (con **Ninguna bodega**)
**Límites:**
* En tu propia página la sección está bloqueada y dice **No puedes cambiar tus propias ubicaciones y bodegas. Pídeselo a otra persona que administre el equipo.**
* Solo puedes otorgar lugares a los que tú tienes acceso, y "todas" solo si tú tienes "todas".
* **Seleccionadas** sin nada marcado se rechaza: **Elige al menos una sede, o selecciona «Ninguna sede» si esta persona no debe tener acceso.** (o la versión de bodegas). Elige **Ninguna sede** o **Ninguna bodega** de forma explícita.
* Un lugar que ya no existe aparece como **Ubicación no disponible** seguido de un número; desmárcalo para quitarlo.
* Hasta 500 sedes y 500 bodegas por persona.
**Qué ocurre:** el nuevo acceso aplica desde la siguiente acción de la persona. Consulta [Roles y permisos](/docs/es/account/roles-and-permissions) para saber qué limita.
### Suspende el acceso
**Quién puede hacerlo:** cualquier persona con `members.manage`. Solo un propietario puede suspender a un propietario.
1. En **Suspender acceso**, lee **Esta persona perderá el acceso a esta cuenta de clínica y se revocarán sus sesiones activas.**
2. Selecciona **Suspender acceso** y luego **Suspender a esta persona** en el diálogo.
**Qué ocurre:** la membresía pasa a **Suspendido** de inmediato. La sesión de la persona se cierra en todos sus dispositivos, y toda sesión, clave de API y vínculo de WhatsApp emitidos antes de la suspensión dejan de funcionar. La clínica conserva su historial. Se guarda un registro de auditoría.
### Reactiva el acceso
**Quién puede hacerlo:** cualquier persona con `members.manage`. Solo un propietario puede reactivar a un propietario. Tu acceso a sedes y bodegas debe cubrir el de la persona.
1. En la página de una persona suspendida, selecciona **Reactivar acceso**. El diálogo dice **Esta persona recupera el acceso con su rol, permisos y ubicaciones actuales. Las sesiones, claves de API y vínculos de WhatsApp anteriores a la suspensión siguen cerrados; deberá iniciar sesión de nuevo.**
2. Selecciona **Reactivar a esta persona**.
**Qué ocurre:** la membresía vuelve a **Activo** con el mismo rol, los mismos permisos y los mismos lugares. La persona vuelve a iniciar sesión. Se guarda un registro de auditoría.
### Retira a alguien de la clínica
**Quién puede hacerlo:** cualquier persona con `members.manage`, para una persona activa o suspendida distinta de ti. Solo un propietario puede retirar a un propietario.
1. Selecciona **Retirar de la clínica**. El diálogo dice **Esta persona perderá el acceso a la cuenta de la clínica y sus sesiones se cerrarán. Su historial se conserva en la clínica; para volver necesitará una nueva invitación.**
2. Selecciona **Retirar a esta persona**. Vuelves a la lista del equipo.
**Qué ocurre:** el acceso termina de inmediato, toda sesión, clave de API y vínculo de WhatsApp emitidos antes del retiro dejan de funcionar, la persona ya no aparece en la lista, y su nombre sigue en los registros en los que participó (pedidos, movimientos, aprobaciones). Para que vuelva, envíale una invitación nueva: al aceptarla, regresa con el acceso de esa invitación. Se guarda un registro de auditoría.
### Transfiere la propiedad
**Quién puede hacerlo:** un **Propietario**, a otra persona activa.
1. En la página de la otra persona, selecciona **Transferir propiedad**. El diálogo dice **La persona elegida será propietaria y tú serás administrador. Ambas cuentas deberán volver a iniciar sesión.**
2. Selecciona **Transferir propiedad** en el diálogo.
**Qué ocurre:** la persona pasa a **Propietario** y tú a **Administrador**, en un solo paso. Las sesiones de ambas personas se cierran en todos sus dispositivos. Tu acceso a sedes y bodegas debe cubrir el suyo.
## Protección del último propietario
Una clínica dental siempre conserva al menos un **Propietario** activo. Suspender o retirar al único propietario activo se rechaza con **La cuenta de clínica debe conservar un propietario activo. Transfiere la propiedad antes de quitar ese acceso.** Tampoco se puede cambiar el rol de un propietario desde la sección **Rol**: primero transfiere la propiedad.
## Qué puede salir mal
| Mensaje | Por qué | Qué hacer |
| - | - | - |
| **No tienes acceso a la administración del equipo. Consulta con el administrador de tu clínica.** | No tienes `members.manage`. | Pídelo a un propietario o administrador. |
| **Ingresa un correo electrónico válido.** | El correo de la invitación está mal escrito. | Corrígelo. |
| **Elige al menos una ubicación o selecciona acceso a todas.** | **Seleccionadas** sin nada marcado en el formulario de invitación. | Marca un lugar o elige "todas". |
| **Este correo ya tiene una invitación pendiente. Reenvíala desde la página del equipo.** | Existe una invitación pendiente para ese correo (aunque su hora haya pasado). | Reenvíala o revócala en **Invitaciones pendientes**. |
| **Algunos permisos o ubicaciones seleccionados no se pueden otorgar. Revisa la selección.** | Un permiso que no tienes, un lugar fuera de tu acceso, "todas" cuando solo tienes acceso a algunos lugares, ningún lugar elegido, o un lugar que no existe. | Desmarca lo que no puedes otorgar, o pídelo a un propietario. |
| **Solo un owner puede invitar a un administrador o cambiar este rol. Elige el rol de miembro o pídeselo a un owner.** | La acción requiere un propietario, o no tienes `members.manage`. | Pídelo a un propietario. |
| **Esta persona ya pertenece a esta clínica.** | La persona ya es miembro activo o suspendido. | Abre su página. |
| **Esta invitación cambió desde que abriste la lista. Revísala antes de intentarlo de nuevo.** | Alguien la reenvió o revocó mientras tanto. | Recarga la lista. |
| **Esta invitación ya no está pendiente.** | Se aceptó o se revocó. | Recarga la lista. |
| **La cuenta de clínica debe conservar un propietario activo. Transfiere la propiedad antes de quitar ese acceso.** | Protección del último propietario. | Transfiere la propiedad primero. |
| **Un permiso no está disponible. Actualiza este miembro antes de volver a intentarlo.** | No se reconoció el nombre de un permiso. | Recarga la página y guarda otra vez. |
| **No puedes cambiar tus propias ubicaciones y bodegas. Pídeselo a otra persona que administre el equipo.** | Intentaste cambiar tu propio acceso a sedes. | Pídelo a otra persona que administre el equipo. |
| **Solo puedes cambiar el acceso de personas que estén por completo dentro de tus ubicaciones y bodegas, y únicamente a esas. Pídeselo a alguien con acceso a todas las ubicaciones.** | La persona, o el acceso que elegiste, va más allá de tus propios lugares. | Pídelo a alguien con acceso a todos los lugares. |
| **Revisa los permisos y las ubicaciones seleccionadas.** | El formulario tiene un valor no válido. | Recarga e inténtalo de nuevo. |
| **La cuenta de clínica dental activa cambió. Recarga la página antes de volver a intentar.** | Cambiaste de clínica en otra pestaña. | Recarga la página. |
| **Tu cuenta no tiene permiso para esta acción.** | El servidor rechazó la acción para tu acceso. | Pídelo a un propietario. |
| **Este registro no está disponible en la cuenta de clínica dental activa.** | La persona no es miembro de esta clínica (o fue retirada). | Vuelve a la lista. |
| **No pudimos completar la solicitud. Intenta nuevamente.** | Un error temporal, o un reenvío antes de la espera de un minuto. | Espera un momento e inténtalo de nuevo. |
| **No pudimos confirmar la operación. Revisa tu conexión y la lista antes de volver a intentar.** | No había red al guardar. | Revisa la lista antes de repetir. |
## Lo que todavía no puedes hacer
* Buscar o exportar la lista del equipo.
* Editar el nombre o el correo de una persona (cada persona los tiene en su cuenta).
* Ver invitaciones aceptadas, revocadas o vencidas, o editar el acceso de una invitación pendiente (revócala y crea una nueva).
* Leer el historial de auditoría de los cambios del equipo: se registra, pero ninguna pantalla lo muestra.
## Páginas relacionadas
El catálogo completo de permisos y lo que habilita cada uno.
Lo que ve la persona invitada.
Crea las sedes que asignas a las personas.
Crea las bodegas que asignas a las personas.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.