Bills of Materials
Inventory → Bills of Materials (/production/boms) holds the recipe for
each item you make or assemble in-house. A bill of materials (BOM) says:
"one batch of this item takes these components, in these quantities". For
example, one Brake Kit is made from 2 brake pads, 1 rotor and 4 bolts.
Production orders use the BOM to know which components to consume.
Versions and statuses
An item can have several versions of its BOM over time, but only one is active.
| Status | Meaning |
|---|---|
| DRAFT | Being written. Can be edited or deleted. |
| ACTIVE | The version production orders use. Read only. |
| ARCHIVED | Retired. Kept for history. |
Activating a version automatically archives the item's previous active version. To change an active recipe, create a new version and activate it.
Before you begin
inventory.production.viewopens the page;inventory.production.managelets you create, edit, activate, archive and delete. The Warehouse Manager role has both.- The made item and all of its components must exist in the Item Catalog. Set the made item's Classification to Finished goods and the components' to Raw materials so reports group them correctly.
Understanding the page
One row per BOM version:
| Column | Meaning |
|---|---|
| Item | The item made. |
| Version | v1, v2… |
| Components | What it uses, e.g. "2 × PAD-001, 1 × ROT-002". |
| Batch | How many one batch makes. |
| Est. unit cost | The estimated cost of one unit made, from the components' current costs. |
| Status | Draft, Active or Archived. |
The buttons at the end of each row are Edit and Delete (drafts only), Activate (any version that is not active) and Archive (the active version).
Create a bill of materials
- Select New bill of materials.
- Choose the Item made.
- Enter what one Batch makes — usually 1, but for example 10 if your recipe is written for ten at a time.
- Under Components for one batch, for each component choose the item, the Quantity needed for one batch, and a Scrap % if some is normally lost (for example 5 for 5% waste). Use Add component for more rows and the ✕ to remove one.
- Select Save. You see "Bill of materials saved". It is saved as a DRAFT.
- When it is right, select Activate.
Each component may appear only once (combine the quantities), and an item cannot be a component of itself.
Change a recipe
An active BOM cannot be edited. Create a new bill of materials for the same item — it becomes the next version — and activate it. The old version is archived automatically.
Archive or delete
- Archive retires a version. It is refused while open production orders (Draft or Released) still use it: "Open production orders use this bill of materials; complete or cancel them first."
- Delete removes a draft permanently, after you confirm.
Common issues
| Problem | What to check |
|---|---|
| "Only a draft bill of materials can be changed" | Create a new version instead. |
| "Each component appears once" | Merge duplicate component rows. |
| The item is not offered on a new production order | It has no ACTIVE BOM. Activate one. |
Related pages
- Production Orders — making items from this recipe.
- Item Catalog — the made item and its components.