Abrir servicio manual en el TPV
Inicia el servicio de Marea Gran Via desde el TPV cuando el responsable de sala no va a elegir una ocurrencia de calendario existente. Antylogic abre una única sesión de servicio para la ubicación y crea automáticamente el evento y la ocurrencia internos que dan contexto operativo al servicio.
En este artículo
Usa esta guía cuando el equipo necesita empezar a operar el TPV desde un estado sin servicio activo y decide abrir Servicio manual.
Aunque el operador no selecciona calendario, Antylogic mantiene la trazabilidad: la apertura manual crea internamente el evento y la ocurrencia de servicio que sostienen la sesión TPV.
Antes de empezar
- Sesión iniciada en Grupo Marea Demo con Marea Gran Via como ubicación activa.
- Permiso de ubicación `tpv:use`. Los permisos de KDS, calendario o solo lectura no bastan.
- TPV disponible en `/:orgId/:locationId/tpv?tab=floor`, opcionalmente con `terminalId` para fijar el runtime TPV.
- No debe existir otra `service_session` abierta para Marea Gran Via.
- Para capturas documentales, el runtime debe empezar sin servicio activo.
Instrucciones
- 1.
Abrir el TPV de sala
Entra en el TPV de Marea Gran Via. Cuando no hay servicio activo, la pantalla muestra `No hay un servicio activo.` y ofrece la acción `Abrir servicio`.
- 2.
Seleccionar Servicio manual
Pulsa `Abrir servicio` y elige `Servicio manual`. Si el TPV propone un `Servicio más cercano`, cambia expresamente a la opción manual antes de confirmar.
- 3.
Confirmar apertura
Pulsa `Abrir servicio`. La app envía la apertura manual sin campos adicionales y el sistema crea la sesión abierta para la ubicación.
- 4.
Comprobar el TPV activo
Tras la confirmación, el modal se cierra y el TPV vuelve a la operativa normal del servicio activo, listo para trabajar con mesas, tickets y tareas de sala.
Validaciones y límites
- La acción exige `tpv:use` en la pantalla y también en el backend.
- Solo puede haber un servicio abierto por ubicación; una segunda apertura se rechaza con conflicto.
- No se envía `occurrence_id` en este flujo. Si se envía, la apertura pasa a ser desde calendario.
- El operador no edita nombre, hora, duración, plano ni empleado desde el modal manual; esos valores se derivan en backend.
- La apertura manual no abre una `cash_register_session`; la caja se gestiona después desde el servicio activo.
Resultado esperado
Marea Gran Via queda con una `service_session` abierta, enlazada a un `calendar_event` y una `calendar_occurrence` internos. La vista TPV queda preparada para operar mesas y tickets; caja y cobros siguen siendo acciones posteriores.