SmartERP Documentation An Ashewa Technology Solutions Platform

Configure Multi-Level Bills of Materials (BoMs)

Procedural guide for configuring single-level, multi-level, phantom kits, and subcontracted BoMs.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Configure Multi-Level Bills of Materials (BoMs) within SmartERP.

Cost roll-up diagram showing aggregation of raw materials, direct labor, and machine overhead into unit product cost.
Multi-level Bill of Materials cost roll-up and inventory valuation.

Bill of Materials Multi-Level Component Structure

Procedural guide for configuring single-level, multi-level, phantom kits, and subcontracted BoMs.

2. Prerequisites & Security Access Groups#

  • Required Modules: mrp, quality_control, smarterp_manufacturing_costing
  • Security Groups:
    • Manufacturing User (Technical ID: mrp.group_mrp_user)
    • Manufacturing Administrator (Technical ID: mrp.group_mrp_manager)
    • Quality Inspector (Technical ID: quality.group_quality_user)
  • Master Data Dependencies: Bills of Materials (BoM), routing operations, work centers with machine/labor hourly rates, raw material stock, and inspection checkpoints.

3. Step-by-Step Configuration & Execution#

Step 1: Navigating to the Interface#

  1. Log into your SmartERP instance at https://smarterp.et/odoo.
  2. Open the main App Switcher (grid icon in the top-left corner).
  3. Navigate to Manufacturing → Products → Bills of Materials.

Bill of Materials Multi-Level Component Structure

Step 2: Operational Data Parameters & Controls#

Ensure all mandatory parameters comply with enterprise operational standards:

  • Authorized Operator: Action executed under assigned RBAC permissions (Product Design Engineer, Cost Accountant).
  • Relational Integrity: Linked to upstream customer, product, inventory lot, or manufacturing order.
  • Statutory & Quality Controls: Verified against Ethiopian commercial and tax regulations or technical engineering specifications.

Step 3: Operational Execution & State Progression#

  • State Progression Gate: Advance record from Draft through Confirmed to Completed / Posted.
  • Integrated System Impact: Automatically updates inventory stock quants, customer receivables, or work-in-progress cost accounting ledgers.
  • Audit Verification: System registers tamper-evident audit records logging user ID, timestamp, and cryptographic transaction digests.

Overview of BoM Types in SmartERP#

SmartERP supports four distinct Bill of Materials structures:

  1. Standard Manufacturing BoM (mrp.bom type normal): Used when the product is built on the factory floor with designated work orders, component consumption, and finished goods output.
  2. Phantom / Kit BoM (mrp.bom type phantom): Used for kits or bundles that are not pre-assembled in production but rather picked together during delivery or used as non-stock sub-assemblies.
  3. Subcontracting BoM (mrp.bom type subcontract): Used when raw materials are shipped to an external vendor who returns the completed assembly.
  4. Co-Product BoM: Used in process industries where a single production run yields multiple distinct saleable commodities.

Procedure: Creating a Multi-Level BoM#

Step 1: Create Sub-Assembly BoMs First#

When manufacturing complex machinery or processed foods, always define lower-level sub-assemblies before defining the parent product:

  1. Navigate to Manufacturing > Products > Bills of Materials.
  2. Click New.
  3. Product: Electric Motor Sub-Assembly 5HP.
  4. Add components:
    • Copper Magnet Wire: 4.2 kg
    • Steel Stator Core: 1 unit
    • Rotor Shaft 25mm: 1 unit
    • Ball Bearings 6205: 2 units
  5. Save the sub-assembly BoM.

Step 2: Create the Parent BoM#

  1. Click New in Bills of Materials.
  2. Product: Industrial Centrifugal Pump Unit.
  3. Under the Components tab:
    • Add Electric Motor Sub-Assembly 5HP (Quantity: 1).
    • Add Cast Iron Impeller Casing (Quantity: 1).
    • Add Mechanical Face Seal (Quantity: 1).
    • Add Mounting Base Plate & Bolts (Quantity: 1).
  4. Select the line for Electric Motor Sub-Assembly 5HP. Set the Manufacturing Readiness rule:
    • Manufacture on Demand (MTO): Auto-generates a child MO when the parent pump MO is confirmed.
    • Take from Stock: Consumes available motor stock; generates an alert if insufficient.
Cost roll-up diagram showing aggregation of raw materials, direct labor, and machine overhead into unit product cost.
Multi-level Bill of Materials cost roll-up and inventory valuation.

Component Scrap and Spoilage Margins#

In industrial cutting, stamping, or chemical blending, raw material loss is unavoidable:

  • In the BoM component line, expand Component Details.
  • Set Scrap Margin (%): For example, 3.5% on steel sheet cutting.
  • When an MO for 100 units is confirmed, SmartERP automatically reserves 100 * 1.05 * 1.035 = 108.68 units of raw material, ensuring accurate material reservation without manual recalculation.

BoM Versioning and Engineering Change Orders (ECO)#

To maintain compliance with ISO 9001 quality audits:

  • Never overwrite active BoMs currently tied to open manufacturing orders.
  • Navigate to Manufacturing > Products > Engineering Change Orders (ECO).
  • Create an ECO to propose component substitutions, update routing run-times, and route for Engineering Director and Cost Accountant sign-off.

4. Advanced Configuration Points#

  • Automated Actions & Scheduled Tasks (Crons):
    • MRP: Recalculate BoM standard costs (mrp.ir_cron_bom_cost_roll): Runs weekly to update standard costing from latest procurement purchase prices
    • Quality: Trigger periodic inspection alerts (quality.ir_cron_inspection_check): Runs daily to flag mandatory quality testing queues
    • Workcenter: Update OEE statistics (mrp.ir_cron_workcenter_oee): Runs hourly to compute Overall Equipment Effectiveness metrics
  • Custom Print Templates & Reports:
    • Production Order Traveler & Pick List
    • Shop Floor Work Order Execution Slip
    • Quality Inspection Certificate & Non-Conformance Report
    • Manufacturing Cost Analysis & Variance Ledger
  • Multi-Company Rules: Record-level security isolation under Company 1 (Ashewa Technology Solutions S.C.), preventing cross-company ledger leakage across parent and subsidiary legal entities.

5. Comprehensive Troubleshooting Matrix#

Error Symptom / ExceptionProbable Root CauseCorrective Action / Resolution
BoM Missing Error: No active Bill of Materials foundProduct variant lacks a verified and confirmed BoM in the system.Create and confirm an active BoM under Manufacturing → Products → Bills of Materials.
Component Shortage Block: Insufficient stockRaw material components have not been transferred to the shop floor location.Execute an internal transfer from main warehouse to production staging location.
Quality Gate Blocked: Mandatory test failedWork order failed critical quality tolerance threshold.Perform required corrective rework or request authorized Quality Manager override.
Workcenter Capacity OverloadScheduled production duration exceeds available work center shift capacity.Adjust scheduled start dates or distribute load across alternative work centers.
Last updated: 2026-11-15