Cómo ver el tablero KDS
Consulta las cuentas abiertas del servicio activo y los productos pendientes de cocina, con filtros por estado y contexto de mesa y empleado.
En este artículo
El tablero KDS mantiene conectada la cocina con el servicio activo. La vista reúne las cuentas abiertas de la ubicación y muestra solo los productos que siguen pendientes de producción.
Esta guía cubre la consulta del tablero. Avanzar productos entre estados, abrir o cerrar servicios y entrar al detalle TPV dependen de permisos adicionales y pertenecen a flujos separados.
Antes de empezar
- Tener sesión iniciada con organización y ubicación seleccionadas, por ejemplo Grupo Marea Demo y Marea Gran Via.
- Tener activado `tpv_settings.enable_kds` en los ajustes TPV de la ubicación.
- Contar con al menos uno de estos permisos de ubicación: `kds:view`, `kds:use` o `kds:manage`.
- Tener un `service_sessions` abierto para la ubicación.
- Para ver contenido, el servicio activo debe tener tickets abiertos con `ticket_items` de cocina que no estén `served` ni `cancelled`.
Instrucciones
- 1.
Abre el tablero de cocina
Entra en KDS desde la ubicación seleccionada. La ruta directa es `/:orgId/:locationId/kds`; si se usa un terminal concreto, `terminalId` puede filtrar los jobs KDS del dispositivo actual.
- 2.
Comprueba el servicio activo
Revisa la cabecera del tablero. Con servicio abierto se muestra `Servicio activo`, el nombre del servicio y la hora de apertura. Sin servicio activo, el tablero queda vacío y explica que no puede listar cuentas.
- 3.
Lee filtros y contadores
Usa los filtros para revisar productos `draft`, `sent`, `preparing` y `ready`, localizados como Solicitados, Enviados, En preparación y Listos. Los productos `served` y `cancelled` no aparecen.
- 4.
Revisa las cuentas abiertas
Cada tarjeta representa una cuenta abierta. La cabecera muestra `Cuenta #`, las mesas resueltas desde el plano y el empleado responsable cuando existe. Los tickets cerrados o anulados quedan fuera del tablero.
- 5.
Interpreta los productos pendientes
Cada línea muestra cantidad, nombre de cocina del producto, asiento o comensal si aplica, nota, icono de estado y temporizador para productos enviados, en preparación o listos.
- 6.
Distingue consulta y operación
Con `kds:view` la pantalla es consultiva. Para avanzar o retroceder estados desde el tablero se necesita `kds:use` o `kds:manage`; abrir o cerrar servicio desde el modal requiere permisos TPV.
- 7.
Mantén la vista durante el turno
Deja el tablero abierto mientras el servicio esté activo. La pantalla refresca servicio y tickets mientras está enfocada, y actualiza jobs KDS y personal en segundo plano.
Validaciones y límites
- Si falta organización o ubicación, la pantalla muestra `Selecciona una ubicación para abrir cocina.`
- Sin permisos KDS, se muestra `No tienes permisos para usar KDS.`
- Si KDS está desactivado, se muestra `KDS está deshabilitado en los ajustes del TPV.`
- Sin servicio activo, se muestra `No hay ningún servicio activo. Usa la cabecera para abrir uno.`
- Si no hay productos pendientes, se muestra `No hay productos pendientes en cocina.`
- Si una cuenta no coincide con los filtros activos, muestra `Esta cuenta no tiene productos en el estado seleccionado.`
- Si falla la carga de servicio, tickets, staff, layout, dispositivos o jobs, se muestra `No pudimos cargar la vista de cocina.`
- La cabecera de cuenta solo abre el detalle TPV si el usuario tiene permisos TPV o tickets adicionales.
Resultado esperado
El operador puede supervisar el servicio activo desde cocina, ver cuentas abiertas con productos pendientes y entender qué requiere atención sin usar esta acción para crear, cobrar, cerrar o anular tickets.