Lotes y Vencimientos

¿Qué es el módulo de Lotes y Vencimientos?

El módulo de Lotes te permite agrupar unidades de un producto por lote de fabricación, asignando fechas de vencimiento y controlando el stock por lote individual. Esto es fundamental para negocios que manejan productos perecederos, medicamentos, cosméticos o cualquier mercadería con fecha de expiración.

Cuando vendas un producto con lotes registrados, AdoqIA aplica automáticamente la regla FEFO (First Expired, First Out): primero se deducen los lotes con fecha de vencimiento más próxima.

🔧 Requisitos previos

Para utilizar lotes en un producto, ese producto debe tener habilitadas dos opciones:

1. Rastrear stock — activado en el formulario del producto.
2. Rastrear lotes y vencimientos — toggle que aparece debajo de "Rastrear stock".

Si desactivas "Rastrear stock", el toggle de lotes se desactiva automáticamente.

Nota: Solo los usuarios con rol Propietario o Administrador pueden acceder al módulo de lotes.

📋 Vista principal de lotes

Accede desde el menú lateral: Inventario → Lotes.

La vista principal muestra una tabla con todos los lotes registrados. Cada fila incluye:

| Columna | Descripción | |---------|-------------| | Código de lote | Identificador único del lote (ej: LOT-2024-001) | | Producto | Nombre y SKU del producto | | Almacén | Almacén donde se encuentra el lote | | Cantidad | Unidades disponibles en el lote | | Costo unitario | Precio de costo por unidad | | Fecha de vencimiento | Fecha de expiración del lote | | Estado | Activo, Vencido o Agotado | | Acciones | Botón para editar el lote |

Estados de un lote

• 🟢 Activo: El lote tiene stock disponible y no está vencido.
• 🔴 Vencido: La fecha de vencimiento ya pasó. El sistema marca automáticamente estos lotes.
• ⚪ Agotado: La cantidad llegó a 0. Si luego se repone cantidad, vuelve a Activo.

Indicadores de urgencia

Junto a la fecha de vencimiento, AdoqIA muestra indicadores visuales:

• 🔴 Rojo — El lote vence en 7 días o menos. Requiere acción inmediata.
• 🟡 Amarillo — El lote vence entre 8 y 30 días. Planifica una acción preventiva.
• Sin indicador — El lote tiene más de 30 días para vencer.

➕ Crear un nuevo lote

1. En la vista de lotes, haz clic en Crear lote.
2. Completa los campos del formulario:

| Campo | Obligatorio | Descripción | |-------|:-----------:|-------------| | Producto | ✅ | Solo se muestran productos con "Rastrear lotes" activado | | Variante | Solo si aplica | Si el producto tiene variantes, selecciona cuál | | Almacén | ✅ | En qué almacén se encuentra este lote | | Código de lote | ✅ | Identificador único (máx. 100 caracteres) | | Cantidad | ✅ | Unidades del lote (mayor a 0) | | Fecha de fabricación | ❌ | Fecha en que se fabricó el lote | | Fecha de vencimiento | ❌ | Fecha de expiración | | Costo unitario | ❌ | Precio de costo por unidad | | Proveedor | ❌ | Proveedor de origen del lote | | Notas | ❌ | Observaciones adicionales (máx. 500 caracteres) |

1. Revisa las advertencias (si las hay):

- Stock excedido — Si la cantidad del lote supera el stock disponible en el almacén menos los lotes ya existentes, se muestra una advertencia amarilla. Puedes continuar igualmente. - Fecha pasada — Si la fecha de vencimiento es anterior a hoy, se advierte que el lote se creará como ya vencido.

1. Haz clic en Crear lote. Serás redirigido a la lista de lotes con un mensaje de éxito.

Errores comunes al crear

• Código duplicado — Ya existe un lote con ese código para el mismo producto y almacén. Usa un código diferente.
• Producto sin rastreo de lotes — Habilita "Rastrear lotes y vencimientos" en el formulario del producto primero.

✏️ Editar un lote

1. En la lista de lotes, haz clic en el ícono de lápiz (✏️) en la fila del lote que deseas modificar.
2. Se abre un modal con los campos editables:

- Cantidad — Puedes ajustar la cantidad. Si la pones en 0, el lote cambiará a estado "Agotado". - Fecha de vencimiento — Puedes corregir o agregar la fecha. - Costo unitario — Puedes actualizar el costo. - Notas — Puedes agregar o modificar observaciones.

1. Haz clic en Guardar. Solo se envían los campos que modificaste.

Tip: Si un lote está "Agotado" y le asignas cantidad mayor a 0, volverá automáticamente a estado "Activo".

📦 Lotes en el detalle de producto

Cuando un producto tiene "Rastrear lotes" activado, aparece un tab "Lotes" en su vista de detalle.

Este tab muestra:

• Resumen:

- Stock activo total en lotes - Lotes por vencer en los próximos 30 días - Lotes vencidos

• Tabla de lotes: Código, cantidad, fecha de vencimiento y estado con indicadores de urgencia.
• Paginación propia para navegar entre muchos lotes.

📊 Widget del Dashboard — Lotes por vencer

En el dashboard principal, los usuarios Propietario y Administrador ven un widget "Lotes por vencer esta semana" que muestra cuántos lotes vencen en los próximos 7 días.

• Si hay lotes por vencer, se muestra el conteo. Haz clic para ir directamente a la lista filtrada.
• Si no hay lotes por vencer, se muestra "No hay lotes por vencer esta semana".
• Si hay un error de carga, aparece un botón "Reintentar".

📈 Reporte de lotes por vencer

