Ver detalle de ocurrencia
Consulta de solo lectura de una ocurrencia pública de servicio para revisar cabecera, estado, reservas, mesas asignadas, cronograma y resumen operativo sin crear, editar ni cerrar reservas.
En este artículo
Usa esta guía cuando el equipo de sala necesita preparar o revisar un servicio de reservas desde Grupo Marea Demo / Marea Gran Via sin ejecutar acciones de gestión.
La pantalla reúne la lectura operativa del servicio: fecha, rango horario, estado, lista de reservas, distribución de mesas y resumen por estado y franjas de llegada.
Antes de empezar
- Sesión iniciada con organización y ubicación activas, por ejemplo Grupo Marea Demo y Marea Gran Via.
- Permiso `reservation:view` o `reservation:manage` en la ubicación para abrir el detalle y cargar reservas y asignaciones.
- `occurrenceId` de una ocurrencia pública de servicio en la ubicación activa; en el runtime ES se usa `RESERVATION_OCCURRENCE_ID`.
- Permiso `customer:view` para ver nombres y teléfonos de clientes cuando estén disponibles.
- Permiso `layout:view` y mesas configuradas para que `Cronograma` muestre el plano operativo completo.
- Permiso `optimization:view` u `optimization:manage` solo si se necesita leer configuración de optimización o análisis de lista de espera.
Instrucciones
- 1.
Abrir la ocurrencia
Entra desde el calendario de reservas, desde una tarjeta de inicio, desde TPV con una ocurrencia activa o con el enlace `/:orgId/:locationId/reservations/:occurrenceId`. La pantalla debe abrir el detalle del servicio en la ubicación activa.
- 2.
Revisar cabecera y estado
Comprueba la fecha localizada, el nombre del servicio, el rango horario y el badge de estado. El badge puede indicar `Manual`, `Automatico`, `Lista de espera`, `Completo`, `Optimizado no disponible` y, si corresponde, `Pasado`.
- 3.
Consultar Lista
Usa la pestaña inicial `Lista` para revisar reservas ordenadas por hora. La tabla permite buscar y filtrar por estado, y muestra cliente, teléfono, estado, personas, mesas y hora.
- 4.
Consultar Cronograma
Cambia a `Cronograma` para ver la relación entre reservas, mesas asignadas, zonas del layout y ocupación activa por TPV cuando haya datos y permisos. Esta vista explica cómo se reparte el servicio en mesas físicas.
- 5.
Consultar Resumen
Cambia a `Resumen` para revisar conteos de reservas y personas por estado, además de llegadas por franja horaria. La pestaña ayuda a preparar sala antes del servicio sin modificar reservas ni asignaciones.
- 6.
Volver a la superficie anterior
Usa el botón de volver para regresar al origen operativo. Por defecto vuelve al calendario de reservas; si la entrada vino desde inicio o TPV, respeta `returnRoute`, `returnMode` y `returnTPVTab`.
Validaciones y límites
- Si faltan `selectedOrgId`, `selectedLocationId` u `occurrenceId`, la pantalla muestra `No encontramos la página solicitada.`.
- Si el usuario no tiene `reservation:view` ni `reservation:manage`, la pantalla muestra `No tienes permisos para ver reservas.` y no lanza las consultas principales.
- El backend solo devuelve la ocurrencia si pertenece a la ubicación activa y el evento asociado es un servicio público; servicios `internal` y eventos `private_event` quedan fuera de este detalle.
- La lista se carga con reservas y asignaciones filtradas por `occurrence_id`; si no hay reservas, aparece `No hay reservas para este servicio.`.
- `Cronograma` necesita `layout_id` o `layoutId`, permiso `layout:view` y mesas configuradas; si faltan datos, muestra el estado informativo correspondiente.
- En `booking_mode=waiting_list`, la acción principal pasa a `Lista de espera` y la edición o asignación normal queda bloqueada.
- Con el runtime ES actual, la ocurrencia empieza el 2026-06-23 y las capturas tomadas el 2026-06-24 deben mostrarla como pasada.
- `Configuraciones`, `Nueva reserva`, edición, eliminación, marcar completo, reabrir y asignación manual son acciones relacionadas, pero no forman parte de esta consulta de solo lectura.
Resultado esperado
El responsable de sala obtiene una lectura completa de la ocurrencia: qué reservas llegan, qué mesas tienen asignadas, cómo se distribuye el servicio en el plano y qué volumen operativo se espera por estado y franja horaria.