Cómo seleccionar empleado en modo selector
Identifica qué empleado opera el TPV cuando el local usa el modo `selector`. El operador elige una tarjeta autorizada, como Marta Ruiz en Marea Gran Via, y el TPV queda listo para trabajar con ese empleado como contexto operativo.
En este artículo
El modo `selector` sirve para desbloquear el TPV con una lista controlada de empleados. No pide PIN ni tarjeta: solo muestra empleados no eliminados con una credencial TPV activa de tipo `selector`.
La selección no crea una sesión de autenticación nueva ni llama a `/tpv-auth`. Es una elección local de la pantalla que permite atribuir las operaciones posteriores del TPV, caja, tickets y servicio al empleado elegido.
Antes de empezar
- La sesión está iniciada en Grupo Marea Demo y la ubicación activa es Marea Gran Via.
- La cuenta puede abrir el TPV y la pantalla puede cargar empleados y credenciales TPV de la ubicación.
- Hay una `service_session` activa; sin servicio activo la pantalla no fuerza el selector de empleado.
- La configuración `tpv_settings.employee_access_mode` está en `selector`.
- El empleado que debe aparecer tiene una credencial TPV activa de tipo `selector`; en la captura ES se espera `TPV_AUTH_STAFF_NAME: "Marta Ruiz"`.
- Para capturar el modal, no abras el TPV con `demoGuide=1`, porque ese modo puede seleccionar automáticamente el primer empleado.
Instrucciones
- 1.
Abre el TPV de Marea Gran Via
Entra en el TPV de la ubicación en la pestaña de sala. Si hay servicio activo y todavía no hay empleado seleccionado, Antylogic muestra el modal `Selecciona el empleado` antes de permitir operar.
- 2.
Revisa los empleados disponibles
Comprueba que el modal muestra solo empleados no eliminados con credencial TPV activa de tipo `selector`. En el demo ES, la tarjeta esperada para este recorrido es Marta Ruiz.
- 3.
Selecciona la tarjeta del empleado
Pulsa la tarjeta del empleado que va a operar el servicio. No se introduce PIN, no se escanea card y no hay una confirmación adicional.
- 4.
Confirma que el TPV queda operativo
Después del toque, el modal se cierra y la cabecera muestra el empleado seleccionado. Desde ese momento, las acciones del TPV pueden usar ese empleado como atribución operativa.
- 5.
Cambia de operador cuando haga falta
Si cambia la persona que usa el TPV, abre de nuevo el selector desde el avatar o nombre de empleado de la cabecera y pulsa otra tarjeta autorizada.
Validaciones y límites
- Si no hay `service_session` activa, el selector no se fuerza.
- Si `employee_access_mode` es `pin`, `card` o `disabled`, esta guía no aplica al comportamiento visible.
- Los empleados eliminados o sin credencial `selector` activa no aparecen en el modal.
- Si no hay empleados seleccionables, el modal muestra `No hay credenciales de selector configuradas para acceder al TPV.`
- La selección por `selector` no llama a `/api/app/{orgId}/{locationId}/tpv-auth/{card|pin}` y no existe endpoint `/api/app/{orgId}/{locationId}/tpv-auth/selector`.
- La selección no actualiza `last_used_at` de la credencial y queda como estado local de la pantalla.
- Si el empleado seleccionado deja de estar permitido, la pantalla limpia la selección y vuelve a pedir empleado cuando corresponda.
Resultado esperado
El TPV queda desbloqueado con Marta Ruiz, u otro empleado autorizado, visible como operador seleccionado en la cabecera y disponible como contexto para las operaciones posteriores.