Consultar disponibilidad pública
Permite comprobar desde la web pública de Marea Gran Via qué franjas quedan disponibles para una reserva automática según fecha, servicio, personas y preferencias opcionales de mesa. La consulta solo muestra opciones; no crea reservas ni clientes.
En este artículo
Usa esta guía para documentar el paso Hora de la reserva pública, donde el cliente revisa huecos disponibles antes de introducir sus datos de contacto.
La disponibilidad se calcula con la ocurrencia pública seleccionada, el plano del servicio, la configuración de optimización, las reservas existentes y las preferencias aplicables.
Antes de empezar
- La web pública debe cargar en `/:orgId/:locationId/booking` o `/:orgId/:locationId/reservar` con `orgId` y `locationId` válidos.
- La ubicación debe tener reservas públicas activas y servicios automáticos visibles para el cliente.
- El cliente debe haber elegido una fecha y un servicio público automático; los servicios manuales no avanzan a disponibilidad calculada.
- El servicio necesita `layout_id` y `optimization_config_id` resolubles.
- El cliente debe indicar un número de personas mayor que cero.
- Para documentar preferencias, las preferencias públicas no deben estar desactivadas y el plano debe exponer zonas, mesas o tipos de mesa útiles.
Instrucciones
- 1.
Abrir la reserva pública
El cliente entra en la página pública de Marea Gran Via desde `/reservar` o `/booking`. La pantalla carga el perfil público antes de mostrar el recorrido de reserva.
- 2.
Elegir fecha y servicio
Selecciona una fecha disponible y un servicio público automático. La pantalla conserva el `occurrence_id` que se usará para pedir disponibilidad.
- 3.
Indicar personas
Introduce el tamaño del grupo. Antylogic convierte el valor a `party_size` y bloquea el avance si no es positivo o si hay avisos bloqueantes de personas.
- 4.
Seleccionar preferencias opcionales
Si aparece el paso Preferencias, el cliente puede elegir una zona o un tipo de mesa. Las zonas se traducen a mesas preferidas y los tipos de mesa se envían como preferencia, no como obligación.
- 5.
Consultar horarios
Al entrar en Hora, la pantalla envía la consulta pública de disponibilidad con `occurrence_id`, `party_size` y las preferencias aplicables. El optimizador calcula huecos a partir de mesas, combinaciones, reservas existentes y configuración del servicio.
- 6.
Elegir una franja
La pantalla muestra tarjetas con hora, duración, puntuación, mesas propuestas y posible etiqueta Preferible. Elegir una tarjeta solo prepara el siguiente paso; todavía no se crea la reserva.
Validaciones y límites
- La consulta solo se activa cuando existen `orgId`, `locationId`, `occurrence_id` y `party_size`.
- `party_size` debe ser mayor que cero y `occurrence_id` no puede estar vacío.
- La ocurrencia debe pertenecer a la ubicación pública actual, ser de tipo `service`, tener visibilidad `public` y estar en modo `automatic`.
- No se calculan huecos para servicios `internal`, manuales, completados, pasados o de otra ubicación.
- Debe poder resolverse el plano y la configuración de optimización del servicio.
- La fecha debe respetar `public_booking_min_advance_days`.
- Si las preferencias públicas están desactivadas, el paso Preferencias desaparece y el backend ignora preferencias enviadas manualmente.
- Si el cálculo falla, la pantalla muestra un error de disponibilidad; si no hay huecos, informa de que ahora mismo no queda hueco.
- Seleccionar una franja no crea `reservation`, `customer` ni asignaciones de mesa.
Resultado esperado
El cliente ve una lista de franjas disponibles calculadas para la ocurrencia pública y puede dejar una hora seleccionada para continuar al flujo posterior de datos de contacto y creación de reserva.