Cómo retroceder un item KDS
Devuelve un producto visible en KDS al estado de producción anterior con un gesto horizontal sobre su fila, sin abrir formularios ni cambiar el ticket completo.
En este artículo
El retroceso de un item KDS sirve para corregir el avance de cocina cuando un producto se marcó demasiado pronto. La acción se hace directamente en el tablero, sobre una fila de producto de un ticket abierto del servicio activo.
Antylogic calcula el estado anterior según el flujo de cocina: `ready` vuelve a `preparing`, `preparing` vuelve a `sent` y `sent` vuelve a `draft`. Después refresca el ticket y el listado para que el tablero muestre el nuevo estado.
Antes de empezar
- Trabajar en Grupo Marea Demo y en la ubicación Marea Gran Via.
- Tener KDS habilitado en los ajustes de TPV y un servicio activo en la ubicación.
- Tener permisos operativos `kds:use` o `kds:manage`; con solo `kds:view` se puede ver el tablero, pero no operar filas.
- Tener un ticket abierto con un item de cocina visible en estado `sent`, `preparing` o `ready`.
- Mantener visibles los filtros de estado que necesites comprobar después del cambio, porque el item puede desaparecer si el nuevo estado queda fuera del filtro activo.
Instrucciones
- 1.
Abre el tablero KDS
Entra en `/:orgId/:locationId/kds`. La pantalla carga el servicio activo, los tickets abiertos y los productos relevantes para cocina.
- 2.
Localiza un item operable
Busca una fila en estado Enviado, En preparación o Listo. La acción no aparece como botón de texto: se revela al deslizar la fila horizontalmente hacia la derecha.
- 3.
Desliza hacia el estado anterior
Haz el gesto sobre la fila hasta confirmar el retroceso. El cambio afecta solo al item deslizado y usa el estado actual como protección frente a cambios hechos desde otro terminal.
- 4.
Comprueba el tablero actualizado
Espera al refresco del KDS. El item queda en el estado anterior o deja de verse si los filtros activos no incluyen el nuevo estado.
Validaciones y límites
- Un item en `draft` no tiene estado anterior y no confirma el gesto.
- Los items `served` y `cancelled` no se muestran como operables en el tablero KDS.
- Si la fila está procesando otra actualización o el usuario no tiene `kds:use` ni `kds:manage`, el gesto no envía la mutación.
- El cliente KDS usa `POST /api/app/{orgId}/{locationId}/tickets/{ticketId}/items/production-status`; el backend también acepta `PUT` para la misma operación.
- El backend exige un `to_status` válido, `item_ids` del ticket y KDS habilitado; si falla la actualización, la UI muestra: `No pudimos actualizar el estado del producto.`
- Retroceder de `preparing` a `sent` puede volver a crear trabajos de cocina `kitchen_order`.
Resultado esperado
El item queda actualizado en `ticket_items.production_status`, con el timestamp del estado destino, y el KDS se refresca con el ticket actualizado.