La vista de lotes tiene un modo "Por vencer" (segundo botón en la barra de vista).

Este modo funciona como un reporte dedicado de lotes próximos a expirar:

1. Ventana de días — Por defecto muestra lotes que vencen en los próximos 30 días. Puedes cambiar el valor entre 1 y 365 días. También hay botones rápidos: 7d, 30d, 60d.
2. Filtro por almacén — Filtra los resultados para un almacén específico.
3. Columna "Días restantes" — Muestra cuántos días faltan para que el lote venza, con indicadores de color:

- 🔴 Rojo: 7 días o menos - 🟡 Amarillo: 8 a 30 días - Neutro: más de 30 días

1. Ordenamiento — Los lotes se muestran ordenados por fecha de vencimiento ascendente (los más urgentes primero).

Recomendación: Consulta este reporte semanalmente para planificar promociones de productos próximos a vencer o decidir sobre su disposición.

🛒 Lotes en el Punto de Venta (POS)

Cuando buscas productos en el POS, AdoqIA muestra indicadores visuales de lotes:

Indicadores en búsqueda

• 🟠 Ícono naranja de advertencia — El producto tiene lotes por vencer en los próximos 30 días, pero aún hay stock disponible no vencido.
• 🔴 Ícono rojo de bloqueo — Todo el stock disponible en lotes está vencido o no hay lotes activos con cantidad.
• Sin ícono — El producto no tiene lotes registrados o todos sus lotes están en buen estado.

Errores al vender

Si el backend detecta problemas con los lotes al procesar una venta, la venta se rechaza completa (sin procesar parcialmente) y se muestra una alerta:

| Error | Tipo de alerta | Significado | |-------|---------------|-------------| | No hay lotes disponibles | 🔴 Error (persistente) | No existe stock asignado a lotes para ese producto | | Todo el stock está vencido | 🟡 Advertencia | Los lotes existentes están todos vencidos | | Stock insuficiente en lotes | 🟡 Advertencia | Hay lotes pero no alcanzan para la cantidad solicitada |

En todos los casos, el carrito se mantiene intacto para que puedas ajustar la venta.

Importante: AdoqIA usa FEFO (First Expired, First Out) automáticamente. No necesitas elegir de qué lote se descuenta — el sistema lo hace por ti.

🛍️ Lotes en Compras

Cuando registras una compra de un producto con "Rastrear lotes" activado, aparecen campos adicionales en cada item:

• Código de lote — Opcional. Si lo completas, al confirmar la compra se crea automáticamente un lote.
• Fecha de vencimiento — Se asigna al lote creado.
• Fecha de fabricación — Se asigna al lote creado.

Comportamiento al confirmar compra

• Si completaste el código de lote → se crea el lote automáticamente con la cantidad y almacén de la compra.
• Si dejaste el código vacío → la compra se confirma normalmente sin crear lote.
• Si la creación del lote falla → se muestra cuál lote falló con opción de reintentar. La compra ya confirmada no se ve afectada.

🔍 Filtros disponibles

En la vista principal de lotes ("Todos") puedes filtrar por:

| Filtro | Descripción | |--------|-------------| | Búsqueda de producto | Busca lotes por nombre o SKU de producto | | Almacén | Muestra solo lotes de un almacén específico | | Estado | Activo, Vencido o Agotado | | Días de vencimiento | Lotes que vencen dentro de X días |

Los filtros se combinan entre sí. El botón "Limpiar filtros" restablece todos.

❓ Preguntas frecuentes

¿Puedo crear un lote sin fecha de vencimiento?

Sí. El campo de fecha de vencimiento es opcional. Los lotes sin fecha se muestran con "Sin vencimiento" y no aparecen en el reporte de vencimientos.

¿Qué pasa si un lote vence?

El sistema marca automáticamente el lote como "Vencido". En ventas, se deducen primero los lotes con fecha más próxima (FEFO). Si todo el stock está vencido, la venta será rechazada.

¿Puedo tener lotes en diferentes almacenes para el mismo producto?

Sí. Cada lote pertenece a un almacén específico. Puedes tener múltiples lotes del mismo producto en diferentes almacenes, cada uno con su propio código y fecha de vencimiento.

¿Se puede reactivar un lote agotado?

Sí. Si editas un lote con estado "Agotado" y le asignas una cantidad mayor a 0, el lote vuelve automáticamente a estado "Activo".

¿Qué es la advertencia de stock excedido al crear un lote?

Es una advertencia informativa. Aparece cuando la cantidad del lote supera el stock disponible en el almacén menos la suma de lotes ya existentes. No bloquea la creación — es solo un aviso para que revises si es correcto.

¿Los empleados pueden gestionar lotes?

No. Solo los roles Propietario y Administrador tienen acceso al módulo de lotes. Los empleados no ven la opción en el menú ni pueden acceder por URL directa.

¿Qué pasa si creo un lote con fecha de vencimiento pasada?

Se muestra una advertencia pero puedes crearlo igualmente. El lote se registrará y el sistema lo marcará como "Vencido" automáticamente.

💡 Buenas prácticas

1. Registra lotes al recibir mercadería — Hazlo desde la compra (campos de lote inline) o inmediatamente después desde el módulo de lotes.
2. Revisa el widget del dashboard — Cada día, el widget te muestra cuántos lotes vencen esta semana.
3. Usa el reporte semanal — Consulta el modo "Por vencer" cada lunes para planificar.
4. Código de lote consistente — Usa un formato estándar (ej: LOT-AAAA-NNN) para facilitar la búsqueda.
5. No ignores los indicadores rojos — Un indicador rojo en el POS significa que el stock disponible está comprometido.