How to Configure Bill of Materials and Formula in iDempiere

The Bill of Materials and Formula window lets retailers define a parent product built from multiple component products, such as a gift hamper assembled from packaged goods.

Once configured, the BOM drives inventory consumption, costing, and kitting or production transactions, ensuring component stock is accurately reduced when the parent product is sold.

Process Flow

TenthPlanet iDempiere Bill of Materials And Formula

Business Rules

  • Only Active BOM records are available for kitting or production transactions.
  • Each component line must reference an active, existing Product.
  • Component Type separates functional components from packing materials.
  • Quantity on each component line defines units consumed per one parent product.

Prerequisites

  • Parent Product (e.g., GH-001_Premium Gift Hamper) created in the Product window.
  • All component Products (Coffee Powder, Tea Pack, Chocolate Box, etc.) created and active.
  • Organization and Tenant configured for the retail store.
  • Product Category and UOM configured for the parent and component products.
  • Warehouse and Locator configured so component stock is available.

Navigation

Menu → Manufacturing → Bill of Materials and Formula

Configuration Steps

Step 1: Create the Parent Product BOM Header

Open a new record on the Parent Product tab. Select the finished Product, confirm the Search Key and Name, and mark the record Active.

FieldSample ValueDescription
ProductGH-001_Premium Gift HamperParent product being assembled
Search KeyGH-001Unique product code
NamePremium Gift HamperProduct display name shown in transactions
ActiveCheckedEnables the BOM header for use
TenthPlanet iDempiere Manufacturing BillOfMaterialAndFormula 1

Step 2: Set BOM Type and BOM Use

Set BOM Type to Current Active so this version is used for transactions. Set BOM Use to Manufacturing so components are consumed during production or kitting.

FieldSample ValueDescription
BOM TypeCurrent ActiveMarks this BOM version as the one used for transactions
BOM UseMasterDefines whether the BOM drives production, costing, or engineering
Revision(optional)Identifies the version of the recipe when it changes over time

Step 3: Add Component Lines

From the Detail record tab, add a new line for each component product. Assign an incrementing Line No (10, 20, 30…) and select the component Product.

FieldSample ValueDescription
Line No10, 20, 30…Sets the display and processing order of components
ProductCOF-250_Coffee Powder (250 g)Component product consumed in the BOM
Component TypeComponent / PackingClassifies the line as a functional item or packing material
TenthPlanet iDempiere Manufacturing BillOfMaterialAndFormula 2

Step 4: Define Component Line Details

Open each component line and set the Quantity required per parent unit. Mark the Component Type as Packing for wrapping or presentation items, then save the line.

FieldSample ValueDescription
BOM FormulaGH-001_Premium Gift HamperParent BOM this component line belongs to
ProductCOF-250_Coffee Powder (250 g)Component product for this line
Component TypeComponentIdentifies this as a functional hamper item
Quantity1.0Units of the component consumed per parent product
ActiveCheckedEnables the line for transaction processing
TenthPlanet iDempiereManufacturing BillOfMaterialAndFormula 3

Common Issues and Resolutions

IssueCauseResolution
Component product not found in searchProduct is not Active or in the wrong categoryVerify the Product is Active and saved before adding it to the BOM
Incorrect stock consumption after productionWrong Quantity entered on a component lineReview and correct the Quantity value on each component line

Next Steps

  • Configure the Production Order / Work Order window to process the BOM.
  • Set up Warehouse and Locator records for component stock availability.
  • Review Product Costing for the parent product based on component costs.
  • Configure Replenishment settings for component reorder points.