Añadir producto de catálogo al ticket
Añade una unidad de un producto visible en el catálogo operativo al ticket abierto. Si ya existe una línea compatible del mismo producto, Antylogic incrementa esa línea; si no, crea una nueva y recalcula la cuenta.
En este artículo
Este flujo sirve para registrar productos en una cuenta abierta desde el TPV de la ubicación, sin salir del detalle del ticket.
El panel muestra el catálogo del servicio activo o, si el servicio no define catálogo, el catálogo predeterminado. El equipo trabaja siempre con los productos visibles en esa superficie.
Antes de empezar
- Abrir un ticket existente del TPV en la ubicación, por ejemplo en Marea Gran Via.
- Tener permiso `tpv:use` en la ubicación.
- Trabajar sobre un ticket que la pantalla no muestre como `void` ni `closed`.
- Tener cargado el servicio activo, el catálogo operativo y los productos visibles de la ubicación.
Instrucciones
- 1.
Abre el ticket
Entra en el detalle del ticket que quieres modificar. La pantalla debe mostrar la cuenta y el panel de catálogo del servicio activo. Si falta el ticket, aparece `No encontramos el ticket solicitado.`; si el usuario no tiene acceso, no se muestra ni la cuenta ni el catálogo.
- 2.
Localiza el producto
Usa los filtros de tipo o el buscador para encontrar el producto. La búsqueda coincide con el nombre o el nombre corto. Cuando el catálogo define `product_ids`, solo se muestran esos productos; si no hay productos visibles, el panel indica `No hay productos disponibles en este catálogo.`
- 3.
Toca la tarjeta de producto
Pulsa una vez la tarjeta del producto para añadir una unidad. Cada pulsación añade exactamente una unidad; para más cantidad, repite la pulsación o edita la línea después.
- 4.
Revisa la cuenta
Comprueba que aparece una línea nueva o que aumenta la cantidad de una línea compatible. Una línea nueva queda con `production_status:"draft"`, `payment_status:"unpaid"`, cantidad 1 y `service_pass` 1.
Validaciones y límites
- Si el ticket está `void` o `closed` en la pantalla, las tarjetas quedan deshabilitadas y no se modifica la cuenta.
- El incremento automático solo fusiona una línea del mismo `product_id` en `draft` y `unpaid`, sin asiento, comensal, descuento, notas y con `service_pass` 1.
- El endpoint de items recibe `product_id`, no `catalog_id`; la pertenencia al catálogo se controla desde los productos visibles en la UI.
- No se fusionan líneas con notas, descuento, asiento, comensal, `service_pass` distinto de 1, producción distinta de `draft` o pago distinto de `unpaid`.
- Si el añadido o incremento falla, la pantalla revierte la actualización optimista y muestra el error correspondiente.
Resultado esperado
La cuenta queda actualizada con una unidad más del producto seleccionado y el ticket vuelve a mostrar subtotal, impuestos y total recalculados.