Cómo crear una reserva optimizada
Crea una reserva interna en Marea Gran Via desde una ocurrencia automática, eligiendo una franja calculada por el optimizador antes de guardar cliente, hora y condiciones de mesa.
En este artículo
Este flujo ayuda al equipo de reservas y sala a confirmar una reserva sin decidir la hora a ciegas: la aplicación calcula franjas viables según servicio, capacidad, mesas y reglas de optimización.
Si no hay franjas disponibles o el optimizador no responde, la aplicación ofrece alternativas como lista de espera o paso a modo manual. Esas ramas no sustituyen al guardado optimizado del happy path.
Antes de empezar
- Trabajar con Grupo Marea Demo y la ubicación Marea Gran Via seleccionadas.
- Tener permisos para gestionar reservas en la ubicación y usar reservas automáticas.
- Abrir una ocurrencia futura de tipo servicio, con `booking_mode=automatic`, `acceptance_state=open`, plano y configuración de optimización activos.
- Tener disponible el optimizador para calcular horarios y ejecutar la revisión posterior a la reserva.
- Disponer del nombre y teléfono del cliente antes de confirmar.
Instrucciones
- 1.
Abrir el servicio
Desde el calendario semanal o desde el enlace directo de detalle, abre la ocurrencia del Servicio de comidas Gran Via. La pantalla debe mostrar la acción Nueva reserva.
- 2.
Iniciar Nueva reserva
Pulsa Nueva reserva. Si entras desde el detalle de la ocurrencia, el servicio queda preseleccionado; desde calendario, primero se elige fecha y servicio disponible.
- 3.
Indicar personas y mesas
Introduce el número de comensales y decide la estrategia de mesas: indiferente, preferidas, obligatorias o asignadas. Cuando el modo no es indiferente, selecciona al menos una mesa.
- 4.
Elegir horario optimizado
En el paso Horario, revisa las franjas calculadas con hora, score y métricas operativas. Selecciona una franja disponible; si aparece como Desdoble, confirma que el cliente acepta la hora de salida.
- 5.
Completar cliente
Introduce Nombre cliente y Teléfono cliente. En esta superficie la aplicación crea un cliente nuevo antes de guardar la reserva.
- 6.
Guardar reserva
Confirma la operación. El backend recalcula la disponibilidad, valida que el slot siga vigente, crea la reserva con canal phone y refresca el detalle de la ocurrencia.
- 7.
Resolver excepciones
Si no hay franjas, usa Añadir a lista de espera. Si el optimizador falla y la pantalla ofrece modo manual, continúa con el editor manual usando los datos ya conocidos.
Validaciones y límites
- La acción optimizada sólo aplica a ocurrencias automáticas, abiertas, de la ubicación actual y no pasadas en la zona horaria del evento o la ubicación.
- El número de personas debe ser mayor que 0; el selector usa mínimo 1 y máximo 999.
- Si el modo de mesas no es indiferente, debe haber al menos una mesa seleccionada antes de calcular disponibilidad.
- El guardado requiere `occurrence_id`, `party_size` y `starts_at`; el backend rechaza el slot si desaparece al recalcular disponibilidad.
- La lista de espera crea una reserva normal con estado `waitlist`; no usa `POST /optimization/book`.
- Las asignaciones persistidas sólo están probadas cuando el payload envía `table_ids`; no conviene afirmar que las mesas sugeridas por un slot se guardan automáticamente en todos los modos.
Resultado esperado
La reserva queda creada en la ocurrencia con cliente, personas, hora optimizada y condiciones de mesa aplicables. La ocurrencia se refresca y queda marcada para revisión de optimización posterior.