Cómo completar una operación de pago
Cierra una operación de pago externa activa y la convierte en un cobro real del ticket, con actualización del estado del ticket y recibo en cola cuando hay dispositivos configurados.
En este artículo
Completar una operación de pago sirve para cerrar una autorización externa que ya estaba asociada a un ticket. La operación puede venir de la pantalla de cobro o del panel de operaciones del terminal.
Cuando la operación todavía no tenía un pago asociado, Antylogic crea el `ticket_payment`, aplica allocations válidas si existían y recalcula el estado del ticket y de sus items.
Antes de empezar
- Sesión iniciada en Grupo Marea Demo con la ubicación Marea Gran Via seleccionada.
- Permiso de ubicación `tpv:use` o `tpv:manage`; `tpv:view` solo permite consultar operaciones.
- Una `tpv_payment_operation` activa para el ticket y un método de pago externo no manual.
- Un terminal TPV seleccionado, o una operación ya vinculada a `terminal_id` o `claimed_by_terminal_id`.
- Para ver un recibo en cola, la ubicación debe tener configuración TPV y al menos un dispositivo de salida elegible.
Instrucciones
- 1.
Entrar al TPV con terminal y empleado
Abre el TPV de Marea Gran Via con el terminal de la sesión. Si aparece el selector de empleado, elige Marta Ruiz para trabajar con las operaciones visibles del terminal.
- 2.
Localizar la operación activa
En la pantalla de cobro del ticket, revisa la sección Pagos. También puedes abrir Más acciones del TPV y entrar en Operaciones de pago del terminal. La operación debe estar en un estado activo, como `pending`, `claimed` o `requires_action`.
- 3.
Reclamar la operación si procede
Si la operación aparece como pendiente, usa Reclamar antes de completarla. Si ya está reclamada por el mismo terminal o requiere una acción externa, puedes pasar directamente a completar mientras siga visible para tu terminal.
- 4.
Pulsar Completar
Pulsa Completar en la tarjeta de la operación. La app envía el estado `completed`, el terminal seleccionado, el terminal reclamante y el importe autorizado; si no había importe autorizado, usa el importe solicitado.
- 5.
Confirmar el cobro en el ticket
Vuelve a la pantalla de cobro y comprueba que la operación aparece como Completada. Si no existía `ticket_payment`, Antylogic crea un pago completado con el método de la operación y recalcula el estado de pago del ticket.
- 6.
Revisar la cola de salida si aplica
Si hay dispositivos de salida activos, la compleción intenta crear un job de recibo. Si no aparece job, no lo trates como un fallo del cobro: la cola de recibos es condicional y no bloquea el pago.
Validaciones y límites
- La operación debe existir y pertenecer a la ubicación actual; si pertenece a otra ubicación, no se actualiza.
- Las operaciones `completed` o `cancelled` no muestran acciones en la UI.
- Para completar una operación sin `ticket_payment_id`, el importe autorizado resuelto debe ser mayor que cero.
- `request_payload` y `response_payload` solo son válidos en el update si son objetos JSON.
- Las allocations explícitas solo se aplican si usan items del ticket, importes positivos y no superan el pendiente del item ni el total del pago.
- Los pagos `refunded` no cuentan como efectivos al recalcular el estado del ticket.
- La generación del recibo es best effort y depende de dispositivos de salida elegibles.
Resultado esperado
La operación queda marcada como Completada. Si todavía no estaba enlazada a un pago, el ticket recibe un `ticket_payment` completado, se recalculan ticket e items y, cuando procede, queda un recibo pendiente en la cola de salida.