Cómo eliminar una credencial TPV
Retira definitivamente una credencial TPV de empleado de la ubicación seleccionada para que deje de aparecer en la configuración y ya no pueda usarse como acceso operativo por PIN, tarjeta o selector.
En este artículo
Usa esta guía cuando una credencial de empleado ya no deba dar acceso al TPV en Marea Gran Via. La acción se realiza desde Ajustes TPV, dentro de la pestaña Credenciales de empleado.
El borrado es definitivo y se aplica a una credencial concreta. La ficha del empleado asociado se conserva; solo desaparece la fila de credencial que el TPV usa para resolver el acceso.
Antes de empezar
- Tener seleccionadas la organización y la ubicación, por ejemplo Grupo Marea Demo y Marea Gran Via.
- Contar con permiso `tpv:manage` en la ubicación.
- Tener al menos una credencial TPV visible en Ajustes TPV > Credenciales de empleado.
- Usar una credencial temporal si se va a grabar o documentar el flujo, porque la confirmación elimina la fila físicamente.
Instrucciones
- 1.
Abre Credenciales de empleado
Entra en Ajustes TPV y selecciona la pestaña Credenciales de empleado. La tabla muestra cada credencial con su nombre visible, empleado asociado, tipo y estado.
- 2.
Revisa la credencial que vas a retirar
Localiza la fila correcta antes de continuar. La pantalla usa `label` como nombre principal; si falta, usa el empleado para credenciales de tipo selector o el código para PIN y tarjeta.
- 3.
Usa la acción Eliminar
Abre las acciones de la fila y pulsa Eliminar. Esta acción solo aparece para usuarios con `tpv:manage` y siempre se aplica a una única credencial visible.
- 4.
Confirma o cancela el modal
El modal Eliminar recurso permite cancelar sin cambios o confirmar el borrado. Al confirmar, la app envía `DELETE /api/app/{orgId}/{locationId}/staff-tpv-credentials/{id}` sin payload.
- 5.
Comprueba el resultado
Tras una eliminación correcta, la app cierra el modal, muestra el mensaje Los cambios se aplicaron correctamente. y refresca la lista. La credencial deja de participar en la autenticación operativa del TPV.
Validaciones y límites
- El endpoint de borrado necesita exactamente un `{id}` después de `staff-tpv-credentials` y no acepta payload.
- Si falta la ubicación, falta el id, la credencial no existe o pertenece a otra ubicación, la operación se trata como recurso no encontrado.
- El borrado es físico: se elimina la fila de `staff_tpv_credentials`.
- Eliminar la credencial no elimina el empleado `staff` asociado.
- La acción no diferencia entre credenciales activas e inactivas: con permiso y pertenencia a la ubicación, se borra.
- Limitación conocida: la UI contempla `tpv:view` para acceder a la superficie, pero el listado backend de credenciales no acepta solo `tpv:view`.
Resultado esperado
La credencial queda retirada del TPV de la ubicación, desaparece del listado y ya no puede resolverse como acceso operativo, mientras la ficha del empleado permanece intacta.