Abrir servicio manual desde KDS
Inicia un servicio operativo desde la pantalla KDS de Marea Gran Via sin seleccionar una ocurrencia del calendario. Al confirmar Servicio manual, Antylogic crea la service_session abierta y genera internamente el evento y la ocurrencia necesarios para que cocina trabaje sobre un servicio activo.
En este artículo
Usa esta guía cuando el equipo necesita arrancar cocina desde KDS y no quiere abrir el servicio desde una ocurrencia pública del calendario.
El flujo manual envía un payload vacío al backend. La sesión queda vinculada a un evento interno y a una ocurrencia General, pero no se convierte en un servicio reservable público.
Antes de empezar
- Estar dentro de Grupo Marea Demo con la ubicación Marea Gran Via seleccionada.
- Abrir la pantalla KDS en /:orgId/:locationId/kds.
- Tener KDS habilitado en los ajustes TPV de la ubicación.
- Tener permiso KDS: kds:view, kds:use o kds:manage.
- Tener permiso efectivo tpv:use para que el backend acepte la apertura.
- No debe existir otra service_session con status=open en la ubicación.
- Si el modal sugiere Servicio más cercano, seleccionar Servicio manual antes de confirmar.
Instrucciones
- 1.
Entrar en KDS
Abre /:orgId/:locationId/kds para Marea Gran Via. La vista solo carga si hay organización, ubicación, permiso KDS y enable_kds activo.
- 2.
Comprobar que no hay servicio activo
La cabecera debe mostrar Abrir servicio. Si aparece Servicio activo, la ubicación ya tiene una sesión abierta y no se puede iniciar este flujo.
- 3.
Abrir el modal de servicio
Pulsa Abrir servicio en la cabecera KDS. El modal muestra Servicio más cercano y Servicio manual.
- 4.
Seleccionar Servicio manual
Marca Servicio manual para abrir el servicio sin occurrence_id. Esta selección diferencia el flujo manual de la apertura desde calendario.
- 5.
Confirmar la apertura
Pulsa Abrir servicio. El cliente llama a POST /api/app/{orgId}/{locationId}/service-sessions con {} y el backend crea la sesión abierta.
- 6.
Verificar el resultado
El modal se cierra, aparece Servicio abierto correctamente si el toast sigue visible y la cabecera pasa a Servicio activo.
Validaciones y límites
- La pantalla bloquea el flujo si falta organización o ubicación seleccionada.
- Sin permiso KDS o con tpv_settings.enable_kds=false, KDS no queda disponible.
- La UI puede habilitar el intento con tpv:use o tpv:manage, pero la apertura real exige tpv:use en backend.
- El backend rechaza abrir una segunda service_session open en la misma ubicación.
- El flujo manual desde KDS no envía occurrence_id, event_id, opened_by_staff_id ni opened_at.
- Al recibir {}, el backend fuerza status=open, toma locationId desde la ruta y crea calendar_event y calendar_occurrence internos.
- El evento manual tiene visibility=internal y no debe documentarse como servicio reservable público.
- La apertura manual no abre cash_register_sessions.
- La actualización reciente sobre filtros por terminal y jobs KDS no cambia esta acción.
Resultado esperado
KDS queda en estado Servicio activo para Marea Gran Via. La sesión abierta está lista para recibir producción de cocina y mantiene trazabilidad interna con calendario sin publicar un servicio reservable.