Skip to main content

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.

StatusMeaning
DRAFTBeing written. Can be edited or deleted.
ACTIVEThe version production orders use. Read only.
ARCHIVEDRetired. 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.view opens the page; inventory.production.manage lets 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:

ColumnMeaning
ItemThe item made.
Versionv1, v2…
ComponentsWhat it uses, e.g. "2 × PAD-001, 1 × ROT-002".
BatchHow many one batch makes.
Est. unit costThe estimated cost of one unit made, from the components' current costs.
StatusDraft, 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​

  1. Select New bill of materials.
  2. Choose the Item made.
  3. Enter what one Batch makes — usually 1, but for example 10 if your recipe is written for ten at a time.
  4. 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.
  5. Select Save. You see "Bill of materials saved". It is saved as a DRAFT.
  6. 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​

ProblemWhat 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 orderIt has no ACTIVE BOM. Activate one.