product.category: fields, relations and API
The product.category model ("Product Category") is a persistent model declared by the Products & Pricelists module, then extended by 6 other modules. It exposes 43 fields, 24 of them declared directly on the model; 21 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 19 JSON-2 API call.
Model identity
- Technical name
product.category- Label
- Product Category
- Type
- Persistent (models.Model)
- SQL table
product_category- Origin module
- Products & Pricelists (
product) - Extended by
- account, delivery, stock, stock_account, point_of_sale, mrp_account
- Default order (_order)
complete_name- Display field (_rec_name)
complete_name- Inherits from (mixins)
- mail.threadpos.load.mixin
Model fields
24 own fields, 13 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.
43 of 43 fields shown
| Technical name | Label | Type | Details |
|---|---|---|---|
| account_stock_variation_id | Stock Variation Account | many2one | related: added by WMS Accounting ( |
| anglo_saxon_accounting | Use Anglo-Saxon Accounting If checked, the product will be valued using the Anglo-Saxon accounting method. | boolean | computed added by WMS Accounting ( |
| child_id | Child Categories | one2many | inverse: |
| complete_name | Complete Name | char | computed, stored |
| filter_for_stock_putaway_rule | stock.putaway.rule | boolean | added by Inventory ( |
| name | Name | char | required |
| packaging_reserve_method | Reserve Packagings Reserve Only Full Packagings: will not reserve partial packagings. If customer orders 2 pallets of 1000 units each and you only have 1600 in stock, then only 1000 will be reserved Reserve Partial Packagings: allow reserving partial packagings. If customer orders 2 pallets of 1000 units each and you only have 1600 in stock, then 1600 will be reserved | selection | Values: added by Inventory ( |
| parent_id | Parent Category | many2one | |
| parent_path | Parent Path | char | |
| parent_route_ids | Parent Routes | many2many | computed added by Inventory ( |
| product_count | # Products The number of products under this category (Does not consider the children categories) | integer | computed |
| product_properties_definition | Product Properties | properties_definition | |
| property_account_expense_categ_id | Expense Account The expense is accounted for when a vendor bill is validated, except in anglo-saxon accounting with perpetual inventory valuation in which case the expense (Cost of Goods Sold account) is recognized at the customer invoice validation. | many2one | company-dependent added by Invoicing ( |
| property_account_income_categ_id | Income Account This account will be used when validating a customer invoice. | many2one | company-dependent added by Invoicing ( |
| property_cost_method | Costing Method Standard Price: The products are valued at their standard cost defined on the product. Average Cost (AVCO): The products are valued at weighted average cost. First In First Out (FIFO): The products are valued supposing those that enter the company first will also leave it first. | selection | company-dependent Values: added by WMS Accounting ( |
| property_price_difference_account_id | Price Difference Account With perpetual valuation, this account will hold the price difference between the standard price and the bill price. | many2one | company-dependent added by WMS Accounting ( |
| property_stock_account_production_cost_id | Production Account This account will be used as a valuation counterpart for both components and final products for manufacturing orders. If there are any workcenter/employee costs, this value will remain on the account once the production is completed. | many2one | company-dependent added by Accounting - MRP ( |
| property_stock_journal | Stock Journal When doing automated inventory valuation, this is the Accounting Journal in which entries will be automatically posted when stock moves are processed. | many2one | company-dependent added by WMS Accounting ( |
| property_stock_valuation_account_id | Stock Valuation Account When automated inventory valuation is enabled on a product, this account will hold the current value of the products. | many2one | company-dependent added by WMS Accounting ( |
| property_valuation | Inventory Valuation Periodic: The accounting entries are suggested manually in the inventory valuation report. Perpetual: An accounting entry is automatically created to value the inventory when a product is billed or invoiced. | selection | company-dependent Values: added by WMS Accounting ( |
| putaway_rule_ids | Putaway Rules | one2many | inverse: added by Inventory ( |
| removal_strategy_id | Force Removal Strategy Set a specific removal strategy that will be used regardless of the source location for this product category. FIFO: products/lots that were stocked first will be moved out first. LIFO: products/lots that were stocked last will be moved out first. Closest location: products/lots closest to the target location will be moved out first. FEFO: products/lots with the closest removal date will be moved out first (the availability of this method depends on the "Expiration Dates" setting). Least Packages: FIFO but with the least number of packages possible when there are several packages containing the same product. | many2one | added by Inventory ( |
| route_ids | Routes | many2many | added by Inventory ( |
| total_route_ids | Total routes | many2many | read-onlycomputed added by Inventory ( |
| 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 | inverse: 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 | inverse: 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 | computed inherited from mail.thread |
| rating_ids | Ratings | one2many | inverse: inherited from mail.thread |
| website_message_ids | Website Messages Website communication history | one2many | inverse: inherited from mail.thread |
| create_date | Created on | datetime | read-onlyautomatic |
| create_uid | Created by | many2one | 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 | read-onlyautomatic |
Relations
Models linked from this model
- account.account: account_stock_variation_id, property_account_expense_categ_id, property_account_income_categ_id, property_price_difference_account_id, property_stock_account_production_cost_id, property_stock_valuation_account_id
- account.journal: property_stock_journal
- product.category: child_id, parent_id
- product.removal: removal_strategy_id
- stock.putaway.rule: putaway_rule_ids
- stock.route: parent_route_ids, route_ids, total_route_ids
Fields of other models pointing here
- account.analytic.applicability: product_categ_id
- account.analytic.distribution.model: product_categ_id
- account.analytic.line: product_category
- account.invoice.report: product_categ_id
- account.move.line: product_category_id
- loyalty.reward: discount_product_category_id
- loyalty.rule: product_category_id
- product.category: parent_id
- product.pricelist.item: categ_id
- product.template: categ_id
- purchase.report: category_id
- report.pos.order: product_categ_id
- sale.order.line: categ_id
- sale.report: categ_id
- stock.move: product_category_id
- stock.picking.type: wave_category_ids
- stock.putaway.rule: category_id
- stock.quant: product_categ_id
- stock.route: categ_ids
- stock.warehouse.orderpoint: product_category_id
- vendor.delay.report: category_id
Reading this model through the API
Odoo 19 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 -X POST "https://your-instance.odoo.com/json/2/product.category/search_read" \
-H "Authorization: bearer $ODOO_API_KEY" \
-H "X-Odoo-Database: your-db" \
-H "Content-Type: application/json" \
-d '{"domain":[],"fields":["complete_name","name","account_stock_variation_id","parent_id","property_account_expense_categ_id"],"limit":5}'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}/product.category/search_read",
headers=headers,
json={"domain": [], "fields": ["complete_name","name","account_stock_variation_id","parent_id","property_account_expense_categ_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/product-category">product.category (Odoo 19.0)</a>Sources
Data verified on September 23, 2026 · Odoo 19.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.