Antylogic
Probar demoAcceso app

399 guías operativas

Secciones de Docs
DocsKDS y cocina
Dispositivo

Abrir servicio de calendario desde KDS

Inicia en Marea Gran Via una sesión KDS vinculada al servicio público de calendario más cercano. Al confirmar la apertura, Antylogic crea una service_session abierta para la ubicación y deja la cabecera del tablero en Servicio activo.

En este artículo

Usa esta guía cuando el servicio ya está planificado en calendario y el equipo de cocina necesita activar el tablero KDS para operar el turno.

El flujo no abre caja, no crea tickets, no cobra ni genera salidas de impresión. Solo abre la sesión operativa que TPV y KDS usan como contexto compartido.

Antes de empezar

  • Trabajar en Grupo Marea Demo, ubicación Marea Gran Via.
  • Entrar al KDS desde /:orgId/:locationId/kds o desde el deep link antylogic://{orgId}/{locationId}/kds.
  • La ubicación debe tener tpv_settings.enable_kds activo.
  • El usuario debe tener acceso KDS y permiso operativo TPV real: tpv:use.
  • No debe existir otra service_session abierta para la misma ubicación.
  • Debe existir una ocurrencia pública de tipo service, de la misma ubicación, dentro del día actual del cliente y cercana a la hora actual.

Instrucciones

  1. 1.

    Entrar al tablero KDS

    Abre KDS para Marea Gran Via. La pantalla valida organización, ubicación, permisos KDS y que el KDS esté habilitado en ajustes TPV.

  2. 2.

    Comprobar la cabecera de servicio

    Antes de abrir desde calendario, la cabecera debe mostrar Abrir servicio. Si ya muestra Servicio activo, la ubicación ya tiene una sesión abierta y este flujo no debe repetirse.

  3. 3.

    Abrir el modal de servicio

    Pulsa la cabecera o el botón Abrir servicio. Con permiso TPV operativo, el modal carga las ocurrencias de servicio del día actual.

  4. 4.

    Revisar el servicio sugerido

    Mantén seleccionada la opción Servicio más cercano cuando aparezca Servicio de comidas Gran Via con el badge Sugerido y la hora relativa del servicio.

  5. 5.

    Confirmar la apertura

    Pulsa Abrir servicio del calendario. La app envía POST /api/app/{orgId}/{locationId}/service-sessions con el payload exacto { "occurrence_id": "<id>" }.

  6. 6.

    Verificar el estado activo

    Tras la respuesta correcta, el modal se cierra, aparece Servicio abierto correctamente. y la cabecera queda en Servicio activo con el nombre del evento.

Validaciones y límites

  • Si falta ubicación, la pantalla muestra Selecciona una ubicación para abrir cocina.
  • Si el usuario no tiene kds:view, kds:use ni kds:manage, KDS muestra No tienes permisos para usar KDS.
  • Si tpv_settings.enable_kds está desactivado, KDS muestra KDS está deshabilitado en los ajustes del TPV.
  • La opción Servicio más cercano solo se habilita con starts_at y ends_at válidos dentro de la ventana ends_at >= now - 1h y starts_at <= now + 6h.
  • El botón Abrir servicio del calendario se deshabilita si falta permiso TPV operativo, si la mutación está pendiente o si no hay candidato cercano.
  • El payload usa occurrence_id; no usa calendar_occurrence_id.
  • El backend exige tpv:use, verifica que no haya otra sesión abierta y que la ocurrencia sea service pública de la misma ubicación.
  • Para capturas, el runtime debe tener una ocurrencia pública del día actual; si SERVICE_OCCURRENCE_START sigue en 2026-06-23 durante una ejecución de 2026-06-24, crear el dato mínimo solo en el runtime documental y registrar el gap.

Resultado esperado

KDS queda en Servicio activo con Servicio de comidas Gran Via asociado a una única service_session abierta para Marea Gran Via.

Artículos relacionados