23 de abril de 2026
Inventario y producción
Guía para entender materias primas, lotes, productos compuestos, reservas, movimientos y conflictos de inventario en Ballista.
Inventario y producción explica cómo Ballista ayuda a responder una pregunta sencilla y crítica: qué se puede prometer sin vender a ciegas. El módulo conecta materias primas, lotes, productos compuestos, variantes, reservas y reportes para que ventas, producción y gerencia trabajen con la misma información.
La idea central es esta: inventario no es solo una cantidad disponible. Es evidencia de origen, costo, vencimiento, unidad, impuesto, movimiento y uso dentro de pedidos. Cuando esos datos están claros, el negocio puede comprar a tiempo, producir con menos fricción y explicar por qué un pedido se puede o no se puede cumplir.
Rutas del Flujo
| Ruta | Qué administra | Uso principal |
|---|---|---|
/materia_prima | Materias primas e insumos base. | Mantener nombre, costo, unidad, impuesto y estado de cada insumo. |
/lote_producto | Lotes con cantidad y trazabilidad. | Registrar entradas, vencimientos, cantidad actual, CABYS cuando aplica y estado del inventario disponible. |
/producto_compuesto | Productos preparados desde fórmulas. | Definir recetas, componentes y estructura de producción. |
/producto_compuesto_variacion | Presentaciones vendibles. | Manejar precio, presentación y disponibilidad comercial. |
/cotizador | Prueba comercial antes de ordenar. | Simular una venta sin comprometer todavía el flujo formal de pedido. |
/reports | Lectura agregada. | Revisar materiales más usados, conflictos y costos. |
Antes de Operar
Inventario funciona mejor cuando los datos base ya están limpios. Antes de crear pedidos con inventario disponible, revisa:
| Dato | Por qué importa |
|---|---|
| Unidades | Evitan mezclar gramos, mililitros, unidades y presentaciones sin criterio. |
| Impuestos | Permiten qué pedidos y facturación calculen líneas sin correcciones manuales. |
| Materias primas | Son el insumo que luego aparece en lotes y fórmulas. |
| Lotes | Dan cantidad real, costo, vencimiento y trazabilidad. |
| Productos compuestos | Explican qué insumos se consumen al vender una presentación preparada. |
| Variantes | Representan lo que realmente se vende: tamaño, presentación, precio y fórmula. |
Si falta alguno de estos datos, el problema suele aparecer más tarde en Crear pedido: no aparece un lote, no se puede calcular impuesto, el producto compuesto no tiene componentes o el inventario disponible no alcanza.
Materias Primas
Una materia prima es el insumo base que el negocio compra, almacena o usa para preparar productos. En Ballista debería responder:
| Pregunta | Dato esperado |
|---|---|
| ¿Qué es? | Nombre y descripción del insumo. |
| ¿Cómo se mide? | Unidad de inventario. |
| ¿Cuánto cuesta? | Costo unitario o referencia de costo. |
| ¿Cómo tributa? | Impuesto de venta cuando aplica. |
| ¿Está disponible? | Estado activo/inactivo según operación. |
La materia prima no dice por sí sola cuánto inventario disponible existe. Para eso están los lotes. Mantener esta separación evita que el catálogo se mezcle con movimientos de inventario.
Lotes
Un lote es una existencia concreta. Puede venir de una compra, una entrada manual, una producción o una corrección controlada. El lote permite explicar de dónde salió una unidad, cuánto queda y si todavía conviene usarla.
| Campo | Lectura operativa |
|---|---|
| Material/producto | Qué insumo o producto representa el lote. |
| Número de lote | Referencia para soporte, auditoría o trazabilidad. |
| Fecha de compra/entrada | Cuándo ingresó el inventario disponible. |
| Vencimiento | Cuándo deja de ser recomendable usarlo. |
| Cantidad inicial | Cuánto entró originalmente. |
| Cantidad actual | Cuánto queda después de reservas, salidas o ajustes. |
| Precio/costo | Base para margen, reposición y reportes. |
| Estado | Si el lote está activo, agotado, bloqueado o no debería usarse. |
La cantidad actual es la que más afecta pedidos. Si una orden intenta usar más de lo disponible, Ballista debe bloquear el flujo o reportar conflicto antes de prometer entrega.
Productos Compuestos
Un producto compuesto es una receta o kit. Une varios insumos para crear algo vendible: una presentación preparada, un paquete, una fórmula o un producto terminado.
| Concepto | Qué significa |
|---|---|
| Producto base | Nombre general del producto preparado. |
| Componentes | Materias primas que forman la receta. |
| Cantidades | Cuánto consume cada componente por unidad producida o vendida. |
| Variantes | Presentaciones vendibles con precio y datos comerciales. |
| Costo estimado | Suma o referencia de insumos usados por la fórmula. |
Cuando un pedido vende una variante compuesta, Ballista debe convertir la cantidad vendida en consumo de componentes. Si el producto requiere 0.5 unidades de A y se venden 4, el sistema necesita reservar 2 unidades de A desde lotes disponibles.
Cómo Impacta un Pedido
En Crear pedido, una línea puede salir de dos fuentes:
| Fuente | Qué pasa con inventario |
|---|---|
Lot | El pedido usa un lote específico y rebaja su current_quantity. |
Compound product | El servidor lee la fórmula, busca lotes por componente y descuenta las cantidades necesarias. |
Ese descuento debe ser transaccional. Si falta inventario disponible, impuesto, lote o componente, la orden completa debe fallar. Es preferible no crear el pedido que dejar una venta sin inventario suficiente o con trazabilidad incompleta.
Movimientos y Reservas
Una reserva significa que el inventario disponible queda comprometido por una orden. No es una nota decorativa: reduce disponibilidad para que otro pedido no prometa el mismo lote.
| Movimiento | Cuándo aparece | Qué debería explicar |
|---|---|---|
| Entrada | Compra, carga inicial o producción terminada. | Por qué subió el inventario disponible. |
| Reserva/salida | Pedido creado o consumo confirmado. | Qué orden usó el inventario disponible. |
| Ajuste | Corrección autorizada. | Quién corrigió y por qué. |
| Liberación | Pedido cancelado o reversión soportada. | Qué inventario disponible vuelve a estar disponible. |
Si el negocio necesita auditoría fina, cada movimiento debe incluir usuario, fecha, referencia y motivo. Sin eso, el inventario vuelve a depender de memoria.
Conflictos Comunes
| Problema | Causa probable | Dónde revisar |
|---|---|---|
| No aparece un lote en Pedidos. | Lote inactivo, agotado o sin datos mínimos. | /lote_producto |
| La cantidad no alcanza. | Otro pedido consumió inventario disponible o la cantidad actual está desactualizada. | Lote, movimientos y pedidos recientes. |
| Producto compuesto no se puede vender. | Falta variante, fórmula o componente. | /producto_compuesto y variantes. |
| Impuesto no se resuelve. | Materia prima o lote sin impuesto de venta. | Materias primas e impuestos. |
| Reporte de costos no cuadra. | Costos incompletos o movimientos no registrados. | Lotes, costos unitarios y descargas de reportes. |
| Se prometió entrega imposible. | Pedido creado sin revisar disponibilidad real. | Pedidos, Inventario y conflictos en Reportes. |
Flujo Recomendado
- Configurar unidades e impuestos.
- Crear materias primas.
- Registrar lotes con cantidad, costo y vencimiento.
- Crear productos compuestos solo cuando la receta esté clara.
- Crear variantes vendibles con precio y presentación.
- Revisar disponibilidad antes de prometer pedidos.
- Crear la orden desde
/orders. - Resolver conflictos de inventario disponible antes de facturar o entregar.
- Revisar materiales usados y conflictos en
/reports.
Para Soporte
Cuando reportes un problema de inventario, incluye:
- ruta exacta:
/materia_prima,/lote_producto,/producto_compuesto,/orderso/reports; - material, lote, producto compuesto o variante afectada;
- cantidad esperada y cantidad visible;
- pedido relacionado, si existe;
- fecha de vencimiento o número de lote si aplica;
- mensaje de validación o conflicto mostrado;
- si el problema aparece al crear pedido, revisar reporte o editar catálogo.
Cómo se Conecta
Inventario se conecta con Pedidos y ventas, porque las líneas de pedido consumen lotes o productos compuestos. También se conecta con Reportes y decisiones, porque materiales usados, costos y conflictos explican capacidad operativa. Cuando un cambio de inventario disponible o fórmula puede afectar pedidos reales, usa Cambios seguros para reportarlo con contexto.
Resumen
Inventario y producción ayudan a prometer con realidad. La wiki debe enseñar qué existe, qué queda disponible, qué fórmula consume cada producto, qué pedido reservó inventario disponible y dónde revisar cuando algo no cuadra.