Cómo abrir el pago avanzado de un ticket
Abre la pantalla de cobro avanzado de un ticket pendiente para revisar total, pagado, pendiente, líneas cobrables, métodos compatibles y pagos u operaciones locales antes de continuar con el cobro.
En este artículo
El pago avanzado concentra la revisión de una cuenta pendiente antes de cobrarla. Desde el TPV o desde el detalle del ticket, el operador llega a una pantalla con el contexto completo: importe total, pagos ya registrados, pendiente real, líneas seleccionables y métodos de pago disponibles.
Este flujo está pensado para cajeros, operadores de sala y responsables de turno que necesitan confirmar qué se va a cobrar y con qué método, manteniendo el ticket, las operaciones locales del terminal y la trazabilidad de pagos dentro de Antylogic.
Antes de empezar
- Trabajar con sesión autenticada, organización y ubicación activas. En el runtime ES de documentación se usa Grupo Marea Demo y Marea Gran Via.
- Tener permiso de ubicación `tpv:use`; sin este permiso la pantalla indica que no se puede cobrar el ticket.
- Abrir un ticket pendiente, accesible y no anulado. Si se entra desde los botones del TPV o del detalle, el ticket tampoco debe estar cerrado ni completamente cobrado.
- Contar con al menos un `tpv_payment_method` activo compatible con el usuario o con el terminal local actual.
- Para capturas documentales, el runtime debe aportar `TPV_TICKET_ID`, `TPV_TERMINAL_ID` y `TPV_STAFF_ID`, con Marta Ruiz como personal TPV en Marea Gran Via.
Instrucciones
- 1.
Abre el ticket pendiente
Desde el TPV de Marea Gran Via, entra en un ticket con importe pendiente y pulsa `Pago avanzado` o `Cobro avanzado`. En capturas se puede abrir directamente con el deeplink `tpv/ticket/payment?ticketId=${TPV_TICKET_ID}&terminalId=${TPV_TERMINAL_ID}&staffId=${TPV_STAFF_ID}&sourceTab=floor`.
- 2.
Comprueba el contexto de cobro
Revisa que la cabecera corresponde al ticket elegido y que muestra total, pagado y pendiente. La pantalla carga el detalle del ticket, ajustes del TPV, métodos activos, operaciones del ticket y personal asociado a las operaciones.
- 3.
Revisa las líneas seleccionadas
Confirma qué productos o unidades se van a cobrar. La pantalla selecciona por defecto todas las unidades pendientes, pero permite limpiar la selección o marcar solo líneas concretas antes de introducir el importe.
- 4.
Elige método e importe
Selecciona un método visible y, si procede, introduce el importe con el teclado. Solo aparecen métodos activos compatibles con el usuario o terminal local, y el importe se limita al pendiente seleccionado.
- 5.
Revisa pagos y operaciones
Antes de continuar, consulta el resumen inferior de operaciones locales y pagos registrados. Las operaciones del terminal local aparecen antes que los pagos previos; los pagos completados reducen el pendiente y los reembolsados no computan como pagados.
Validaciones y límites
- El botón de origen queda deshabilitado si el ticket está `void`, `closed` o sin pendiente; un deeplink directo puede abrir la pantalla, pero el bloqueo explícito verificado dentro de la pantalla es para tickets `void`.
- Si falta ubicación, `ticketId` o permiso `tpv:use`, la pantalla corta el flujo con el estado correspondiente.
- Durante la carga se muestra `Cargando cobro...`; si falla el detalle del ticket, se muestra `No pudimos cargar el ticket para cobrar.`
- Si no hay métodos activos compatibles, se muestra `No hay métodos activos compatibles con el terminal seleccionado.`
- El terminal operativo se deriva del usuario autenticado; si `terminalId` de la ruta no coincide, la pantalla reescribe el parámetro al terminal local.
- Los productos sin pendiente quedan deshabilitados como `Liquidado`; si el ticket no tiene líneas, aparece `No hay productos en la cuenta.`
- Las operaciones del ticket se refrescan periódicamente y solo se muestran como accionables si encajan con el terminal local o no tienen terminal asignado.
- En métodos de efectivo, el exceso introducido se presenta como cambio; en métodos no efectivo, como propina.
- Si el ticket ya tiene factura, la pantalla avisa del bloqueo de reembolso y deshabilita la acción de reembolso de pagos.
Resultado esperado
El operador llega a una pantalla de cobro avanzada con el ticket pendiente preparado para revisión: líneas seleccionadas, método compatible, importe a cobrar, cambio o propina cuando aplique, y resumen de pagos u operaciones locales antes de cerrar el cobro.