Odoo 20.0 Community · Persistent

mrp.bom: fields, relations and API

The mrp.bom model ("Bill of Material") is a persistent model declared by the Manufacturing module, then extended by 5 other modules. It exposes 50 fields, 32 of them declared directly on the model; 15 fields from other models point to it. Below you will find every field with its technical name, type, label and relations, followed by an Odoo 20 JSON-2 API call.

View source code Search another model

Model identity

Technical name: mrp.bom
Label: Bill of Material
Type: Persistent (models.Model)
SQL table: mrp_bom
Origin module: Manufacturing (mrp)
Extended by: mrp_account, mrp_subcontracting, purchase_mrp, project_mrp, sale_mrp
Default order (_order): sequence, id
Display field (_rec_name): product_tmpl_id
Inherits from (mixins): mail.thread product.catalog.mixin

Model fields

32 own fields, 12 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.

Hide inherited fields

50 of 50 fields shown

Technical name	Label	Type	Details
active	Active	`boolean`
allow_operation_dependencies	Custom Operation Dependencies Select to customise operation dependencies. When checked, operations will be in parallel by default.	`boolean`
batch_size	Batch Size Value All automatically generated manufacturing orders for this product will be of this size.	`float`
bom_line_ids	BoM Lines	`one2many` → mrp.bom.line	inverse: `bom_id`
byproduct_ids	By-products	`one2many` → mrp.bom.byproduct	inverse: `bom_id`
code	Reference	`char`
company_id	Company	`many2one` → res.company
component_count	Component Count	`integer`	computed
continuous	Continuous Production If active, registering production on a work order will automatically unblock the next work order if it is blocked.	`boolean`
currency_id	Currency	`many2one` → res.currency	related: `company_id.currency_id` added by Accounting - MRP (`mrp_account`)
days_to_prepare_mo	Days to prepare Create and confirm Manufacturing Orders this many days in advance, to have enough time to replenish components or manufacture semi-finished products.	`integer`
enable_batch_size	Batch Size	`boolean`
extra_cost	Extra Cost Set an additional cost per manufactured unit (e.g. labour, energy, packaging)	`monetary`	added by Accounting - MRP (`mrp_account`)
json_popover	JSON data for the popover widget	`char`	computed
note	Additional Notes Additional notes for the manufacturing order. Notes added here will also be displayed in the Shop Floor.	`html`
operation_count	Operations Count	`integer`	computed
operation_ids	Operations	`one2many` → mrp.routing.workcenter	inverse: `bom_id`
picking_type_id	Operation Type When a procurement has a ‘produce’ route with a operation type set, it will try to create a Manufacturing Order for that product using a BoM of the same operation type.If not,the operation type is not taken into account in the BoM search. That allows to define stock rules which trigger different manufacturing orders with different BoMs.	`many2one` → stock.picking.type
possible_product_template_attribute_value_ids	Possible Product Template Attribute Value	`many2many` → product.template.attribute.value	computed
produce_delay	Manufacturing Lead Time Average lead time in days to manufacture this product. In the case of multi-level BOM, the manufacturing lead times of the components will be added. In case the product is subcontracted, this can be used to determine the date at which components should be sent to the subcontractor.	`integer`
product_id	Product Variant If a product variant is defined the BOM is available only for this product.	`many2one` → product.product
product_qty	Quantity This should be the smallest quantity that this product can be produced in. If the BOM contains operations, make sure the work center capacity is accurate.	`float`	required
product_tmpl_id	Product	`many2one` → product.template	required
project_id	Project	`many2one` → project.project	added by MRP Project (`project_mrp`)
ready_to_produce	Manufacturing Readiness	`selection`	required Values: `all_available` ( When all components are available), `asap` (When components for 1st operation are available)
sequence	Sequence	`integer`
show_copy_operations_button	Show Copy Operations Button Technical field used to control the visibility of the 'Copy Existing Operations' button.	`boolean`	computed
show_set_bom_button	Show Set Bom Button	`boolean`	computed
subassembly_count	Subassembly Count	`integer`	computed
subcontractor_ids	Subcontractors	`many2many` → res.partner	added by MRP Subcontracting (`mrp_subcontracting`)
type	BoM Type	`selection`	required Values: `normal` (Manufacture this product), `phantom` (Kit)
uom_id	Unit Unit of Measure (Unit of Measure) is the unit of measurement for the inventory control	`many2one` → uom.uom	required
has_message	Has Message	`boolean`	computed inherited from mail.thread
message_attachment_count	Attachment Count	`integer`	computed inherited from mail.thread
message_follower_ids	Followers	`one2many` → mail.followers	inverse: `res_id` inherited from mail.thread
message_has_error	Message Delivery error If checked, some messages have a delivery error.	`boolean`	computed inherited from mail.thread
message_has_error_counter	Number of errors Number of messages with delivery error	`integer`	computed inherited from mail.thread
message_has_sms_error	SMS Delivery error If checked, some messages have a delivery error.	`boolean`	computed inherited from mail.thread
message_ids	Messages	`one2many` → mail.message	inverse: `res_id` inherited from mail.thread
message_is_follower	Is Follower	`boolean`	computed inherited from mail.thread
message_needaction	Action Needed If checked, new messages require your attention.	`boolean`	computed inherited from mail.thread
message_needaction_counter	Number of Actions Number of messages requiring action	`integer`	computed inherited from mail.thread
message_partner_ids	Followers (Partners)	`many2many` → res.partner	computed inherited from mail.thread
rating_ids	Ratings	`one2many` → rating.rating	inverse: `res_id` inherited from mail.thread
create_date	Created on	`datetime`	read-onlyautomatic
create_uid	Created by	`many2one` → res.users	read-onlyautomatic
display_name	Display Name	`char`	read-onlycomputedautomatic
id	ID	`integer`	read-onlyautomatic
write_date	Last Updated on	`datetime`	read-onlyautomatic
write_uid	Last Updated by	`many2one` → res.users	read-onlyautomatic

