Odoo 19.0 Community · Persistant

purchase.order.line : champs, relations et API

Le modèle purchase.order.line (« Ligne de bon de commande ») est un modèle persistant déclaré par le module Achats, puis enrichi par 10 autres modules. Il expose 67 champs, dont 58 déclarés directement sur le modèle ; 6 champs d'autres modèles pointent vers lui. Retrouvez ci-dessous chaque champ avec son nom technique, son type, son libellé français et ses relations, puis un exemple d'appel à l'API JSON-2 d'Odoo 19.

Voir le code source Rechercher un autre modèle

Fiche d'identité

Nom technique: purchase.order.line
Libellé: Ligne de bon de commande
Type: Persistant (models.Model)
Table SQL: purchase_order_line
Module d'origine: Achats (purchase)
Étendu par: purchase_stock, stock_landed_costs, sale_purchase, sale_purchase_stock, stock_dropshipping, purchase_mrp, project_purchase, purchase_product_matrix, purchase_requisition, purchase_requisition_stock
Tri par défaut (_order): order_id, sequence, id
Hérite de (mixins): analytic.mixin

Champs du modèle

58 champs propres, 3 hérités des mixins et 6 champs automatiques de l'ORM. Cliquez sur un nom pour obtenir le lien direct vers le champ.

Masquer les champs hérités

67 champs affichés sur 67

