Cómo abrir un ticket desde KDS
Abre el detalle TPV de una cuenta visible en el tablero KDS pulsando la cabecera de su columna. La acción solo cambia de pantalla: no marca productos, no modifica estados de cocina y no cambia importes ni pagos.
En este artículo
Este flujo sirve para consultar el contexto operativo de una cuenta que ya está visible en cocina, sin tocar las líneas de producción ni avanzar estados.
La apertura empieza en la cabecera completa de la columna KDS y termina en el detalle TPV del ticket. Para cargar esa pantalla destino, el usuario necesita `tpv:use`.
Antes de empezar
- Hay una organización y ubicación seleccionadas; en el demo ES se usa Grupo Marea Demo, ubicación Marea Gran Via.
- KDS está activado en los ajustes del TPV y existe una sesión de servicio activa.
- La cuenta aparece como columna del tablero porque el ticket está abierto y tiene productos de cocina no servidos ni cancelados.
- El usuario puede ver KDS con `kds:view`, `kds:use` o `kds:manage`, y tiene `tpv:use` para abrir el detalle TPV.
Instrucciones
- 1.
Abre el tablero KDS
Entra en KDS de Marea Gran Via y confirma que el servicio está activo y que aparecen columnas de cuentas con productos pendientes de cocina.
- 2.
Localiza la cuenta
Busca la columna que quieres revisar. La cabecera muestra la cuenta, la mesa y el empleado; si faltan esos datos, la app muestra `Sin mesa` o `Sin empleado`.
- 3.
Pulsa la cabecera de cuenta
Toca la cabecera completa de la columna, no una línea de producto. La app navega al detalle TPV enviando `ticketId`, `staffId` si existe y `terminalId` si está seleccionado.
- 4.
Revisa el detalle TPV
Consulta productos, importes y controles del ticket. Abrirlo desde KDS no cambia estados de cocina, productos, cobros ni impresión.
- 5.
Vuelve desde el detalle
Usa el botón de volver cuando termines. En este flujo, el retorno lleva de nuevo al tablero KDS. Solo si el detalle se abrió sin pantalla anterior, por ejemplo al recargar la página en web, el botón lleva al TPV en la pestaña Todas.
Validaciones y límites
- Si KDS está deshabilitado, no hay sesión activa, faltan permisos KDS o no hay productos pendientes, el tablero no muestra una cuenta que abrir.
- La cabecera solo funciona como botón cuando el usuario cumple las condiciones de apertura del ticket desde KDS.
- Si falta `ticketId`, la pantalla destino indica que no encuentra el ticket solicitado.
- Si el usuario no tiene `tpv:use`, el detalle TPV muestra el aviso de permisos.
- El backend valida que el ticket pertenece a la ubicación actual y que el usuario tiene acceso de lectura al ticket.
Resultado esperado
El ticket queda abierto en el detalle TPV para revisión operativa. La navegación no modifica `tickets`, `ticket_items`, `production_status` ni `tpv_output_jobs`.