Bill of Materials

Overview

A Bill of Materials (BOM) is the recipe for a finished item — it lists every component, raw material, and packaging element needed to produce one unit of the output product, along with the exact quantity of each.

When an Assembly Order is created, the system reads the BOM attached to the finished item to know which components to consume from stock. Getting the BOM right means your stock deductions and production cost calculations are accurate.

The page is found at Inventory Management → Bill of Materials.

---

The BOM List

The list shows one BOM per row — each BOM is tied to exactly one finished item.

Column	Description
Name	The BOM's descriptive name (e.g. "BOM for Golden Amber Eau de Parfum 100ml")
Item name	The finished item this BOM produces
Item number	The item code of the finished item
Component count	How many distinct component lines this BOM contains
Unit of measure	The unit in which the finished item is counted when produced (e.g. pcs)

Toolbar

Button	Description
+ New	Open the Create BOM form
Archived bill of materials	View and restore previously archived BOMs
Archive	Archive the selected BOM (only active when a BOM is selected)
Refresh	Reload the list

---

BOM Structure

Each BOM has two parts: a header that identifies the finished item and output unit, and a components section that lists everything needed to produce one unit of it.

One BOM per item

Each item can have at most one active BOM. If you try to create a BOM for an item that already has one, the system will block it. To replace a BOM, archive the old one first, then create a new one.

---

Creating a BOM

1. Select + New in the toolbar.
2. Fill in the General information:
   • Name (required) — a descriptive label for this BOM. Maximum 150 characters. Tip: naming it after the finished item makes the list easy to scan (e.g. BOM for Golden Amber EDP 100ml).
   • Description (optional) — additional context, such as a version note (e.g. Version 02 — reduced alcohol ratio).
   • Item (required) — select the finished item this BOM produces. The item must exist and must not already have an active BOM.
   • Unit of measure (required) — select the specific unit in which the finished item is produced (e.g. Pieces, Litres). This is the output unit used by assembly orders when you specify how many to produce.
3. In the Components section, select + Add component and fill in each row:
   • Component item — the raw material, ingredient, or packaging item consumed.
   • Quantity — how much of this component is needed to produce one unit of the finished item. Must be greater than 0.
   • Unit of measure — the specific unit for this component's quantity (e.g. mL, pcs, g).
4. Repeat step 3 until all components are added.
5. Select Save.

warning

A BOM must have at least one component line. Saving with an empty components section is not allowed.

Example — BOM for Golden Amber Eau de Parfum 100ml

Al Baraka's production team creates the following BOM:

Header:

Field	Value
Name	BOM for Golden Amber Eau de Parfum 100ml
Description	Standard formula v3
Item	PERF-LUX-002 — Golden Amber Eau de Parfum 100ml
Unit of measure	Pieces

Components:

Component item	Quantity	Unit
BASE-001 — Perfumers Alcohol	80	mL
EO-CITRUS-001 — Bergamot Essential Oil	10	mL
BTL-GLASS-002 — Glass Bottle 100ml Amber	1	pcs
CAP-002 — Gold Aluminum Cap Luxury	1	pcs
BOX-002 — Gift Box Large (100ml)	1	pcs

When an assembly order is raised to produce 200 pcs, the system deducts: 16,000 mL alcohol, 2,000 mL oil, 200 bottles, 200 caps, and 200 boxes.

---

Editing a BOM

The BOM header (Name, Description, Unit of measure) and the component lines are updated separately.

Updating the header

1. Select the BOM from the list.
2. Select Edit in the toolbar.
3. Update Name, Description, or Unit of measure as needed.
4. Select Save.

ملاحظة

The Item (finished product) cannot be changed after creation. If you need to reassign a BOM to a different item, archive this BOM and create a new one.

Updating components

The components section is edited directly in the detail view:

• To add a component: Select + Add component and fill in the new row.
• To delete a component: Select the checkbox next to the row(s) you want to remove, then select Delete selected.
• To change a quantity or unit: Edit the value directly in the row.
• Select Save after making changes.

warning

Changing component quantities or units takes effect immediately for any future assembly orders. Assembly orders that have already been processed are not retroactively affected.

---

Archiving a BOM

Archiving removes the BOM from use in new assembly orders while preserving all historical records and already-processed orders.

1. Select the BOM from the list.
2. Select Archive in the toolbar.
3. Confirm.

Once archived, the finished item is no longer available for assembly — a new BOM must be created and saved before assembly orders can be raised for that item again. To view and restore archived BOMs, select Archived bill of materials in the toolbar.

---

Validation Rules

BOM header

Field	Rule
Name	Required · Maximum 150 characters
Item	Required · Must be an existing item · Item must not already have an active BOM
Unit of measure	Required · Must be an existing unit of measure

Component lines

Field	Rule
Component item	Required · Must be an existing item
Quantity	Required · Must be greater than 0
Unit of measure	Required · Must be an existing unit of measure
Minimum lines	At least one component line is required

---

Planning Your BOMs

A few practices that keep production accurate:

Practice	Why it matters
Match quantities to one output unit	Always define component quantities for producing exactly one finished unit (e.g. 80 mL of alcohol per 1 bottle). The system scales automatically when you produce more.
Use the correct unit per component	Use volumetric units (mL, L) for liquids and count units (pcs) for discrete parts. Mixing up units leads to incorrect stock deductions.
Version by archiving	When a formula changes, archive the old BOM and create a new one with a version note in the description. This keeps a clean history of which formula was in use at any point.
Include all packaging	Every box, label, cap, and insert that is consumed during production should be a component line — not just the raw ingredients. This keeps packaging stock accurate.