Saltar al contenido principal

Lotes y Series con trazabilidad completa

· 3 min de lectura
Equipo de desarrollo del producto CCF-Almacén

Se implementa el control de inventario por lotes y números de serie, con trazabilidad completa de cada movimiento de entrada y salida — requisito clave para el sector salud y farmacéutico.

Qué se entrega​

  • Tabla lotes: agrupa unidades del mismo lote con código, fechas de ingreso/vencimiento, cantidad inicial/disponible, precio de compra y referencia del proveedor.
  • Tabla series: número de serie único por unidad, asociado a un lote y a un producto, con estado (disponible, vendida, devuelta, danada, vencida).
  • Trazabilidad de movimientos: las entradas/salidas de inventario se vinculan a un lote y/o número de serie (movimientos_inventario.id_lote, movimientos_inventario.id_serie), preservando el historial (FK ON DELETE SET NULL).
  • Flags en productos: requiere_lote y requiere_numero_serie marcan los productos que necesitan trazabilidad; el backend valida que las entradas/salidas incluyan la trazabilidad exigida.
  • Contabilidad automática: al registrar una entrada con lote, se incrementa la cantidad disponible del lote; al registrar una salida, se decrementa (con validación de stock suficiente); para productos serializados se marca la serie como consumida.
  • Gestión desde el menú: pantalla Lotes y Series con CRUD de lotes y series, incluyendo filtrado por producto y series asociadas a un lote.
  • Formularios de producto: checkboxes para activar el control por lote y/o número de serie.

Tabla de cambios​

ÁreaCambioArchivo / ruta
Base de datosmigración 006 (tablas lotes, series)ccf-almacen-api/database/migrations/
Base de datosmigración 007 (flags productos + FK movimientos)ccf-almacen-api/database/migrations/
Backenddominio lotes (entidades, DTOs, servicio, controladores)src/domains/lotes/
Backendrelación lote/serie en movimientos y productomovimientos-inventario.*, producto.entity.ts
Frontendmodelos lote, serie + flags en Producto/Movimientosrc/models/
Frontendcliente API lotes/seriessrc/api/lote.ts
Frontendpantalla de gestión jerárquicasrc/components/lotes/lotes-management.tsx
Frontendtoggles de trazabilidad en formulario de productosrc/components/products/product-form.tsx
Frontendítem de menú Lotes y Seriessrc/components/layouts/sidebar/sidebar-option.ts
Wikimanual de usuario y esta nota de cambiodocs/manuales/inventarios/lotes-series.md

Uso esperado​

  • Para productos que requieren lote: registrar la entrada indicando el lote; las salidas consumen de la cantidad disponible del lote y quedan trazadas.
  • Para productos serializados: registrar la entrada con los números de serie (uno por unidad); las salidas consumen unidad a unidad asociando el número de serie al movimiento de salida.
  • Para productos sin trazabilidad: el flujo de inventario funciona como hasta hoy, sin interrupciones.

Próximos pasos​

  • Integrar selectores de lote/serie en los formularios de cargar stock (entrada) y despacho (salida) para registrar la trazabilidad directamente al crear movimientos.
  • Reporte de trazabilidad: ruta de un lote/serie desde su entrada hasta su última salida.

Co-authored-by: CommandCodeBot <noreply@commandcode.ai>