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

RutaQué administraUso principal
/materia_primaMaterias primas e insumos base.Mantener nombre, costo, unidad, impuesto y estado de cada insumo.
/lote_productoLotes con cantidad y trazabilidad.Registrar entradas, vencimientos, cantidad actual, CABYS cuando aplica y estado del inventario disponible.
/producto_compuestoProductos preparados desde fórmulas.Definir recetas, componentes y estructura de producción.
/producto_compuesto_variacionPresentaciones vendibles.Manejar precio, presentación y disponibilidad comercial.
/cotizadorPrueba comercial antes de ordenar.Simular una venta sin comprometer todavía el flujo formal de pedido.
/reportsLectura 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:

DatoPor qué importa
UnidadesEvitan mezclar gramos, mililitros, unidades y presentaciones sin criterio.
ImpuestosPermiten qué pedidos y facturación calculen líneas sin correcciones manuales.
Materias primasSon el insumo que luego aparece en lotes y fórmulas.
LotesDan cantidad real, costo, vencimiento y trazabilidad.
Productos compuestosExplican qué insumos se consumen al vender una presentación preparada.
VariantesRepresentan 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:

PreguntaDato 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.

CampoLectura operativa
Material/productoQué insumo o producto representa el lote.
Número de loteReferencia para soporte, auditoría o trazabilidad.
Fecha de compra/entradaCuándo ingresó el inventario disponible.
VencimientoCuándo deja de ser recomendable usarlo.
Cantidad inicialCuánto entró originalmente.
Cantidad actualCuánto queda después de reservas, salidas o ajustes.
Precio/costoBase para margen, reposición y reportes.
EstadoSi 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.

ConceptoQué significa
Producto baseNombre general del producto preparado.
ComponentesMaterias primas que forman la receta.
CantidadesCuánto consume cada componente por unidad producida o vendida.
VariantesPresentaciones vendibles con precio y datos comerciales.
Costo estimadoSuma 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:

FuenteQué pasa con inventario
LotEl pedido usa un lote específico y rebaja su current_quantity.
Compound productEl 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.

MovimientoCuándo apareceQué debería explicar
EntradaCompra, carga inicial o producción terminada.Por qué subió el inventario disponible.
Reserva/salidaPedido creado o consumo confirmado.Qué orden usó el inventario disponible.
AjusteCorrección autorizada.Quién corrigió y por qué.
LiberaciónPedido 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

ProblemaCausa probableDó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

  1. Configurar unidades e impuestos.
  2. Crear materias primas.
  3. Registrar lotes con cantidad, costo y vencimiento.
  4. Crear productos compuestos solo cuando la receta esté clara.
  5. Crear variantes vendibles con precio y presentación.
  6. Revisar disponibilidad antes de prometer pedidos.
  7. Crear la orden desde /orders.
  8. Resolver conflictos de inventario disponible antes de facturar o entregar.
  9. Revisar materiales usados y conflictos en /reports.

Para Soporte

Cuando reportes un problema de inventario, incluye:

  • ruta exacta: /materia_prima, /lote_producto, /producto_compuesto, /orders o /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.