Cómo crear una operación de pago TPV
Inicia una operación de cobro TPV para un ticket pendiente usando un método no manual. Antylogic registra la intención de cobro en estado pending; el ticket no se liquida hasta que la operación se complete en el flujo correspondiente.
En este artículo
Usa esta guía cuando el equipo de Marea Gran Via necesite iniciar un cobro no manual desde Pago avanzado sin marcar todavía el ticket como pagado. La acción crea una operación pendiente y conserva la trazabilidad del ticket, el terminal, el método y los importes.
La pantalla prepara las líneas pendientes, el método compatible y las asignaciones por línea antes de enviar la operación. Si el método elegido es manual, el botón Cobrar registra un pago directo y no ejecuta esta acción.
Antes de empezar
- Trabajar en Grupo Marea Demo con la ubicación Marea Gran Via seleccionada.
- Tener un ticket TPV de la ubicación, no anulado y con líneas pendientes.
- Tener seleccionado el terminal TPV actual y un empleado TPV, por ejemplo Marta Ruiz.
- Contar con permiso tpv:use y acceso al ticket de la sesión de servicio activa.
- Usar un método de pago activo, compatible con el terminal y con execution_mode distinto de manual.
- Para métodos tipo efectivo, tener una sesión de caja abierta para la misma ubicación, sesión de servicio y terminal.
Instrucciones
- 1.
Abrir Pago avanzado
Desde el TPV principal o el detalle del ticket, abre Pago avanzado para el ticket pendiente. La pantalla carga el ticket, el terminal actual, los métodos disponibles, operaciones existentes y empleado TPV.
- 2.
Revisar las líneas pendientes
Comprueba qué líneas están seleccionadas. La pantalla selecciona por defecto las unidades pendientes y calcula A cobrar a partir del pendiente seleccionado.
- 3.
Elegir un método no manual
Selecciona un método activo compatible con el terminal actual. Para esta acción, el método debe tener execution_mode distinto de manual; un método manual usa el flujo de pago directo del ticket.
- 4.
Confirmar con Cobrar
Pulsa Cobrar para enviar la intención de cobro. La pantalla manda ticket_id, payment_method_id, terminal_id, importes y request_payload.allocations con ticket_item_id e importe por línea seleccionada.
- 5.
Comprobar la operación pendiente
Tras el éxito, la pantalla muestra Operación de pago creada, limpia los importes introducidos, refresca ticket y operaciones, y deja visible una operación pending que todavía no liquida el ticket.
Validaciones y límites
- La pantalla corta el flujo si faltan organización, ubicación, ticketId o permiso tpv:use.
- El ticket debe existir en la ubicación actual, no estar anulado y tener importe pendiente seleccionable.
- El método debe estar activo y ser compatible con el terminal en la selección de la pantalla.
- allowed_terminal_ids se aplica en la UI al filtrar métodos; no debe documentarse como validación final del POST.
- El backend requiere ticket_id y payment_method_id.
- terminal_id, si se envía o se deriva del método, debe pertenecer a la ubicación.
- Para métodos tipo efectivo, el backend exige terminal_id y una cash_register_session abierta.
- requested_amount debe quedar positivo tras normalizar; si falta y authorized_amount es positivo, se usa authorized_amount.
- request_payload y response_payload deben ser objetos JSON, no arrays.
- Crear la operación no crea ticket_payment ni ticket_payment_allocation persistido, no imprime, no factura y no cierra el ticket.
Resultado esperado
Queda creada una fila tpv_payment_operation en estado pending, vinculada al ticket, método, terminal, importes y payloads. El ticket sigue pendiente hasta que otra acción reclame, complete, cancele o marque la operación según corresponda.