Qué resuelve
Ingredientes administra los insumos que participan en el control de stock y en composiciones/BOM cuando el negocio tiene habilitado inventory_bom.
No es el catálogo comercial de Productos. Un ingrediente representa un insumo operativo; un producto representa lo que vendés.
Qué muestra la pantalla
La lista trabaja con 25 registros por página y expone un resumen con:
- cantidad total de ingredientes;
- valor total del stock;
- cantidad con stock bajo.
También permite buscar por nombre y filtrar por marca.
Cambiar la búsqueda reinicia la paginación y vuelve a consultar el servidor con un pequeño debounce.
Crear un ingrediente
Campos disponibles:
| Campo | Regla |
|---|---|
| Nombre | Obligatorio |
| Unidad base | g, kg, ml, L o unidades |
| Costo unitario | Numérico; si queda vacío se registra 0 |
| Umbral de stock bajo | Opcional; si queda vacío no se define umbral específico |
| Marca | Opcional |
La unidad base es crítica para recetas y consumo. No mezcles gramos con kilos sin una conversión deliberada.
Unidades
La interfaz representa:
- GRAMOS → g
- KILOS → kg
- MILILITROS → ml
- LITROS → L
- UNIDADES → u
Elegí la unidad que realmente usa el inventario del insumo.
Costo unitario
El costo forma parte del valor económico del stock y puede alimentar cálculos de costos/BOM. No uses el precio de venta del producto como costo del ingrediente.
Stock bajo
El umbral de stock bajo define cuándo el ingrediente debe considerarse bajo en stock. El resumen de la pantalla cuenta esos casos para facilitar el abastecimiento.
La alerta no significa que haya que comprar automáticamente: es una señal para revisar consumo y abastecimiento.
Marca
La marca es un dato opcional que sirve para clasificar y filtrar ingredientes. El filtro se alimenta de las marcas disponibles en el tenant.
Edición y baja
La pantalla permite editar ingredientes y gestionar su estado. Las operaciones usan diálogos de aplicación, no prompts nativos del navegador.
Antes de desactivar o eliminar un insumo revisá si participa en recetas/BOM activas: cambiar el insumo puede afectar consumos futuros.
Relación con Compras
Compras puede recibir ingredientes directamente cuando el modelo de stock del negocio trabaja con insumos. Una recepción incrementa el stock del ingrediente correspondiente.
En un modelo híbrido pueden convivir recepciones de productos y de ingredientes.
Relación con Productos y recetas
Un producto gastronómico puede consumir ingredientes mediante una receta/BOM. La cantidad y unidad deben ser coherentes con la unidad base del insumo.
Si el costo o stock parece incorrecto, diagnosticá primero el ingrediente y después la receta que lo consume.
Diagnóstico
No aparece un ingrediente: limpiá el filtro de marca y revisá la búsqueda.
El stock bajo parece incorrecto: revisá unidad base y umbral.
El costo total no coincide: verificá costo unitario y cantidades recibidas.
No puedo entrar: el módulo está gateado por inventory_bom; revisá plan/capability antes de asumir un error de datos.