Inventario

El módulo de Inventario gestiona los productos físicos de cada sucursal. Cada producto tiene un stock por sucursal y todo cambio queda registrado en un kardex inmutable. Los “Productos” del Catálogo (tutorial 10) son exactamente estos ítems de inventario: comparten el mismo formulario.

Nota sobre multi-sucursal: los productos, sus categorías y su stock se manejan por sucursal. El mismo producto en dos sucursales son dos registros con stock independiente. Cambia de sucursal en la barra superior antes de operar.

1. Ver y buscar productos

La lista muestra tus productos en una tabla con badges de estado de stock.

Pasos:

1. Entra a Inventario (o Catálogo → Productos).
2. Filtra por categoría (píldoras de colores) o activa el interruptor “Stock bajo” para ver solo los que necesitan reabastecerse.
3. Usa el buscador “Buscar por nombre, SKU…”.

Columnas de la tabla:

Badges de stock: 🔴 Sin stock (stock ≤ 0) · 🟡 Stock bajo (stock ≤ mínimo) · 🟢 En stock.

Acciones por fila (menú ”…”): Editar · Ajustar Stock · Ver Kardex · Desactivar. Con solo permiso de lectura, únicamente aparece Ver Kardex.

2. Crear o editar un producto

Pulsa “Nuevo Producto” (permiso inventory:create). Se abre un diálogo con dos columnas.

Columna izquierda:

Columna derecha:

Clasificación contable (define la cuenta y si se puede vender):

• Mercadería para venta — entra al inventario de mercadería y puede venderse en POS y facturación.
• Insumo / suministro interno — consumo interno. No vendible.
• Activo fijo (no corriente) — se capitaliza; no se vende ni es gasto.

Configuración de venta (solo si la clasificación es Mercadería):

• Producto vendible al cliente (casilla). Al desmarcarlo se limpian el precio de venta y la exención.
• Precio de venta ($) — obligatorio y mayor que 0 si es vendible.
• Exento de IVA — se factura como venta exenta (sin el 13 %).

Otras opciones:

• Registrar fecha de vencimiento — si lo activas, al recibir mercancía se exige la fecha de caducidad por lote y el producto aparece en las alertas de “próximos a vencer”. Actívalo para productos perecederos; desactívalo para papelería o herramientas.

Validaciones: Nombre, Categoría y Unidad son obligatorios; costo ≥ 0; Stock Máximo ≥ Stock Mínimo; solo la mercadería puede ser vendible; un producto vendible exige precio de venta > 0; el SKU es único por sucursal.

Desactivar un producto (menú ”…” → Desactivar): lo saca de las listas pero conserva su historial y kardex (no se elimina). Requiere inventory:update.

3. Ajustar stock

Corrige manualmente el stock (conteo físico, daño, error de registro).

Pasos:

1. En el menú ”…” del producto, elige “Ajustar Stock”.
2. El diálogo muestra el Stock actual.
3. Escribe la Cantidad del ajuste (positiva suma, negativa resta; usa los botones −/+ o el campo numérico).
4. Verás el Stock proyectado con color (rojo si quedaría negativo, amarillo si ≤ mínimo, verde si ok).
5. Escribe la Razón del ajuste (obligatoria; ej. “Conteo físico, producto dañado…”).
6. Pulsa “Confirmar Ajuste”.

Validaciones: la cantidad no puede ser 0, la razón es obligatoria y el stock resultante no puede quedar negativo (si falta, verás “Stock insuficiente. Disponible: X”). El ajuste genera un movimiento de kardex tipo Ajuste. Requiere inventory:update.

4. Kardex (movimientos)

El kardex es el historial completo e inmutable de todos los movimientos de un producto.

Pasos:

1. En el menú ”…” del producto, elige “Ver Kardex”.
2. Arriba verás Stock Actual, Stock Mínimo, Stock Máximo y Costo Unitario (con aviso si el stock está por debajo del mínimo).

Columnas de la tabla de movimientos:

5. Dashboard de inventario

Ruta: Inventario → Dashboard. Vista general del estado del inventario.

Contenido:

• Tarjetas KPI: Alertas Activas (con conteo de críticas/advertencias), Items con Stock Bajo, Próximos a Vencer, Valor Total del inventario.
• Alertas Críticas: lista con severidad (badge “Sin stock” / “Crítico”).
• Sugerencias de Reorden (top 5): producto, “Stock: X / Mín: Y”, cantidad sugerida y costo estimado.
• Botón “Actualizar” para refrescar las alertas.

Tipos de alerta: sin stock, stock bajo (stock ≤ mínimo), por vencer y vencido (lotes que caducan en los próximos 30 días, solo en productos con “Registrar fecha de vencimiento” activo).

6. Categorías de productos

Ruta: Inventario → Categorías (o Catálogo → Cat. Productos). Organiza el catálogo con color y orden.

Pasos:

1. Pulsa “Nueva Categoría”.
2. Completa Nombre *, Descripción, Color (hex) y Orden.
3. Guarda.

El Código se deriva del nombre al crear y no se puede modificar después. La categoría “Sin Categoría” está protegida (no se elimina ni renombra); al desactivar otra categoría, sus productos se reasignan a “Sin Categoría”. Crear/editar requiere inventory:create / inventory:update.

7. Proveedores

Ruta: Inventario → Proveedores. “Gestión de proveedores de insumos”.

Pasos:

1. Pulsa “Nuevo Proveedor” (permiso inventory:create).
2. Completa el formulario:

3. Guarda. Puedes Editar o Desactivar desde el menú de cada fila (permiso inventory:update).

8. Reportes de inventario

Ruta: Inventario → Reportes (permiso inventory:read). Cuatro pestañas:

• Rotación — por categoría: Items, Valor Total, Stock Bajo, Sin Stock.
• Vencimientos — lotes por vencer: Producto, SKU, Lote, Cantidad, fecha, Días (badge “Vencido” si ya pasó), Valor en Riesgo.
• Top Ventas — filtrable por rango de fechas: Producto, SKU, Vendidos, Ingresos, Costo, Margen (%).
• Reconciliación OC — órdenes recibidas y si cada una tiene su gasto/factura registrada (control para el F-07).