Nom technique	Libellé	Type	Détails
allowed_uom_ids	Unité de mesure autorisée	`many2many` → uom.uom	calculé
amount_to_invoice_at_date	Montant	`float`	calculé
company_currency_id	Devise de la société	`many2one` → res.currency	related : `company_id.currency_id` ajouté par Conventions d'achat (`purchase_requisition`)
company_id	Société	`many2one` → res.company	lecture seule related : `order_id.company_id`
currency_id	Devise	`many2one` → res.currency	related : `order_id.currency_id`
date_approve	Date de confirmation	`datetime`	lecture seule related : `order_id.date_approve`
date_order	Date de la commande	`datetime`	lecture seule related : `order_id.date_order`
date_planned	Arrivée prévue Date de livraison prévue du fournisseur. Cette date correspond par défaut au délai de livraison du fournisseur, puis à la date du jour.	`datetime`	calculé, stocké
discount	Remise (%)	`float`	calculé, stocké
display_type	Type d'affichage Champ technique utilisé à des fins d'expérience utilisateur.	`selection`	Valeurs : `line_section` (Section), `line_subsection` (Sous-section), `line_note` (Note)
forecasted_issue	Problème prévu	`boolean`	calculé ajouté par Achats Inventaire (`purchase_stock`)
invoice_lines	Lignes de facturation	`one2many` → account.move.line	lecture seule inverse : `purchase_line_id`
is_configurable_product	Ce produit est-il configurable ?	`boolean`	related : `product_template_id.has_configurable_attributes` ajouté par Matrice d'achat (`purchase_product_matrix`)
is_downpayment	Est un acompte	`boolean`
is_storable	Is Storable	`boolean`	related : `product_id.is_storable` ajouté par Achats Inventaire (`purchase_stock`)
location_final_id	Emplacement de l'approvisionnement	`many2one` → stock.location	ajouté par Achats Inventaire (`purchase_stock`)
move_dest_ids	Mouvements en aval alt	`many2many` → stock.move	ajouté par Achats Inventaire (`purchase_stock`)
move_ids	Réservation	`one2many` → stock.move	lecture seule inverse : `purchase_line_id` ajouté par Achats Inventaire (`purchase_stock`)
name	Description	`text`	requiscalculé, stocké
on_time_rate_perc	OTD	`float`	related : `order_id.on_time_rate_perc` ajouté par Demande d'achat stock (`purchase_requisition_stock`)
order_id	Référence commande	`many2one` → purchase.order	requis
orderpoint_id	Point de commande	`many2one` → stock.warehouse.orderpoint	ajouté par Achats Inventaire (`purchase_stock`)
parent_id	Ligne de section parente	`many2one` → purchase.order.line	calculé
partner_id	Partenaire	`many2one` → res.partner	lecture seule related : `order_id.partner_id`
price_subtotal	Sous-total	`monetary`	calculé, stocké
price_tax	Taxe	`float`	calculé, stocké
price_total	Total	`monetary`	calculé, stocké
price_total_cc	Sous-total de la société	`monetary`	calculé, stocké ajouté par Conventions d'achat (`purchase_requisition`)
price_unit	Prix unitaire	`float`	requiscalculé, stocké
price_unit_discounted	Prix unitaire (remise)	`float`	calculé
price_unit_product_uom	Prix unitaire (UdM du produit) Le prix unitaire du produit dans son unité de mesure	`float`	calculé
product_description_variants	Description personnalisée	`char`	ajouté par Achats Inventaire (`purchase_stock`)
product_id	Produit	`many2one` → product.product
product_no_variant_attribute_value_ids	Valeurs d'attributs de produit qui ne créent pas de variantes	`many2many` → product.template.attribute.value
product_qty	Quantité	`float`	requis
product_template_attribute_value_ids	Valeur caratéristique du modèle produit	`many2many` → product.template.attribute.value	lecture seule related : `product_id.product_template_attribute_value_ids`
product_template_id	Modèle de produit	`many2one` → product.template	related : `product_id.product_tmpl_id` ajouté par Matrice d'achat (`purchase_product_matrix`)
product_type	Type de produit	`selection`	lecture seule related : `product_id.type`
product_uom_id	Unité	`many2one` → uom.uom
product_uom_qty	Quantité totale	`float`	calculé, stocké
propagate_cancel	Propager l'annulation	`boolean`	ajouté par Achats Inventaire (`purchase_stock`)
purchase_line_warn_msg	Message d’avertissement de ligne d’achat	`text`	calculé
qty_invoiced	Qté facturée	`float`	calculé, stocké
qty_invoiced_at_date	Facturé	`float`	calculé
qty_received	Qté reçue	`float`	calculé, stocké
qty_received_at_date	Reçu	`float`	calculé
qty_received_manual	Qté manuellement reçue	`float`
qty_received_method	Méthode de la quantité reçue 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`	calculé, stocké Valeurs : `manual` (Manuelle)
qty_to_invoice	Quantité à facturer	`float`	lecture seulecalculé, stocké
sale_line_id	Article de vente d'origine	`many2one` → sale.order.line	ajouté par Ventes & Achats (`sale_purchase`)
sale_order_id	Commande client	`many2one` → sale.order	related : `sale_line_id.order_id` ajouté par Ventes & Achats (`sale_purchase`)
selected_seller_id	Vendeur sélectionné Champ technique pour obtenir la liste de prix fournisseur utilisée pour générer cette ligne	`many2one` → product.supplierinfo	calculé
sequence	Séquence	`integer`
state	Statut	`selection`	related : `order_id.state`
tax_calculation_rounding_method	Méthode d'arrondi pour le calcul des taxes	`selection`	lecture seule related : `company_id.tax_calculation_rounding_method`
tax_ids	Taxes	`many2many` → account.tax
technical_price_unit	Prix unitaire technique Champ technique pour le calcul du prix	`float`
translated_product_name	Nom de produit traduit	`text`	calculé
analytic_distribution	Répartition Analytique	`json`	calculé, stocké hérité de analytic.mixin
analytic_precision	Précision analytique	`integer`	hérité de analytic.mixin
distribution_analytic_account_ids	Compte analytique de répartition	`many2many` → account.analytic.account	calculé hérité de analytic.mixin
create_date	Créé le	`datetime`	lecture seuleautomatique
create_uid	Créé par	`many2one` → res.users	lecture seuleautomatique
display_name	Nom affiché	`char`	lecture seulecalculéautomatique
id	ID	`integer`	lecture seuleautomatique
write_date	Dernière mise à jour le	`datetime`	lecture seuleautomatique
write_uid	Dernière mise à jour par	`many2one` → res.users	lecture seuleautomatique

Relations

Modèles liés depuis ce modèle

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

Champs d'autres modèles qui pointent ici

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

Lire ce modèle par l'API

Exemple d'appel à l'API JSON-2 d'Odoo 19 : lecture des cinq premiers enregistrements avec des champs réels du modèle. Remplacez l'instance, la base et la clé API par les vôtres.

curl

curl -X POST "https://votre-instance.odoo.com/json/2/purchase.order.line/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: votre-base" \
  -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://votre-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "votre-base"}

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())

L'accès à l'API externe est réservé à la formule Custom d'Odoo.
XML-RPC et JSON-RPC seront retirés dans Odoo 22 (automne 2028) : préférez JSON-2.
Les droits d'accès et règles d'enregistrement de l'utilisateur de la clé s'appliquent.

Citer cet outil

Vous rédigez un tutoriel, une documentation interne ou une réponse sur un forum ? Copiez ce lien pour renvoyer vos lecteurs vers la fiche à jour.

<a href="https://aidoo.ai/fr/outils/explorateur-modeles-odoo/purchase-order-line">purchase.order.line (Odoo 19.0)</a>

Sources

Données vérifiées le 23 septembre 2026 · Odoo 19.0 Community

Vous avez un projet Odoo ou souhaitez exploiter votre ERP avec l'IA ? Échangeons

Intégration, développement de modules, connexion de Claude ou ChatGPT à vos données : décrivez-nous votre contexte, nous vous répondons sous 24 heures ouvrées.

Nous contacter Voir une démo