Saltar al contenido principal

POS — los productos con lote o número de serie ya se pueden vender

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

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/ventas acepta idLote / idSerie por ítem. Dentro de la misma transacción del cobro valida pertenencia al producto, lote activo y no vencido, unidades del lote (y FEFO), y serie disponible; luego descuenta lotes.cantidad_disponible, marca la serie como vendida y registra el movimiento con id_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_lote y id_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/idSerie y 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 y getTrazabilidadProductoPos().

Cómo verificarlo​

  1. Abre POS › Caja, abre una caja y busca un producto que exija lote (por ejemplo, de farmacia).
  2. Pulsa Agregar al carrito: aparece el diálogo con los lotes; el primero es el que vence antes. Elige uno y confirma.
  3. La línea muestra el lote y su vencimiento; Cambiar permite corregirlo.
  4. Con un producto serializado, cada alta pide una serie y crea una línea de 1 unidad.
  5. 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.