Cómo ver el tablero KDS
Consulta la pantalla de cocina de una ubicación para ver el servicio activo, las cuentas abiertas, las mesas, el empleado y los productos relevantes para KDS sin abrir servicios, cobrar, cerrar cuentas ni avanzar estados de producción.
En este artículo
El tablero KDS reúne lo que cocina necesita leer durante el servicio: cuentas abiertas, contexto de mesa, empleado responsable y productos pendientes o listos.
Esta guía cubre la consulta del tablero. Los gestos para avanzar productos, el procesamiento de jobs KDS y la apertura o cierre de servicios pertenecen a acciones separadas.
Antes de empezar
- Sesión iniciada con organización y ubicación seleccionadas, por ejemplo Grupo Marea Demo y Marea Gran Via.
- Permiso de ubicación `kds:view`, `kds:use` o `kds:manage`.
- KDS activado en los ajustes TPV de la ubicación mediante `tpv_settings.enable_kds`.
- Para ver contenido operativo, debe existir una `service_sessions` abierta con tickets abiertos y productos de cocina en `draft`, `sent`, `preparing` o `ready`.
- Para capturas localizadas, usar `${APP_DEEPLINK_BASE}${ORG_ID}/${LOCATION_ID}/kds?terminalId=${TPV_TERMINAL_ID}` para conservar el terminal del runtime demo.
Instrucciones
- 1.
Abrir Cocina
Desde la página de inicio de la ubicación, entra en Cocina. También puedes abrir directamente `/:orgId/:locationId/kds?terminalId=:terminalId` cuando la captura deba conservar el terminal TPV del runtime demo.
- 2.
Confirmar KDS Disponible
La pantalla carga los ajustes TPV y comprueba que KDS esté habilitado antes de mostrar datos operativos. Mientras carga, muestra `Cargando KDS...`.
- 3.
Revisar El Servicio Activo
Con KDS disponible, la cabecera identifica el servicio activo. Si no hay servicio abierto, el tablero queda en estado vacío y no lista cuentas ni jobs de sesión.
- 4.
Leer Las Cuentas Abiertas
Cada columna representa una cuenta abierta ordenada cronológicamente. La cabecera muestra número de cuenta, mesas resueltas desde el plano y empleado asociado, por ejemplo Marta Ruiz en Marea Gran Via.
- 5.
Usar Filtros De Estado
La cabecera permite filtrar productos en `draft`, `sent`, `preparing` y `ready`. Los contadores resumen todos los productos relevantes antes de aplicar el filtro visual.
- 6.
Interpretar Cada Producto
Cada línea muestra cantidad, nombre KDS del producto, nota si existe, estado, temporizador y color de antigüedad. Ejemplos del catálogo demo pueden ser Croquetas de jamon, Pulpo a la brasa o Arroz meloso de carabinero.
- 7.
Abrir Detalle Si Procede
Si el rol también tiene permisos TPV o de tickets suficientes, tocar la cabecera de una cuenta abre el detalle TPV de la cuenta. Un usuario solo KDS puede consultar el tablero, pero no obtiene ese enlace desde la UI.
- 8.
Mantener El Alcance
Usa esta pantalla para seguimiento visual de cocina. Ver el tablero no crea tickets, no cobra, no cierra cuentas, no anula tickets y no avanza productos.
Validaciones y límites
- Si falta organización o ubicación, la pantalla muestra `Selecciona una ubicación para abrir cocina.`
- Si el usuario no tiene permisos KDS, la pantalla muestra `No tienes permisos para usar KDS.`
- Si `enable_kds` está desactivado, se muestra `KDS está deshabilitado en los ajustes del TPV.`
- Un 404 esperado al buscar servicio activo se interpreta como ausencia de servicio, no como error fatal.
- Si no hay servicio activo, se muestra `No hay ningún servicio activo. Usa la cabecera para abrir uno.`
- Si hay servicio activo pero ningún producto relevante para cocina, se muestra `No hay productos pendientes en cocina.`
- Si una cuenta tiene productos relevantes pero ninguno coincide con los filtros activos, la columna muestra `Esta cuenta no tiene productos en el estado seleccionado.`
- La selección de filtros no puede quedar vacía; `served` y `cancelled` no forman parte del tablero principal.
- `terminalId` no filtra los tickets del tablero; en esta pantalla solo afecta al filtrado local de jobs KDS.
Resultado esperado
El equipo de cocina puede supervisar la carga del servicio activo por cuenta y estado visible, con contexto de mesa y empleado, sin ejecutar cambios de producción desde esta acción.