Inventario y Control Multi-Bodega

El inventario es el corazón de tu operación. vXeller maneja un sistema de stock sofisticado que evita sobreventas, controla disponibilidad real y soporta múltiples depósitos. Esta guía cubre todo lo que necesitas saber para manejar tu inventario con precisión.

Conceptos Básicos de Stock

Cada registro de stock en vXeller maneja tres cantidades:

Campo	Significado
stock_ingresado	Cantidad física que ingresaste al sistema
stock_comprometido	Cantidad reservada por pedidos confirmados
stock_disponible	Lo que se puede vender = ingresado − comprometido

Fórmula clave: stock_disponible = stock_ingresado − stock_comprometido

El sistema impide vender stock que ya está comprometido. Si tienes 10 unidades y 3 reservadas, solo puedes vender 7 más.

Multi-Bodega

vXeller soporta múltiples bodegas (depósitos). Cada bodega puede tener:

• Nombre y dirección
• Estado (activa/inactiva)
• Bodega por defecto — la que se usa cuando no hay asignación específica

Asignación de Bodegas

• Por cliente — un cliente B2B puede tener una bodega preferida con prioridad.
• Por canal — un canal de venta puede estar vinculado a una bodega específica.
• Por punto de retiro — cada punto de retiro puede tener su propia bodega.

Stock por Bodega

El stock se lleva por combinación bodega + producto + variación. Esto significa que el mismo producto puede tener stock diferente en cada depósito.

Ejemplo

Producto	Bodega Buenos Aires	Bodega Córdoba
Remera M Rojo	15 unidades	8 unidades
Remera L Azul	0 unidades	12 unidades

Control de Stock

Ajuste Manual

• Ve a Inventario → Stock.
• Selecciona la bodega y el producto.
• Ajusta la cantidad.
• El sistema registra un movimiento de inventario con tipo, cantidad y nota.

Prevención de Sobreventa

El sistema no permite reducir el stock por debajo de lo comprometido. Si intentas ajustar un producto que tiene reservas, el sistema te avisará.

Reserva de Stock

Al confirmar un pedido, el stock se reserva automáticamente:

• Las cantidades pasan a stock_comprometido.
• El stock_disponible disminuye.
• Si el pedido se cancela, se libera la reserva.

Alertas de Stock

vXeller monitorea tu inventario y te avisa cuando:

• Stock bajo — un producto cae por debajo de un umbral configurable.
• Stock negativo — algo falló (revisar movimientos recientes).

Las alertas aparecen en el Dashboard y en la sección de Inventario.

Reservas de Stock y Expiración

Las reservas pueden expirar si el pedido no se completa (por ejemplo, pedido manual no pagado). vXeller tiene un job automático que:

1. Revisa reservas vencidas.
2. Libera el stock comprometido.
3. El stock vuelve a estar disponible para venta.

También puedes liberar manualmente con:

POST /stock/release-expired

Movimientos de Stock (Auditoría)

Cada cambio de stock deja un movimiento registrado con:

• Producto, bodega y variación afectada
• Cantidad (delta positivo o negativo)
• Tipo de movimiento (ajuste manual, transferencia, venta, devolución)
• Nota descriptiva
• Fecha y hora
• Bodega destino (en caso de transferencia)

Los movimientos son la traza de auditoría de tu inventario. Puedes consultar el historial por producto, bodega o variación.

Transferencias entre Bodegas

Las solicitudes de transferencia mueven inventario de una bodega origen a una destino:

1. Crear solicitud con origen, destino y cantidad.
2. Estados: pendiente → recibida (o cancelada).
3. Al recibirse, el stock se descuenta de origen y se suma a destino.

Transferencia Automática

Existe un caso especial: cuando un pedido con retiro en un punto que maneja stock propio no puede cubrirse con el stock del punto, el sistema genera automáticamente una transferencia pendiente desde la bodega del cliente hacia la bodega del punto de retiro.

Maestro de Stock por Canal

Cada canal de venta puede tener definido quién es el "maestro" del stock:

• vXeller — el stock se controla desde el panel.
• Canal externo — el stock se sincroniza desde el marketplace.

La sincronización de stock con canales ocurre cada 5 minutos.

Consejos

1. Define siempre una bodega por defecto. Evita errores de asignación.
2. Revisa las alertas de stock diariamente. Un faltante no detectado a tiempo es una venta perdida.
3. Usa transferencias para balancear stock entre depósitos antes de campañas grandes.
4. No ignores las reservas expiradas. Libéralas manualmente si el job automático no cubre tu caso.
5. Audita movimientos cada vez que haya una discrepancia física vs. sistema.