Cómo añadir un producto de cocina al ticket
Añade al ticket TPV un producto que requiere cocina, como Croquetas de jamon en Marea Gran Via, dejándolo como línea solicitada en borrador antes de enviarlo a cocina o KDS.
En este artículo
Este flujo cubre el momento en que sala añade un producto de cocina al ticket desde el detalle TPV. La línea queda preparada dentro de la cuenta, pero todavía no dispara comanda, impresión ni KDS.
El ejemplo usa Croquetas de jamon del demo ES. En la interfaz puede aparecer como Croquetas porque el TPV prioriza el nombre corto del producto cuando existe.
Antes de empezar
- Abrir el TPV con contexto de organización y ubicación de Marea Gran Via.
- Tener un ticket TPV existente, mutable y de la misma ubicación; en la UI no debe estar cerrado ni anulado.
- Tener permiso operativo de TPV sobre la sesión activa, o permiso de gestión de tickets si se opera fuera de esa sesión.
- Tener en el catálogo un producto de cocina de la ubicación, por ejemplo Croquetas de jamon, marcado como requiere cocina.
Instrucciones
- 1.
Abre el detalle del ticket
Entra en el detalle del ticket TPV desde la vista de sala. La pantalla carga el ticket, la sesión activa, los ajustes TPV y el catálogo disponible para añadir líneas.
- 2.
Localiza el producto de cocina
Busca Croquetas en el panel de catálogo. El producto pertenece al catálogo de la ubicación y su marca de cocina procede de la ficha de producto, no se introduce manualmente al añadirlo.
- 3.
Toca el producto
Pulsa la tarjeta del producto. Si no existe una línea equivalente editable, el TPV crea una nueva línea con cantidad 1, precio del catálogo, estado de producción draft y estado de pago unpaid.
- 4.
Comprueba la línea añadida
Verifica que el producto aparece dentro del ticket como línea solicitada o pendiente. En este punto sigue siendo borrador de producción y el envío a cocina queda para una acción posterior.
- 5.
Revisa bloqueos si no se añade
Si la tarjeta está deshabilitada o aparece un error, comprueba que el ticket siga abierto, que pertenece a la sesión operativa correcta y que el usuario mantiene permisos de TPV o gestión de tickets.
Validaciones y límites
- El enlace del detalle debe incluir ticketId, terminalId y staffId.
- La UI solo permite añadir productos si existe ticketId y el ticket se puede modificar.
- Si ya existe una línea equivalente en draft, unpaid, sin notas, mesa, comensal ni descuento y en service_pass 1, la UI suma cantidad en esa línea en lugar de crear otra.
- El alta no crea tpv_output_jobs ni kitchen_order; no debe interpretarse como envío a cocina o KDS.
- El backend rechaza tickets anulados con status void; la UI también bloquea tickets cerrados.
- Si la mutación falla, la pantalla restaura el estado previo y muestra el error localizado No pudimos añadir el producto.
Resultado esperado
El ticket queda actualizado con Croquetas como línea de cocina en borrador, con importes recalculados y lista para enviarse a producción más adelante.