Cómo abrir el detalle de un ticket TPV
Abre una cuenta del TPV para revisar productos, estados de cocina, pagos, total pendiente, factura asociada y acciones disponibles sin perder el contexto de sala.
En este artículo
El detalle de ticket es la vista operativa donde sala y caja comprueban qué se ha pedido, qué queda pendiente, cómo va el cobro y qué acciones pueden ejecutar sobre una cuenta.
En las capturas de referencia se usa el demo ES de Grupo Marea Demo en Marea Gran Via. Los bloques fiscales solo deben mostrarse cuando el ticket tenga factura y datos reales asociados.
Antes de empezar
- Tener una organización y una ubicación seleccionadas; en el demo ES se usa Marea Gran Via.
- Tener permiso `tpv:use` en la ubicación. La pantalla bloquea la carga si falta ese permiso.
- Abrir un ticket existente de la ubicación. Con solo `tpv:use`, el ticket debe pertenecer al servicio activo.
- Para ver la entrada a facturación, el ticket debe estar completamente cobrado y el usuario debe tener permiso `tpv:invoice` o `tickets:manage`.
Instrucciones
- 1.
Abre el TPV en Plano
Entra en el TPV de la ubicación y parte de la vista de sala. Desde ahí puedes abrir un ticket activo manteniendo el origen `sourceTab=floor` para volver al mismo contexto.
- 2.
Entra en el detalle del ticket
La pantalla recibe `ticketId`, `terminalId`, `staffId` y `sourceTab`, sincroniza la ruta de la app y carga el detalle con la organización y ubicación seleccionadas.
- 3.
Revisa productos, estados e importes
Comprueba los productos de la cuenta, sus estados operativos o de cocina, los pagos registrados, el total y el importe pendiente antes de continuar con cobro, impresión o edición.
- 4.
Consulta factura y estado fiscal si existen
Si el ticket ya tiene factura, el detalle puede mostrar datos fiscales, entrega, validación y registros asociados. Si no existe factura, esos bloques no aparecen.
- 5.
Vuelve al TPV o ejecuta una acción secundaria
Al volver, la pantalla usa `sourceTab` y `terminalId` para regresar al contexto de origen. Imprimir, facturar, gestionar cocina o mutar el ticket dependen de permisos y estado del ticket.
Validaciones y límites
- Si falta la ubicación seleccionada, la pantalla muestra `Selecciona una ubicacion para abrir el ticket.`
- Si falta `tpv:use`, la pantalla muestra `No tienes permisos para usar este ticket del TPV.` y no ejecuta la consulta principal.
- Si falta `ticketId`, la pantalla muestra `No encontramos el ticket solicitado.`
- Durante la carga del ticket y datos de soporte se muestra `Cargando ticket...`.
- Si la consulta falla, la pantalla muestra `No pudimos cargar el ticket.`
- El backend devuelve `ErrNotFound` si el ticket está vacío o no pertenece a la ubicación del contexto.
- Los tickets `void` o `closed` pueden consultarse, pero bloquean acciones de edición, cobro avanzado y cambios de productos.
Resultado esperado
El operador queda en el detalle completo del ticket, con productos, pagos, importes, estado operativo y acciones disponibles según permisos, manteniendo el camino de vuelta al TPV de origen.