How to Verify BOM Structure in iDempiere
The Verify BOM Structure window validates Bill of Materials (BOM) records in iDempiere, checking product structures for accuracy before they are used in transactions.
Verification updates the Verified flag on each product, so invalid or incomplete BOMs are caught early, protecting order accuracy, costing, and inventory reporting.
Process Flow
Business Rules
- Only BOM products are included in verification.
- A single product or an entire Product Category can be verified in one run.
- Re-Validate includes products already marked as Verified in the check.
- Products with zero active BOM lines are automatically marked invalid.
- Circular references between component BOMs are detected and marked invalid.
- A component BOM that is invalid marks its parent product as containing invalid items.
Prerequisites
- Product Category created (e.g., Home Appliances).
- Products created and flagged as BOM (IsBOM = Y).
- Product BOM & Formula defined with at least one active line.
- One BOM structure set as the Default BOM for each product.
- Organization and Client configured in iDempiere.
Navigation
Menu → Manufacturing → Verify BOM Structure
Configuration Steps
Step 1: Select the Verification Scope
Enter a specific Product to check a single BOM, or select a Product Category to verify all BOM products in that category. Leave Product blank for category-wide checks.
| Field | Sample Value | Description |
| Product | (blank) | Specific BOM product to validate; leave blank for a category-wide run |
| Product Category | Home Appliances | Restricts verification to BOM products within this category |
Step 2: Decide Whether to Re-Validate
Check Re-Validate to include products already marked Verified = Y. Leave unchecked to process only unverified BOM products.
| Field | Sample Value | Description |
| Re-Validate | Checked | Includes previously verified products in this run |
Step 3: Choose Run as Job for Batch Processing
Enable Run as Job when verifying a large category so the process runs in the background and results appear in the process log.
| Field | Sample Value | Description |
| Run as Job | Unchecked | Runs in the foreground (unchecked) or as a background job (checked) |
Step 4: Execute the Verification
Click OK to start. iDempiere validates each BOM product, updates the Verified flag, and returns a summary count or a “Product Checked” message.
Step 5: Review the Process Log
Open the process result log to review messages per product, including BOM Missing, No Default BOM, or Recursively Contains errors.
Common Issues and Resolutions
| Issue | Cause | Resolution |
| Product not verified after running | IsBOM flag not enabled on the product | Enable the BOM flag on the product master |
| Product marked invalid though BOM looks correct | No Default BOM set among its BOM structures | Mark one BOM structure as Default |
| “BOM Recursively Contains” error | Circular reference between component BOMs | Remove the circular link and restructure the BOM |
| BOM has 0 active lines error | All BOM lines are inactive | Activate at least one BOM line |
| Already verified products skipped | Re-Validate checkbox left unchecked | Enable Re-Validate before running |
| Batch run appears slow or unresponsive | Large category run executed in the foreground | Enable Run as Job for background processing |
| Component errors not visible immediately | Run as Job buffers log messages per product | Open the process log after the job completes |
| Product stays unverified after fixing it | A child component BOM is still invalid | Correct and verify child BOM products first |
Next Steps
- Configure Product BOM & Formula for each assembled product.
- Review Product Category setup for BOM groupings.
- Set up Manufacturing/Production Order processes for verified BOMs.
- Configure Inventory and Costing for kit-based products.