Designing a bill of materials and checking it fits
Open Inventory, Items, then the Bills of materials pill at the top of the page. A bill of materials (BOM) belongs to one item — the thing it makes — and lists its components and how many of each it takes. You choose the item, an optional name (the item’s name is used if blank), and the output quantity: how many units one run of the list makes — 1 for a single product, 12 for a recipe that makes a batch of 12 bottles, with each component’s quantity then what the whole batch takes. A BOM is active or archived, and only an active one can be built from. An item cannot be a component of itself, and a component that is itself made with the finished item is refused, so a list can never loop; components can have BOMs of their own, but each sub-assembly is built on its own order first. Editing a BOM changes future orders only, so a recipe change mid-week does not rewrite Monday’s order, and the BOM page shows today’s cost of one finished unit from current component costs.
A build respects each component’s own unit of measure. A component counted in pieces, bottles, cartons, bags or any other count unit must come to a whole number; one measured in kilograms, grams, litres, millilitres, metres or another measured unit takes up to three decimal places. A quantity that would need a fraction of a count-unit component — half a bottle, a third of a sack — cannot be built or issued, and the page names the component; it is never rounded. The fix is a quantity that uses whole units of every counted component, or an output quantity that makes the arithmetic whole, and the finished item follows the same rule. Before you build, enter a quantity and a warehouse and choose Check stock: for each component it shows what that quantity needs, what is on the shelf at that warehouse, and how much you are short. Builds happen at one warehouse — components are taken from, and the finished item put into, the order’s warehouse — so transfer components in from another branch first. A build also refuses stock reserved for a customer order or frozen by an open stock count, and says so plainly.
In practice: a juice maker in Thika has a BOM for Mango 500 ml with an output quantity of 12 and components of 3 litres of mango pulp, 12 bottles, 12 caps and 12 labels. At KES 220 a litre of pulp, KES 18 a bottle, KES 3 a cap and KES 4 a label, the page shows (660 + 216 + 36 + 48) ÷ 12 = KES 80 a bottle. To make 18 bottles it needs 4.5 litres of pulp — allowed, because pulp is stocked in litres — and 18 each of bottles, caps and labels; had the pulp been stocked in 5-litre jerrycans counted as pieces, 18 bottles would need 0.9 of a jerrycan and the build would be refused, naming the pulp. Check stock at the Thika warehouse shows pulp needed 4.5, on the shelf 3.2, short 1.3, so the supervisor transfers 2 litres from the Ruiru store and rechecks with no shortfall. A second BOM for a Mango gift crate lists 6 bottles of Mango 500 ml and one crate — the bottles are built first on their own order, then the crate.
Key takeaways
- A BOM belongs to the item it makes, lists components per output quantity, and only an active one can be built from.
- Loops are refused, sub-assemblies are built on their own order first, and editing a BOM affects future orders only.
- Count-unit components must come to whole numbers; measured-unit components take up to three decimals — nothing is rounded.
- Check stock shows needed, on the shelf and short at the order’s warehouse; reserved stock and stock frozen by an open count cannot be built with.