Autenticar con tarjeta
Valida una tarjeta TPV activa para identificar al empleado que opera el TPV de la ubicación. En Marea Gran Via, el flujo selecciona a Marta Ruiz si la credencial está activa y permitida en el terminal actual.
En este artículo
Este flujo identifica al operador antes de usar el TPV. El operador escanea o introduce el código de tarjeta en el modal de empleado; Antylogic valida la credencial y selecciona el Staff asociado.
La autenticación por tarjeta no crea credenciales, no abre servicio, caja ni ticket. Solo fija el empleado seleccionado en el TPV, y el workspace sigue dependiendo de que exista una service_session activa.
Antes de empezar
- Sesión iniciada en Grupo Marea Demo con Marea Gran Via seleccionada.
- Permiso de ubicación tpv:use para abrir la pantalla operativa del TPV.
- Terminal TPV actual resuelto, con terminalId disponible cuando exista restricción por terminal.
- Modo de acceso de empleado configurado como card en los ajustes TPV o en las capacidades del terminal actual.
- Credencial TPV activa de tipo card para el empleado operador.
- Sesión de servicio activa si el operador necesita continuar al workspace TPV después de autenticarse.
Instrucciones
- 1.
Abrir el TPV del terminal
Entra en el TPV de Marea Gran Via desde el terminal operativo actual. El flujo de tarjeta solo debe mostrarse cuando el modo de acceso de empleado resuelto para ese terminal es card.
- 2.
Escanear o introducir la tarjeta
En el modal Selecciona el empleado, escanea la tarjeta física o escribe el código. Antylogic recorta espacios al inicio y al final antes de validar, y no lanza la operación si el campo queda vacío.
- 3.
Validar el empleado
Pulsa Validar card. Antylogic busca credenciales activas de tipo card en la ubicación actual; si el TPV envía terminal_id, acepta solo tarjetas sin restricción de terminales o autorizadas para ese terminal.
- 4.
Continuar como operador seleccionado
Cuando la tarjeta coincide, Antylogic selecciona el Staff devuelto, limpia el campo de tarjeta y cierra el modal. El workspace TPV queda disponible para ese empleado si también hay una sesión de servicio activa.
Validaciones y límites
- La pantalla operativa se bloquea si falta tpv:use, aunque el endpoint backend también acepte tpv:card-auth o tpv:manage.
- Un código vacío no dispara la autenticación.
- Un código incorrecto, una credencial inactiva o una tarjeta restringida a otro terminal se trata como no encontrada y muestra el error de validación de tarjeta.
- Las tarjetas y PIN se guardan como secretos: credential_code no se serializa en la respuesta de credenciales TPV.
- No documentar la pulsación sobre una tarjeta listada como método fiable; el flujo probado es escanear o introducir el código.
- Sin terminal_id en el payload no se aplica la restricción por allowed_terminal_ids; la UI actual intenta enviarlo cuando tiene terminal seleccionado.
- No hay evidencia de límite de intentos, bloqueo temporal ni auditoría específica para tarjetas incorrectas en los archivos analizados.
Resultado esperado
Marta Ruiz queda seleccionada como operadora del TPV en Marea Gran Via. La operación puede continuar en el workspace si hay una service_session activa.