purchase.report: fields, relations and API
The purchase.report model ("Purchase Report") is a persistent model declared by the Purchase module, then extended by 1 other module. It exposes 36 fields, 30 of them declared directly on the model. 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
purchase.report- Label
- Purchase Report
- Type
- Persistent (models.Model)
- SQL table
- None (no table)
- Origin module
- Purchase (
purchase) - Extended by
- purchase_stock
- Default order (_order)
date_order desc, price_total desc
Model fields
30 own fields, 0 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.
36 of 36 fields shown
| Technical name | Label | Type | Details |
|---|---|---|---|
| category_id | Product Category | many2one | read-only |
| commercial_partner_id | Commercial Entity | many2one | read-only |
| company_id | Company | many2one | read-only |
| country_id | Partner Country | many2one | read-only |
| currency_id | Currency | many2one | read-only |
| date_approve | Confirmation Date | datetime | read-only |
| date_order | Order Date | datetime | read-only |
| days_to_arrival | Effective Days To Arrival | float | read-only added by Purchase Stock ( |
| delay | Days to Confirm Amount of time between purchase approval and order by date. | float | read-only |
| delay_pass | Days to Receive Amount of time between date planned and order by date for each purchase order line. | float | read-only |
| effective_date | Effective Date | datetime | added by Purchase Stock ( |
| fiscal_position_id | Fiscal Position | many2one | read-only |
| nbr_lines | # of Lines | integer | read-only |
| order_id | Order | many2one | read-only |
| partner_id | Vendor | many2one | read-only |
| picking_type_id | Warehouse | many2one | read-only added by Purchase Stock ( |
| price_average | Average Cost | monetary | read-only |
| price_total | Total | monetary | read-only |
| product_id | Product | many2one | read-only |
| product_tmpl_id | Product Template | many2one | read-only |
| product_uom_id | Reference Unit of Measure | many2one→ uom.uom | read-only |
| qty_billed | Qty Billed | float | read-only |
| qty_ordered | Qty Ordered | float | read-only |
| qty_received | Qty Received | float | read-only |
| qty_to_be_billed | Qty to be Billed | float | read-only |
| state | Status | selection | read-only Values: |
| untaxed_total | Untaxed Total | monetary | read-only |
| user_id | Buyer | many2one | read-only |
| volume | Volume | float | read-only |
| weight | Gross Weight | float | read-only |
| 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.fiscal.position: fiscal_position_id
- product.category: category_id
- product.product: product_id
- product.template: product_tmpl_id
- purchase.order: order_id
- res.company: company_id
- res.country: country_id
- res.currency: currency_id
- res.partner: commercial_partner_id, partner_id
- res.users: user_id
- stock.warehouse: picking_type_id
- uom.uom: product_uom_id
Fields of other models pointing here
No Many2one or Many2many field of another model points to this model.
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/purchase.report/search_read" \
-H "Authorization: bearer $ODOO_API_KEY" \
-H "X-Odoo-Database: your-db" \
-H "Content-Type: application/json" \
-d '{"domain":[],"fields":["state","category_id","commercial_partner_id","company_id","country_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}/purchase.report/search_read",
headers=headers,
json={"domain": [], "fields": ["state","category_id","commercial_partner_id","company_id","country_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/purchase-report">purchase.report (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.