Odoo 19.0 Community · Persistent

purchase.order.line: fields, relations and API

The purchase.order.line model ("Purchase Order Line") is a persistent model declared by the Purchase module, then extended by 10 other modules. It exposes 67 fields, 58 of them declared directly on the model; 6 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.

View source code Search another model

Model identity

Technical name: purchase.order.line
Label: Purchase Order Line
Type: Persistent (models.Model)
SQL table: purchase_order_line
Origin module: Purchase (purchase)
Extended by: purchase_stock, stock_landed_costs, sale_purchase, sale_purchase_stock, stock_dropshipping, purchase_mrp, project_purchase, purchase_product_matrix, purchase_requisition, purchase_requisition_stock
Default order (_order): order_id, sequence, id
Inherits from (mixins): analytic.mixin

Model fields

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

Hide inherited fields

67 of 67 fields shown

Technical name	Label	Type	Details
allowed_uom_ids	Allowed Uom	`many2many` → uom.uom	computed
amount_to_invoice_at_date	Amount	`float`	computed
company_currency_id	Company Currency	`many2one` → res.currency	related: `company_id.currency_id` added by Purchase Agreements (`purchase_requisition`)
company_id	Company	`many2one` → res.company	read-only related: `order_id.company_id`
currency_id	Currency	`many2one` → res.currency	related: `order_id.currency_id`
date_approve	Confirmation Date	`datetime`	read-only related: `order_id.date_approve`
date_order	Order Date	`datetime`	read-only related: `order_id.date_order`
date_planned	Expected Arrival Delivery date expected from vendor. This date respectively defaults to vendor pricelist lead time then today's date.	`datetime`	computed, stored
discount	Discount (%)	`float`	computed, stored
display_type	Display Type Technical field for UX purpose.	`selection`	Values: `line_section` (Section), `line_subsection` (Subsection), `line_note` (Note)
forecasted_issue	Forecasted Issue	`boolean`	computed added by Purchase Stock (`purchase_stock`)
invoice_lines	Bill Lines	`one2many` → account.move.line	read-only inverse: `purchase_line_id`
is_configurable_product	Is the product configurable?	`boolean`	related: `product_template_id.has_configurable_attributes` added by Purchase Matrix (`purchase_product_matrix`)
is_downpayment	Is Downpayment	`boolean`
is_storable	Is Storable	`boolean`	related: `product_id.is_storable` added by Purchase Stock (`purchase_stock`)
location_final_id	Location from procurement	`many2one` → stock.location	added by Purchase Stock (`purchase_stock`)
move_dest_ids	Downstream moves alt	`many2many` → stock.move	added by Purchase Stock (`purchase_stock`)
move_ids	Reservation	`one2many` → stock.move	read-only inverse: `purchase_line_id` added by Purchase Stock (`purchase_stock`)
name	Description	`text`	requiredcomputed, stored
on_time_rate_perc	OTD	`float`	related: `order_id.on_time_rate_perc` added by Purchase Requisition Stock (`purchase_requisition_stock`)
order_id	Order Reference	`many2one` → purchase.order	required
orderpoint_id	Orderpoint	`many2one` → stock.warehouse.orderpoint	added by Purchase Stock (`purchase_stock`)
parent_id	Parent Section Line	`many2one` → purchase.order.line	computed
partner_id	Partner	`many2one` → res.partner	read-only related: `order_id.partner_id`
price_subtotal	Subtotal	`monetary`	computed, stored
price_tax	Tax	`float`	computed, stored
price_total	Total	`monetary`	computed, stored
price_total_cc	Company Subtotal	`monetary`	computed, stored added by Purchase Agreements (`purchase_requisition`)
price_unit	Unit Price	`float`	requiredcomputed, stored
price_unit_discounted	Unit Price (Discounted)	`float`	computed
price_unit_product_uom	Unit Price Product UoM The Price of one unit of the product's Unit of Measure	`float`	computed
product_description_variants	Custom Description	`char`	added by Purchase Stock (`purchase_stock`)
product_id	Product	`many2one` → product.product
product_no_variant_attribute_value_ids	Product attribute values that do not create variants	`many2many` → product.template.attribute.value
product_qty	Quantity	`float`	required
product_template_attribute_value_ids	Product Template Attribute Value	`many2many` → product.template.attribute.value	read-only related: `product_id.product_template_attribute_value_ids`
product_template_id	Product Template	`many2one` → product.template	related: `product_id.product_tmpl_id` added by Purchase Matrix (`purchase_product_matrix`)
product_type	Product Type	`selection`	read-only related: `product_id.type`
product_uom_id	Unit	`many2one` → uom.uom
product_uom_qty	Total Quantity	`float`	computed, stored
propagate_cancel	Propagate cancellation	`boolean`	added by Purchase Stock (`purchase_stock`)
purchase_line_warn_msg	Purchase Line Warn Msg	`text`	computed
qty_invoiced	Billed Qty	`float`	computed, stored
qty_invoiced_at_date	Billed	`float`	computed
qty_received	Received Qty	`float`	computed, stored
qty_received_at_date	Received	`float`	computed
qty_received_manual	Manual Received Qty	`float`
qty_received_method	Received Qty Method According to product configuration, the received quantity can be automatically computed by mechanism: - Manual: the quantity is set manually on the line - Stock Moves: the quantity comes from confirmed pickings	`selection`	computed, stored Values: `manual` (Manual)
qty_to_invoice	To Invoice Quantity	`float`	read-onlycomputed, stored
sale_line_id	Origin Sale Item	`many2one` → sale.order.line	added by Sale Purchase (`sale_purchase`)
sale_order_id	Sale Order	`many2one` → sale.order	related: `sale_line_id.order_id` added by Sale Purchase (`sale_purchase`)
selected_seller_id	Selected Seller Technical field to get the vendor pricelist used to generate this line	`many2one` → product.supplierinfo	computed
sequence	Sequence	`integer`
state	State	`selection`	related: `order_id.state`
tax_calculation_rounding_method	Tax calculation rounding method	`selection`	read-only related: `company_id.tax_calculation_rounding_method`
tax_ids	Taxes	`many2many` → account.tax
technical_price_unit	Technical Price Unit Technical field for price computation	`float`
translated_product_name	Translated Product Name	`text`	computed
analytic_distribution	Analytic Distribution	`json`	computed, stored inherited from analytic.mixin
analytic_precision	Analytic Precision	`integer`	inherited from analytic.mixin
distribution_analytic_account_ids	Distribution Analytic Account	`many2many` → account.analytic.account	computed inherited from analytic.mixin
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

account.move.line: invoice_lines
account.tax: tax_ids
product.product: product_id
product.supplierinfo: selected_seller_id
product.template: product_template_id
product.template.attribute.value: product_no_variant_attribute_value_ids, product_template_attribute_value_ids
purchase.order: order_id
purchase.order.line: parent_id
res.company: company_id
res.currency: company_currency_id, currency_id
res.partner: partner_id
sale.order: sale_order_id
sale.order.line: sale_line_id
stock.location: location_final_id
stock.move: move_dest_ids, move_ids
stock.warehouse.orderpoint: orderpoint_id
uom.uom: allowed_uom_ids, product_uom_id

Fields of other models pointing here

account.move.line: purchase_line_id
account.tax: purchase_order_line_ids
purchase.bill.line.match: pol_id
purchase.order.line: parent_id
stock.move: created_purchase_line_ids, purchase_line_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

curl -X POST "https://your-instance.odoo.com/json/2/purchase.order.line/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","order_id","price_unit","product_qty","state"],"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}/purchase.order.line/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","order_id","price_unit","product_qty","state"], "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-order-line">purchase.order.line (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.