Reclamar operación de pago
Permite que el terminal TPV activo asuma una operación de pago pendiente. La operación pasa a `claimed`, pero el cobro sigue sin completarse: no se crea `ticket_payment`, no se aplican pagos al ticket y no se generan trabajos de salida.
En este artículo
Usa esta guía cuando un operador de sala necesite tomar una operación de pago existente desde el terminal TPV que está usando. La reclamación deja la operación bajo el alcance del terminal activo y evita que otros puestos la gestionen como si siguiera libre.
Reclamar no equivale a cobrar. Después de reclamar, la operación todavía debe completarse, cancelarse o marcarse como fallida desde el flujo de pago correspondiente.
Antes de empezar
- La organización Grupo Marea Demo y la ubicación Marea Gran Via están seleccionadas.
- El operador tiene permiso `tpv:use` en la ubicación.
- El TPV puede resolver un terminal local, como el terminal web de la demo asociado a `TPV_TERMINAL_ID`.
- Existe una `TPVPaymentOperation` de la ubicación en estado `pending`, asociada a la sesión de servicio activa o al ticket abierto.
- Para capturas de la demo ES actual hay que preparar una operación `pending` en el runtime documental, porque no existe `TPV_PAYMENT_OPERATION_ID` expuesto y el método de pago actual es manual.
Instrucciones
- 1.
Abrir el TPV
Entra en el TPV principal de Marea Gran Via. Si aparece el selector de empleado, elige Marta Ruiz para cargar el TPV con el contexto operativo de la ubicación y el terminal local.
- 2.
Abrir operaciones del terminal
Abre Más acciones del TPV y entra en Operaciones de pago del terminal. El panel lista operaciones de la sesión activa que pertenecen al terminal actual o que todavía no tienen terminal asignado.
- 3.
Identificar la operación pendiente
Localiza una tarjeta en estado `pending`. Esa es la única situación en la que la UI muestra la acción Reclamar. En Pago avanzado del ticket, la misma comprobación aparece dentro de la sección Pagos.
- 4.
Reclamar la operación
Pulsa Reclamar. La app actualiza la operación a `claimed` y envía el terminal seleccionado como `terminal_id` y `claimed_by_terminal_id` cuando está disponible.
- 5.
Comprobar el resultado
Verifica que la tarjeta queda en estado `claimed`, asociada al terminal, y que el botón Reclamar desaparece. El cobro sigue pendiente de completarse, cancelarse o marcarse como fallido.
Validaciones y límites
- Con solo `tpv:view` se pueden consultar operaciones, pero no reclamarlas desde la UI.
- El botón Reclamar solo aparece para operaciones `pending`.
- Si `claimed_by_terminal_id` está informado, debe coincidir con el terminal seleccionado para que la operación quede dentro del alcance visual del puesto actual.
- Si se envía `terminal_id`, el backend valida que pertenezca a la ubicación.
- `claimed_at` lo fija el backend al pasar a `claimed` y no se sobrescribe si ya existía.
- Reclamar no crea `ticket_payment`, no aplica `ticket_payment_allocation`, no cambia el estado de pago del ticket y no genera trabajos de salida.
Resultado esperado
La operación queda marcada como `claimed` y vinculada al terminal que la tomó, mientras el pago permanece abierto para completarse, cancelarse o fallar después.