Cómo registrar un cobro manual
Registra en el TPV un pago completado sobre un ticket pendiente de Marea Gran Via, usando un método manual activo y compatible con el terminal.
En este artículo
El cobro manual se registra desde el TPV sobre un ticket real: la pantalla muestra el pendiente, las líneas seleccionadas, el método de pago y el importe antes de confirmar.
Este flujo está pensado para operadores de sala y responsables de turno. Si el método es efectivo o caja automática, la caja del terminal debe estar abierta para el mismo servicio antes de cobrar.
Antes de empezar
- Tener acceso al TPV de Marea Gran Via con permiso `tpv:use` o autorización equivalente sobre tickets del servicio activo.
- Trabajar con un ticket de la ubicación que no esté anulado y que tenga importe pendiente.
- Tener seleccionado un terminal TPV válido y un empleado, por ejemplo Marta Ruiz en el terminal demo de Marea Gran Via.
- Usar un `tpv_payment_method` activo, visible para el usuario o terminal y con `execution_mode=manual`.
- Si el método es `cash`, `cashdro`, `cashlogy`, `cashguard`, `glory` o `cashkeeper`, debe existir una `cash_register_session` abierta para el mismo servicio y terminal.
Instrucciones
- 1.
Abre el pago avanzado
Desde el ticket pendiente, entra en la pantalla de pago avanzado. Revisa que carguen el ticket, el empleado, el terminal, las líneas pendientes y el bloque de métodos de pago.
- 2.
Elige el método manual
Selecciona el método con el que se va a registrar el cobro. La pantalla filtra métodos activos por usuario permitido y compatibilidad con el terminal.
- 3.
Revisa líneas e importe
Comprueba qué unidades quedan incluidas. Si no introduces importe, la pantalla cobra el pendiente seleccionado; si introduces menos, el pago queda como cobro parcial sobre esas líneas.
- 4.
Pulsa Cobrar
Al confirmar, Antylogic envía método, terminal, importe, posible cambio o propina y asignaciones de líneas al endpoint de pagos del ticket.
- 5.
Comprueba el resultado
La app debe mostrar `Pago registrado correctamente.` y refrescar el ticket. El pago queda como `completed`, el saldo pendiente se reduce y las líneas pasan a pagadas o parcialmente pagadas según el importe.
- 6.
Usa cobro rápido solo cuando encaje
Desde el detalle del ticket puede cobrarse el pendiente completo con botones rápidos. Para documentarlo como cobro manual, el método rápido debe ser manual; si necesitas ajustar líneas o importes, usa pago avanzado.
Validaciones y límites
- El botón de cobro queda deshabilitado si no hay método seleccionado o el importe calculado es 0.
- Si no hay métodos compatibles, la pantalla muestra `No hay métodos activos compatibles con el terminal seleccionado.`
- Los métodos no manuales de la pantalla avanzada no forman parte de esta guía: se tramitan como `tpv_payment_operation` pendiente.
- El backend valida ticket, ubicación, permisos, método de pago, terminal y caja abierta cuando el método es de efectivo o caja automática.
- Cada asignación de línea debe pertenecer al ticket, tener importe positivo y no superar el pendiente de esa línea.
- Registrar el cobro modifica datos del runtime: crea `ticket_payment`, puede crear allocations y actualiza el estado del ticket y de sus líneas.
Resultado esperado
El ticket queda actualizado con un `ticket_payment` completado. Si el importe cubre todo el pendiente, el ticket pasa a `paid`; si solo cubre una parte, queda `partially_paid`.