Cómo listar empleados
Consulta la pestaña Empleados de una ubicación para revisar el personal activo, su rol operativo, si tiene usuario asociado y sus datos básicos de contacto.
En este artículo
El listado de empleados es la vista de lectura del equipo de una ubicación. En el demo ES, Marea Gran Via muestra a Marta Ruiz, Lucia Navarro, Diego Serrano y Alba Castro como personal activo de referencia.
La tabla combina el listado de staff con los roles de personal para enseñar nombre, rol, usuario asociado, email y teléfono. La búsqueda, el filtro por rol y la página visible se aplican en la pantalla, no como filtros de servidor.
Antes de empezar
- Iniciar sesión con una organización y una ubicación seleccionadas; en el demo de documentación, usar Grupo Marea Demo y Marea Gran Via.
- Tener permiso de ubicación `staff:view` para consultar el listado de empleados.
- Tener permiso `staff-roles:view` si la captura debe mostrar nombres y colores de rol correctamente.
- Mantener desactivada la opción Mostrar empleados inactivos cuando se documente la vista base de staff.list.
Instrucciones
- 1.
Abre la pestaña Empleados
Entra en `location/staff?tab=staff` desde la gestión de personal de la ubicación. La pantalla debe quedar en Empleados cuando la sesión tiene acceso al listado de personal.
- 2.
Revisa la tabla base
Comprueba las filas activas de la ubicación. La vista base excluye empleados archivados y muestra Nombre, Rol de empleado, Usuario asociado, Email y Teléfono.
- 3.
Interpreta roles y usuario asociado
Usa el rol para reconocer la función operativa del empleado. Usuario asociado solo indica si existe un `user_id` vinculado; la tabla no muestra los datos completos de ese usuario.
- 4.
Usa búsqueda, rol y página como controles de pantalla
`staff_query`, `staff_role_id` y `staff_page` actúan sobre la lista ya cargada. `GET /api/app/{orgId}/{locationId}/staff` no recibe búsqueda, rol ni página como filtros de backend.
- 5.
Reconoce carga, error y vacío
Durante la carga aparece Cargando datos. Si falla una consulta necesaria aparece No pudimos cargar los datos. Si los filtros no dejan filas visibles aparece No hay empleados.
- 6.
Separa la vista base de los inactivos
staff.list documenta empleados activos. Solo al activar Mostrar empleados inactivos se envía `show_deleted=true`, se incluyen archivados y aparece la columna Estado.
Validaciones y límites
- La pantalla necesita organización y ubicación seleccionadas; si falta cualquiera, muestra ubicación no encontrada.
- `GET /api/app/{orgId}/{locationId}/staff` requiere `staff:view` y devuelve empleados de la ubicación de la ruta.
- La vista base no envía `show_deleted=true` y excluye empleados con `deleted_at`.
- `staff_query`, `staff_role_id` y `staff_page` se aplican en cliente; el endpoint devuelve un array, no una página de servidor.
- Los nombres y colores de rol dependen de `GET /api/app/{orgId}/{locationId}/staff-roles`; si no se resuelven, la fila queda como empleado sin rol.
- Usuario asociado es un indicador binario calculado con `staff.user_id`; no promete nombre, email ni permisos del usuario vinculado.
- Con `staff:manage` pueden aparecer Registrar, Editar, Desactivar y Recuperar, pero la lectura backend verificada sigue exigiendo `staff:view`.
Resultado esperado
El responsable puede comprobar el equipo activo de Marea Gran Via, leer roles y contacto básico, y distinguir una lista vacía por filtros de un problema de permisos o carga.