Actualizar estado de producción

En este artículo

Antes de empezar

• Sesión iniciada en Grupo Marea Demo con Marea Gran Via como ubicación activa.
• KDS activo en la configuración TPV de la ubicación.
• Ticket TPV existente en Marea Gran Via, no anulado, y accesible desde TPV o KDS.
• Productos de cocina pendientes cuando se quiera mostrar Enviar comanda a cocina.
• Permiso operativo según superficie: gestión de cocina o tickets en TPV, y kds:use o kds:manage para mover productos en KDS.
• Para capturas ES, usar TPV_TICKET_ID, TPV_TERMINAL_ID, TPV_STAFF_ID y TPV_OUTPUT_DEVICE_ID del runtime documental.

Instrucciones

1. 1.

   Abrir la superficie de trabajo

   Entra en el detalle del ticket TPV o en el tablero KDS del terminal activo. En el runtime ES, trabaja sobre Marea Gran Via y el ticket TPV_TICKET_ID.

2. 2.

   Revisar los productos que pueden avanzar

   Comprueba qué productos siguen pendientes y cuál es su estado. El flujo de cocina esperado es draft -> sent -> preparing -> ready -> served; los productos que no requieren cocina pueden pasar de draft a served.

3. 3.

   Enviar comanda desde el detalle TPV

   En el detalle del ticket, abre Personalizar y usa Enviar comanda a cocina. La app mueve los productos de cocina pendientes de draft a sent, suprime la salida automática y solicita la comanda de cocina usando el terminal seleccionado.

4. 4.

   Avanzar un producto desde KDS

   En KDS, cocina mueve un producto al estado anterior o siguiente desde su fila. La operación usa el producto actual, el estado origen y el estado destino, y no solicita una impresión adicional desde KDS.

5. 5.

   Avanzar un producto desde el detalle TPV

   En el detalle de la cuenta, ya sea en Mesas, Cuentas o Todas o en la pantalla de detalle, desliza la línea del producto y usa Cambiar a <estado> para avanzarlo o Volver a <estado> para devolverlo al estado anterior. Hace falta KDS activo y permiso para gestionar cocina.

6. 6.

   Comprobar el resultado

   Revisa que el producto aparece en la columna o estado correcto. TPV y KDS refrescan el detalle de la comanda y la lista de tickets sin recalcular importes ni pagos.

7. 7.

   Verificar la cola de salida cuando aplica

   Si la acción envió productos a cocina y se solicitó impresión por terminal, abre Cola de impresión y KDS para confirmar que el trabajo kitchen_order quedó pendiente, completado o listo para reintento según corresponda.

Validaciones y límites

• La ubicación del ticket debe coincidir con Marea Gran Via y el ticket no puede estar anulado.
• Debe existir al menos un selector efectivo: item_ids con productos del ticket o from_statuses con estados origen válidos.
• El destino debe ser draft, sent, preparing, ready, served o cancelled.
• Los productos sin cocina no deben forzarse a sent, preparing ni ready salvo que ya estén dentro del flujo de cocina; en cambios por estado se omiten cuando no aplican.
• kds:view permite consultar el tablero, pero para mover productos se necesita kds:use o kds:manage.
• La app-native inspeccionada usa POST para el cambio masivo; PUT existe como compatibilidad backend, pero no debe presentarse como flujo principal.
• El endpoint production-status no acepta terminal_id. Cuando la UI necesita enrutar por terminal, envía suppress_output=true y después solicita POST /tickets/{ticketId}/print.
• Solo to_status=sent puede crear salida automática desde production-status cuando suppress_output no es true; preparing, ready, served, draft y cancelled no crean tpv_output_job.
• Si no hay productos coincidentes, si ya estaban en el destino o si no hay dispositivos de salida seleccionables, puede no aparecer ningún trabajo nuevo en la cola.

Resultado esperado

Los productos quedan en el estado de producción correcto, TPV y KDS reflejan el cambio y, cuando se envía a cocina con salida disponible, la cola recibe trabajos kitchen_order para los productos actualizados. La acción no recalcula importes ni pagos del ticket.