Ver sala en TPV
Consulta el plano operativo del servicio activo desde la pestaña Mesas del TPV, con zonas, mesas, reservas asignadas y tickets abiertos.
En este artículo
La vista de sala del TPV reúne en un solo plano lo que el equipo necesita saber durante el servicio: qué mesas están libres, cuáles tienen reserva, dónde hay tickets abiertos y qué cuentas ya están en fase de pago.
En el demo de Grupo Marea Demo, este flujo se abre para Marea Gran Via y sirve para revisar la sala antes de actuar. La vista por sí misma no escribe datos; las acciones empiezan cuando se abre un ticket, se crea una cuenta o se gestiona una reserva.
Antes de empezar
- Tener seleccionados Grupo Marea Demo y Marea Gran Via, porque la ruta se contextualiza como `/:orgId/:locationId/tpv`.
- Tener permiso de ubicación `tpv:use` para cargar el TPV.
- Disponer de una `service_session` activa; si no existe, el TPV ofrece abrir un servicio cercano del calendario o uno manual.
- Tener un plano resoluble desde el servicio activo, la ocurrencia activa o un layout marcado como predeterminado.
- Si el TPV pide acceso de empleado por PIN, selector o tarjeta, seleccionar o autenticar un empleado antes de ver el workspace; en el demo se usa Marta Ruiz.
Instrucciones
- 1.
Abre Mesas del TPV
Entra en `/:orgId/:locationId/tpv?tab=floor`. Si la pestaña llega vacía o con un valor no válido, la pantalla vuelve automáticamente a Mesas.
- 2.
Resuelve el acceso de empleado
Si aparece el selector, PIN o tarjeta de empleado, identifica al empleado de sala antes de esperar que cargue el plano. En el runtime ES, el ejemplo preparado es Marta Ruiz.
- 3.
Comprueba el servicio activo
La sala operativa solo se muestra con una sesión de servicio activa. Si el TPV indica que no hay servicio activo, abre el servicio cercano del calendario o un servicio manual desde la propia pantalla.
- 4.
Revisa el plano
Con el servicio activo, Mesas carga el layout, las zonas, las mesas, los conectores de mesas combinadas, los controles de zoom y ajuste, y la leyenda de estados.
- 5.
Interpreta los estados de mesa
Lee cada mesa por su estado: Libre, Reservada, Ocupada, A pagar o Pagado. Las reservas muestran cliente, personas y hora, y los tickets muestran la situación operativa de la cuenta.
- 6.
Abre el detalle cuando haga falta
Toca una mesa ocupada para abrir su ticket. Si la mesa está reservada y no tiene ticket, se abre la modal Mesa reservada con cliente, teléfono, llegada, personas y mesas asignadas. Las mesas libres pueden seleccionarse para Crear cuenta.
Validaciones y límites
- Sin contexto de organización y ubicación, la pantalla pide seleccionar una ubicación.
- Sin `tpv:use`, el TPV muestra el estado de permisos y no carga el workspace.
- La pestaña solo acepta `floor`, `free`, `orders`, `fast`, `reservations` y `summary`; cualquier otro valor vuelve a `floor`.
- Un 404 al consultar `service-sessions/active` se trata como ausencia de servicio activo, no como error fatal.
- El layout se resuelve primero desde `layout_id` o `layoutId` del servicio u ocurrencia activa; si no existe, se usa el layout predeterminado.
- Si no hay layout disponible, Mesas muestra que el servicio no tiene un plano disponible todavía.
- La prioridad de estado es: parcialmente pagado, pagado, ticket activo, reserva activa y libre; tickets `closed` o `void` y reservas `cancelled` o `noshow` no ocupan el plano.
- Solo las mesas libres pueden seleccionarse para Crear cuenta, y la creación valida que el número de personas sea un entero positivo.
Resultado esperado
El responsable de sala ve el plano operativo del servicio activo con reservas, tickets y estados de mesa conectados, listo para consultar la sala antes de abrir tickets o gestionar reservas.