POS — los productos con lote o número de serie ya se pueden vender
En POS › Caja el botón Agregar al carrito se deshabilitaba para todo
producto con requiereLote o requiereNumeroSerie, y el API rechazaba la venta con un
mensaje que remitía a Inventario. Era una limitación de la primera fase del POS
(ADR-028) que dejaba fuera, en la práctica, casi todo el catálogo de farmacia y tienda.
Ahora se venden con trazabilidad: al agregar el producto se elige qué lote (o qué número de serie) sale, y esa referencia viaja con la línea hasta el kardex.
Qué cambió
- Carrito con trazabilidad. Al pulsar Agregar al carrito en un producto que exige
lote o serie se abre el diálogo «Lote o número de serie»:
- Lotes activos, no vencidos y con unidades, en orden FEFO (primero el que vence antes). La cantidad de la línea queda topada por las unidades de ese lote.
- Series en estado
disponible; cada serie ocupa una línea de una unidad. - La línea muestra «Lote: LOT-… · vence …» / «Serie: …» con un enlace Cambiar.
- Un mismo producto puede ocupar varias líneas: por lote distinto o por serie
distinta. La clave de la línea es
producto + lote + serie(antes era solo el producto y se mezclaban existencias de lotes diferentes). - Backend (INV-003).
POST /api/pos/ventasaceptaidLote/idSeriepor ítem. Dentro de la misma transacción del cobro valida pertenencia al producto, lote activo y no vencido, unidades del lote (y FEFO), y seriedisponible; luego descuentalotes.cantidad_disponible, marca la serie comovendiday registra el movimiento conid_lote/id_serie. - Anulación. Al anular la venta, el lote recupera sus unidades y la serie vuelve a
disponible, con el movimiento de entrada también trazado. - Nuevo endpoint de apoyo:
GET /api/pos/productos/:id/trazabilidad(roles del POS) devuelve los lotes vendibles (FEFO) y las series disponibles del producto. - Migración
1792730422554:pos_venta_items.id_loteyid_serie(nulos,ON DELETE RESTRICT) con sus índices.
Archivos clave
ccf-almacen-api/src/domains/pos/pos.service.ts— validación y descuento de lote/serie en el cobro, reversa en la anulación y consulta de trazabilidad.ccf-almacen-api/src/domains/pos/pos.controller.ts—GET productos/:id/trazabilidad.ccf-almacen-api/src/domains/pos/entities/pos-venta-item.entity.ts—idLote/idSeriey sus relaciones.ccf-almacen-api/src/database/migrations/1792730422554-PosTrazabilidadItems.ts.ccf-almacen-web/src/utils/pos-carrito.ts— reglas del carrito (clave por lote/serie, topes, validación y armado del payload), con pruebas.ccf-almacen-web/src/pages/pos.tsx— diálogo de lote/serie y línea del carrito.ccf-almacen-web/src/api/pos.ts— tipos ygetTrazabilidadProductoPos().
Cómo verificarlo
- Abre POS › Caja, abre una caja y busca un producto que exija lote (por ejemplo, de farmacia).
- Pulsa Agregar al carrito: aparece el diálogo con los lotes; el primero es el que vence antes. Elige uno y confirma.
- La línea muestra el lote y su vencimiento; Cambiar permite corregirlo.
- Con un producto serializado, cada alta pide una serie y crea una línea de 1 unidad.
- Cobra la venta: en Inventario el movimiento de salida queda con el lote/serie y el lote baja sus unidades. Anula la venta y comprueba que se restauran.
nota
La regla anterior (productos con lote/serie fuera del POS) queda derogada por esta entrega: el ADR-028 del framework se actualizará en la siguiente revisión de la base de conocimiento.