Cómo abrir una ocurrencia de reservas
Abre desde el calendario semanal una ocurrencia operativa de servicio en Marea Gran Via para revisar reservas, mesas, estado y acciones disponibles del detalle.
En este artículo
Una ocurrencia de reservas es la instancia operativa de un servicio ya materializado. En el demo ES, el operador parte del calendario semanal de Marea Gran Via y abre Servicio de comidas Gran Via para trabajar sobre la ocurrencia real.
La apertura es una acción de lectura: `reservation:view` permite entrar en el detalle y consultar reservas, mesas y estado. `reservation:manage` no es necesario para abrir, pero sí condiciona acciones posteriores como crear reservas, cambiar asignaciones o usar configuraciones.
Antes de empezar
- Iniciar sesión con `Grupo Marea Demo` y la ubicación `Marea Gran Via` seleccionadas.
- Tener una entrada de calendario de tipo `service` en la ubicación actual.
- Contar con `reservation:view` en la ubicación para abrir y leer el detalle de la ocurrencia.
- Usar `reservation:manage` solo si el operador necesita ejecutar acciones de gestión dentro del detalle.
- Para capturas directas del runtime ES, usar `BOOKING_DETAIL_OCCURRENCE_ID`, `RESERVATION_OCCURRENCE_ID` o `SERVICE_OCCURRENCE_ID`.
Instrucciones
- 1.
Abrir el calendario semanal
Entra en el calendario de reservas de la ubicación en modo semana. En el demo ES, la pantalla de Marea Gran Via muestra los servicios del rango visible y permite localizar Servicio de comidas Gran Via.
- 2.
Seleccionar el servicio
Pulsa una entrada de tipo `service`. Si esa tarjeta ya trae `occurrenceId`, Antylogic navega directamente al detalle de la ocurrencia; los eventos `private_event` y `location_vacation` no abren este detalle de reservas.
- 3.
Resolver la ocurrencia si falta
Si el servicio no trae `occurrenceId`, la app intenta resolverlo con `event_id`, `occurrence_start`, `starts_at` y `ends_at`. Cuando el backend devuelve una ocurrencia válida, se abre el mismo detalle operativo.
- 4.
Comprobar el detalle abierto
Revisa la cabecera con servicio, fecha, franja horaria y estado. Esta pantalla concentra la lectura de reservas, asignaciones, clientes y contexto operativo de la ocurrencia.
- 5.
Trabajar con las pestañas
Usa Lista para revisar reservas como Javier Martin o Sara Molina, Cronograma para mesas y asignaciones, y Resumen para la lectura agregada del servicio. Las acciones de gestión aparecen según permisos.
- 6.
Volver al calendario
Usa el botón de volver del detalle. Si la apertura llegó con `returnRoute`, `returnMode`, `returnStartDate` o `returnFirstVisibleDate`, la app conserva el modo semanal y la fecha visible del calendario.
Validaciones y límites
- Solo las entradas de calendario de tipo `service` abren el detalle de ocurrencia de reservas.
- Sin `reservation:view`, el detalle muestra error de permisos y el backend deniega la lectura o resolución de ocurrencias.
- La resolución automática solo se intenta si existen `eventId`, `occurrenceStart`, `start` y `end` con fechas válidas.
- El backend exige `event_id`, `starts_at` y `ends_at`, y `ends_at` debe ser posterior a `starts_at`; si falta `occurrence_start`, puede usar `starts_at` como fallback.
- Si ya existe una ocurrencia compatible, se reutiliza; si no existe, el backend puede crear una ocurrencia `General` abierta.
- Si falla la resolución desde el calendario, no aparece un error específico: el operador permanece en el calendario.
- Si faltan `orgId`, `locationId` u `occurrenceId`, el detalle muestra página no encontrada.
- Las ocurrencias de otra ubicación o vinculadas a un evento que no sea `service` se tratan como no encontradas.
- Las ocurrencias pasadas se pueden abrir, pero no habilitan creación automática de reservas.
Resultado esperado
El responsable queda en el detalle operativo de la ocurrencia, con las reservas, mesas, estado del servicio y pestañas de trabajo disponibles para revisar la operación antes de volver al calendario.