Gestionar credenciales TPV del personal
Consulta, crea y edita las credenciales que usa el personal para identificarse en el TPV de una ubicación, con soporte para selector manual, PIN y tarjeta.
En este artículo
Las credenciales TPV conectan el acceso operativo del equipo con empleados concretos de la ubicación. En Marea Gran Via, la guía sirve para revisar qué credenciales existen, crear una nueva para Marta Ruiz u otro empleado activo y mantener el estado sin borrar registros cuando solo hay que desactivar el acceso.
La acción vive en la configuración del TPV y trabaja siempre dentro del contexto de la ubicación seleccionada. El cliente no envía `location_id`: el backend lo toma de la sesión y valida que el empleado pertenece a esa misma ubicación.
Antes de empezar
- Tener sesión iniciada en Grupo Marea Demo con Marea Gran Via seleccionada.
- Disponer de `tpv:manage` para crear o editar credenciales; sin ese permiso la pantalla puede quedar en modo lectura.
- Tener personal activo en la ubicación, por ejemplo Marta Ruiz, Lucia Navarro, Diego Serrano o Alba Castro.
- Para PIN o tarjeta, preparar un código no vacío que no esté usado ya por otra credencial del mismo tipo en la ubicación.
Instrucciones
- 1.
Abre Credenciales de empleado
Entra en la configuración del TPV de Marea Gran Via y abre la pestaña Credenciales de empleado. La pantalla carga las credenciales TPV, el personal disponible y la configuración TPV de la ubicación.
- 2.
Revisa la tabla actual
Comprueba la credencial, el empleado asociado, el tipo y el estado. El listado se ordena por tipo y luego por la etiqueta visible o el código; una credencial inactiva sigue registrada, pero no se usa para identificar al personal.
- 3.
Inicia una nueva credencial
Pulsa Nueva credencial. El formulario puede abrir con tipo PIN, selector o tarjeta; si la ruta no fija el tipo, la app usa el modo de acceso configurado en el TPV cuando sea compatible y cae a PIN como alternativa.
- 4.
Completa empleado, tipo y código
Selecciona un empleado activo. Para selector no se introduce código visible: la credencial se vincula directamente al empleado. Para PIN, introduce 4 posiciones. Para tarjeta, escanea o escribe el código de la tarjeta. La etiqueta es opcional y Activa controla si puede usarse.
- 5.
Guarda y vuelve al listado
Pulsa Crear. Si no hay duplicados ni errores de validación, la app guarda la credencial, actualiza la lista y vuelve a la pantalla anterior para revisar el registro creado.
- 6.
Edita o desactiva una existente
Abre una credencial desde el listado para cambiar empleado, tipo, código, etiqueta o estado. Usa Guardar para aplicar cambios. Si solo quieres retirar el acceso temporalmente, desactiva Activa; el borrado definitivo pertenece a la guía separada de eliminación.
Validaciones y límites
- La credencial queda siempre acotada a la ubicación actual; el formulario no envía `location_id`.
- `staff_id` es obligatorio al crear y debe pertenecer a Marea Gran Via.
- `credential_type` debe ser `selector`, `pin` o `card`.
- Para PIN y tarjeta, `credential_code` es obligatorio al crear; en edición puede conservarse el valor existente si no se informa uno nuevo.
- Para selector, el backend ignora cualquier código manual y guarda el `staff_id` como `credential_code`.
- Para PIN, la longitud validada es 4; la UI usa entrada numérica y limita el campo a 4 caracteres.
- No se pueden duplicar credenciales por `location_id`, `credential_type` y `credential_code`, ni crear dos credenciales del mismo tipo para el mismo empleado.
- `is_active=false` desactiva el uso sin borrar el registro; la resolución de acceso TPV solo busca credenciales activas.
- Crear y editar requiere `tpv:manage`; listado y detalle en backend aceptan `tpv:manage`, `staff:manage` o `staff:view`.
Resultado esperado
La ubicación mantiene una lista actualizada de credenciales TPV del personal, con cada acceso asociado a un empleado activo y preparado para usarse, editarse o desactivarse sin perder trazabilidad.