Relations

Models linked from this model

mrp.bom.byproduct: byproduct_ids
mrp.bom.line: bom_line_ids
mrp.routing.workcenter: operation_ids
product.product: product_id
product.template: product_tmpl_id
product.template.attribute.value: possible_product_template_attribute_value_ids
project.project: project_id
res.company: company_id
res.currency: currency_id
res.partner: subcontractor_ids
stock.picking.type: picking_type_id
uom.uom: uom_id

Fields of other models pointing here

account.analytic.account: bom_ids
mrp.bom.byproduct: bom_id
mrp.bom.line: bom_id, child_bom_id
mrp.production: bom_id
mrp.routing.workcenter: bom_id
mrp.unbuild: bom_id, mo_bom_id
mrp.workorder: production_bom_id
res.partner: bom_ids
stock.replenish.mixin: bom_id
stock.replenishment.info: bom_id, bom_ids
stock.warehouse.orderpoint: bom_id, effective_bom_id

Reading this model through the API

Odoo 20 JSON-2 API call reading the first five records with real fields of the model. Replace the instance, database and API key with your own.

curl

curl -X POST "https://your-instance.odoo.com/json/2/mrp.bom/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["product_tmpl_id","product_qty","ready_to_produce","type","uom_id"],"limit":5}'

Python (requests)

import requests

BASE_URL = "https://your-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "your-db"}

res = requests.post(
    f"{BASE_URL}/mrp.bom/search_read",
    headers=headers,
    json={"domain": [], "fields": ["product_tmpl_id","product_qty","ready_to_produce","type","uom_id"], "limit": 5},
)
res.raise_for_status()
print(res.json())

External API access requires Odoo's Custom plan.
XML-RPC and JSON-RPC will be removed in Odoo 22 (fall 2028): use JSON-2.
The access rights and record rules of the key's user apply.

Cite this tool

Writing a tutorial, internal documentation or a forum answer? Copy this link to send your readers to the up-to-date reference.

<a href="https://aidoo.ai/en/outils/explorateur-modeles-odoo/mrp-bom">mrp.bom (Odoo 20.0)</a>

Sources

Data verified on September 25, 2026 · Odoo 20.0 Community

Have an Odoo project, or want to put your ERP to work with AI? Let's talk

Implementation, custom module development, connecting Claude or ChatGPT to your data: tell us about your context and we will reply within 24 business hours.