Cómo dividir un item en otro pase de TPV
Separa parte de la cantidad de un producto del ticket en un nuevo pase de servicio cuando KDS está activo, manteniendo el item original con la cantidad restante y recalculando la cuenta.
En este artículo
Esta acción ayuda a ordenar el servicio cuando una misma línea del ticket debe salir en momentos distintos. El operador conserva el producto original en su pase actual y mueve una parte de sus unidades a un pase nuevo sin rehacer la cuenta.
El flujo pertenece a la operativa de TPV conectada con cocina. La interfaz solo lo ofrece con KDS activo y sobre items que todavía son editables para el flujo de producción.
Antes de empezar
- Tener sesión iniciada con organización y ubicación seleccionadas, por ejemplo Grupo Marea Demo en Marea Gran Via.
- Poder operar el TPV con `tpv:use`; para tickets fuera del servicio activo o gestión avanzada puede requerirse `tickets:manage`.
- Tener KDS activo en la configuración TPV de la ubicación; si `enable_kds` está desactivado, la acción no aparece en la interfaz.
- Abrir un ticket TPV accesible, editable y no anulado dentro de la ubicación actual.
- Elegir un item con cantidad mayor que 1 y que no esté en estado `sent`, `preparing` ni `ready`.
- Si el item tiene descuento, contar con `tpv:discount` o `tickets:manage` para que el backend acepte la modificación.
Instrucciones
- 1.
Abre el ticket de TPV
Entra en el ticket desde el detalle del TPV o desde el panel de ticket seleccionado en planta. En la demo localizada, usa Marea Gran Via con la sesión de Marta Ruiz y el ticket preparado para documentación.
- 2.
Selecciona un item divisible
Pulsa un producto del ticket que tenga varias unidades. El editor rápido debe mostrar el estado de producción, el pase de servicio y la acción `Dividir en dos pases`.
- 3.
Abre el modal de división
Pulsa `Dividir en dos pases`. El modal muestra el campo `Cantidad` y propone por defecto la mitad entera de la cantidad actual del item.
- 4.
Confirma la cantidad que pasa al nuevo pase
Introduce una cantidad entre 1 y la cantidad actual menos 1, y pulsa `Dividir`. El sistema reduce el item original y crea una nueva línea con esa cantidad en el pase siguiente.
- 5.
Revisa el resultado en el ticket
Comprueba que el item original conserva su pase con menos unidades y que aparece otra línea en el nuevo pase. Los importes del item y los totales del ticket se recalculan después de cada cambio.
Validaciones y límites
- La acción queda bloqueada si KDS no está activo, si hay una mutación en curso, si la cantidad es 1 o menor o si el item ya no es editable para cocina.
- El modal solo acepta números enteros; si el campo queda vacío, contiene texto no numérico o supera el rango permitido, `Dividir` queda deshabilitado.
- El item original conserva su `service_pass`; el item nuevo se crea con el pase del original incrementado en 1.
- El nuevo item conserva producto, nombre, asiento, comensal, notas recortadas, precio unitario, impuestos, estado de producción y estado de pago.
- Si hay descuento, se reparte proporcionalmente entre la cantidad que queda en el item original y la cantidad separada.
- La división no envía automáticamente el item a cocina ni crea trabajos de salida; el envío a cocina sigue ocurriendo en el flujo normal de producción.
- La operación no es atómica: primero se reduce el item original y después se crea el nuevo item. Si falla la segunda parte, refresca el ticket y corrige la cuenta con un supervisor.
- Los usuarios con solo permisos KDS no pueden usar esta acción de edición TPV; necesitan acceso operativo de TPV o gestión de tickets.
Resultado esperado
El ticket queda reorganizado por pases: la línea original mantiene la cantidad restante y aparece una nueva línea en el pase siguiente con los mismos datos operativos relevantes para cocina, pago e impuestos.