Cómo editar una reserva
Corrige una reserva existente desde el detalle de una ocurrencia: cliente, teléfono, personas, hora, duración y modo de mesas, manteniendo el estado como solo lectura.
En este artículo
Editar una reserva es un flujo operativo de sala y recepción. Permite ajustar una reserva ya vinculada a una ocurrencia de servicio y, cuando corresponde, crear o actualizar el cliente asociado desde el mismo editor.
El flujo parte del detalle de la ocurrencia en Marea Gran Via. El cambio de estado, la cancelación, la recuperación y el borrado viven en acciones separadas; este editor se centra en datos de cliente, horarios, duración, comensales y mesas.
Antes de empezar
- Trabajar en Grupo Marea Demo y en la ubicación Marea Gran Via, con una ocurrencia de reservas abierta.
- La reserva debe existir en la ubicación activa y pertenecer a la ocurrencia abierta; el runtime demo usa una reserva como Javier Martin en RESERVATION_OCCURRENCE_ID.
- El rol necesita `reservation:view` para cargar la pantalla y `reservation:manage` para abrir y guardar el editor.
- Para ver datos de cliente se necesita `customer:view`; para crear o actualizar el cliente inline se necesita `customer:manage`.
- Para cambiar mesas, la ocurrencia debe tener un layout con mesas cargadas. Si falta el layout o no hay mesas, el selector queda deshabilitado.
Instrucciones
- 1.
Abrir la ocurrencia
Entra desde el calendario de reservas o abre `/:orgId/:locationId/reservations/:occurrenceId`. La pantalla carga la ocurrencia, reservas, asignaciones, clientes, layout y configuración de optimización para ese servicio.
- 2.
Elegir la reserva
En la pestaña Reservas, localiza la fila y pulsa Editar. También puedes abrir el mismo editor desde una reserva del tablero Cronograma cuando la ocurrencia no está en modo lista de espera.
- 3.
Revisar el editor
Comprueba Nombre cliente, Teléfono cliente, Personas, Hora, Duración, Estado y Modo de mesas. El Estado se muestra como solo lectura; para cancelar, descancelar o cambiar estado se usan acciones distintas.
- 4.
Actualizar datos operativos
Corrige nombre, teléfono, número de personas, hora o duración. Si la reserva no tenía `customer_id`, la pantalla crea primero un cliente con esos datos y usa el nuevo id al guardar la reserva.
- 5.
Definir mesas
Deja Indiferente si no quieres condicionar mesas. Usa Preferidas, Requeridas o Asignar mesas cuando el cambio deba incluir mesas concretas del plano; si el modo no es Indiferente, selecciona al menos una mesa válida.
- 6.
Guardar cambios
Pulsa Guardar. La pantalla valida los campos, envía la actualización de la reserva y, si ya había cliente vinculado, actualiza después ese cliente. Al terminar, refresca ocurrencia, reservas, asignaciones y clientes.
- 7.
Resolver confirmación manual
Si aparece Guardar y pasar a manual, úsalo solo cuando el responsable acepta que esa ocurrencia pase a modo manual para conservar la distribución. Después revisa la fila o el tablero para confirmar cliente, hora, duración, personas y mesas.
Validaciones y límites
- Si faltan `selectedOrgId`, `selectedLocationId` u `occurrenceId`, la pantalla devuelve estado de no encontrado.
- Sin `reservation:view`, la pantalla muestra No tienes permisos para ver reservas; sin `reservation:manage`, no se guarda la edición.
- Nombre cliente y Teléfono cliente son obligatorios en el frontend.
- Personas debe ser mayor que cero; la UI limita el selector entre 1 y 99.
- Duración se ajusta al intervalo de slots configurado y la UI limita hasta 480 minutos.
- Si el modo de mesas no es Indiferente, debe haber al menos una mesa válida seleccionada en el layout cargado.
- La edición normal se deshabilita en ocurrencias con `booking_mode` waiting_list; una reserva en waitlist no conserva hora, duración ni mesas como una reserva ordinaria.
- La actualización de reserva y la actualización del cliente no forman una transacción única; si falla la segunda llamada, no hay rollback demostrado de la primera.
Resultado esperado
La reserva queda actualizada y la pantalla vuelve al detalle refrescado. Si se aceptó Guardar y pasar a manual, la ocurrencia queda en modo manual; si el cambio fue normal, la fila o el tablero muestran los datos actualizados sin cerrar el contexto del servicio.