Odoo 20.0 Community · Persistant

purchase.order : champs, relations et API

Le modèle purchase.order (« Bon de commande fournisseur ») est un modèle persistant déclaré par le module Achats, puis enrichi par 15 autres modules. Il expose 107 champs, dont 74 déclarés directement sur le modèle ; 14 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 20.

Voir le code source Rechercher un autre modèle

Fiche d'identité

Nom technique: purchase.order
Libellé: Bon de commande fournisseur
Type: Persistant (models.Model)
Table SQL: purchase_order
Module d'origine: Achats (purchase)
Étendu par: purchase_stock, sale_purchase, sale_purchase_stock, stock_dropshipping, mrp_subcontracting_dropshipping, purchase_mrp, mrp_subcontracting_purchase, project_purchase, purchase_alternative, purchase_alternative_stock, purchase_edi_ubl_bis3, purchase_product_matrix, purchase_repair, purchase_requisition, purchase_requisition_stock
Tri par défaut (_order): priority desc, id desc
Hérite de (mixins): portal.mixin product.catalog.mixin mail.thread mail.activity.mixin account.document.import.mixin

Champs du modèle

74 champs propres, 27 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

107 champs affichés sur 107

Nom technique	Libellé	Type	Détails
acknowledged	Confirmé Indique que le fournisseur a accusé réception du bon de commande.	`boolean`
alternative_po_ids	Bons de commande alternatifs Autres bons de commande potentiels pour l'achat de produits	`one2many` → purchase.order	related : `purchase_group_id.order_ids` ajouté par Alternative d'achat (`purchase_alternative`)
amount_tax	Taxes	`monetary`	lecture seulecalculé, stocké
amount_total	Total	`monetary`	lecture seulecalculé, stocké
amount_total_cc	Total en devise	`monetary`	lecture seulecalculé, stocké
amount_untaxed	Montant hors taxes	`monetary`	lecture seulecalculé, stocké
bill_matched_ratio	Bill Matched Ratio	`float`	calculé
company_currency_id	Devise de la société	`many2one` → res.currency	related : `company_id.currency_id`
company_id	Société	`many2one` → res.company	requis
company_price_include	Company Price Include	`selection`	related : `company_id.account_price_include`
country_code	Code pays	`char`	related : `company_id.account_fiscal_country_id.code`
currency_id	Devise	`many2one` → res.currency	requiscalculé, stocké
currency_rate	Taux de change	`float`	calculé, stocké
date_approve	Date de la commande	`datetime`	lecture seule
date_calendar_start	Date calendrier de début	`datetime`	lecture seulecalculé, stocké
date_order	Échéance de commande Représente la date à laquelle le devis devrait être validé et converti en bon de commande.	`datetime`	requis
date_planned	Arrivée prévue Date de livraison prévue des marchandises par le fournisseur, selon les dernières informations disponibles	`datetime`	calculé, stocké
date_promised	Date promise Date promise par le fournisseur pour la livraison d’au moins un ou plusieurs produits.	`datetime`	calculé, stocké ajouté par Purchase Stock (`purchase_stock`)
default_location_dest_id_is_subcontracting_loc	ID empl. dest. par défaut est empl. sous-traitance	`boolean`	calculé ajouté par Dropship and Subcontracting Management (`mrp_subcontracting_dropshipping`)
default_location_dest_id_usage	Type d'emplacement de destination Champ technique utilisé pour afficher l'adresse de dropshipping.	`selection`	lecture seule related : `picking_type_id.default_location_dest_id.usage` ajouté par Purchase Stock (`purchase_stock`)
dest_address_id	Adresse de dropshipping Ajoutez une adresse si vous voulez livrer directement du fournisseur au client. Sinon, laissez vide pour vous faire livrer à votre société.	`many2one` → res.partner	calculé, stocké
document_tax_mode	Mode de taxe du document	`selection`	requiscalculé, stocké Valeurs : `tax_excluded` (Hors taxes), `tax_included` (Toutes taxes comprises)
dropship_picking_count	Nombre de livraisons en dropshipping	`integer`	calculé ajouté par Drop Shipping (`stock_dropshipping`)
duplicated_order_ids	Commande dupliquée	`many2many` → purchase.order	calculé
effective_date	Arrivée Date de finalisation de la dernière réception.	`datetime`	calculé, stocké ajouté par Purchase Stock (`purchase_stock`)
fiscal_position_id	Position fiscale	`many2one` → account.fiscal.position
grid	Grid Technical storage of grid. If grid_update, will be loaded on the PO. If not, represents the matrix to open.	`char`	ajouté par Purchase Matrix (`purchase_product_matrix`)
grid_product_tmpl_id	Grille des modèles de produits Champ technique pour les fonctionnalités de product_matrix.	`many2one` → product.template	ajouté par Purchase Matrix (`purchase_product_matrix`)
grid_update	Mise à jour de la grille Si le champ grille contient une nouvelle matrice à appliquer ou pas.	`boolean`	ajouté par Purchase Matrix (`purchase_product_matrix`)
has_sale_order	Champ technique indiquant si le bon de commande est lié à des commandes client.	`boolean`	calculé ajouté par Sale Purchase (`sale_purchase`)
incoming_picking_count	Nombre de réceptions	`integer`	calculé ajouté par Purchase Stock (`purchase_stock`)
incoterm_id	Incoterm Les Incoterms sont une série de termes commerciaux prédéfinis utilisés dans les transactions internationales.	`many2one` → account.incoterms	calculé, stocké
incoterm_location	Lieu Incoterm	`char`	calculé, stocké
invoice_count	Nombre de factures	`integer`	calculé, stocké
invoice_ids	Factures fournisseurs	`many2many` → account.move	calculé, stocké
invoice_status	Statut de facturation	`selection`	lecture seulecalculé, stocké Valeurs : `no` (Rien à facturer), `to invoice` (Factures en attente), `invoiced` (Entièrement facturé)
is_late	En retard	`boolean`
is_shipped	Est expédié	`boolean`	calculé ajouté par Purchase Stock (`purchase_stock`)
lock_confirmed_po	Lock Confirmed Po	`selection`	related : `company_id.po_lock`
locked	Verrouillé Les bons de commandes verrouillés ne peuvent pas être modifiés.	`boolean`
mrp_production_count	Nombre d'OF d'origine	`integer`	calculé ajouté par Purchase and MRP Management (`purchase_mrp`)
name	Référence commande	`char`	requis
note	Conditions générales	`html`
on_time_rate	On Time Rate	`float`	related : `partner_id.on_time_rate` ajouté par Purchase Stock (`purchase_stock`)
on_time_rate_perc	OTD	`float`	calculé ajouté par Purchase Alternative Stock (`purchase_alternative_stock`)
order_line	Lignes de commande	`one2many` → purchase.order.line	inverse : `order_id`
origin	Source Référence du document qui a généré cette demande de bon de commande (par ex. une commande client)	`char`
partner_bill_count	Partner Bill Count	`integer`	related : `partner_id.supplier_invoice_count`
partner_id	Fournisseur Vous pouvez trouver un fournisseur par son nom, numéro de TVA, e-mail ou sa référence interne.	`many2one` → res.partner	requis
partner_ref	Référence fournisseur Référence de la commande client ou de l'offre envoyée par le fournisseur. Utilisé principalement pour faire la correspondance lors de la réception des produits, puisque cette référence est généralement écrite sur le bon de livraison envoyé par votre fournisseur.	`char`
payment_term_id	Conditions de paiement	`many2one` → account.payment.term
picking_ids	Réceptions	`many2many` → stock.picking	calculé, stocké ajouté par Purchase Stock (`purchase_stock`)
picking_type_id	Livrer à Cela déterminera le type d'opération des réceptions	`many2one` → stock.picking.type	requis ajouté par Purchase Stock (`purchase_stock`)
priority	Priorité	`selection`	Valeurs : `0` (Normal), `1` (Urgent)
product_id	Produit	`many2one` → product.product	related : `order_line.product_id`
project_id	Projet	`many2one` → project.project	ajouté par Project Purchase (`project_purchase`)
purchase_group_id	Groupe d'achat	`many2one` → purchase.order.group	ajouté par Alternative d'achat (`purchase_alternative`)
purchase_warning_text	Avertissement d’achat Avertissement interne pour le partenaire ou les produits défini par l’utilisateur.	`text`	calculé
receipt_reminder_email	Rappel de réception	`boolean`	calculé, stocké
receipt_status	Statut de la réception	`selection`	calculé, stocké Valeurs : `pending` (Non reçu), `partial` (Partiellement reçu), `full` (Entièrement reçu)
reference_ids	Références	`many2many` → stock.reference	ajouté par Purchase Stock (`purchase_stock`)
reminder_date_before_receipt	Jours avant réception	`integer`	calculé, stocké
repair_count	Count of source repairs	`integer`	calculé ajouté par Purchase Repair (`purchase_repair`)
requisition_id	Accord	`many2one` → purchase.requisition	ajouté par Conventions d'achat (`purchase_requisition`)
requisition_type	Requisition Type	`selection`	related : `requisition_id.requisition_type` ajouté par Conventions d'achat (`purchase_requisition`)
sale_order_count	Nombre de ventes à la source	`integer`	calculé ajouté par Sale Purchase (`sale_purchase`)
show_comparison	Afficher la comparaison	`boolean`	calculé
show_receive_button	Afficher le bouton Recevoir	`boolean`	calculé
state	Statut	`selection`	lecture seule Valeurs : `draft` (Demande de prix), `sent` (Envoyé), `to approve` (À approuver), `purchase` (Bon de commande fournisseur), `cancel` (Annulé)
subcontracting_resupply_picking_count	Nombre de réapprovisionnements de sous-traitance Nombre de réapprovisionnements de sous-traitance pour les composants	`integer`	calculé ajouté par Purchase and Subcontracting Management (`mrp_subcontracting_purchase`)
tax_calculation_rounding_method	Méthode d'arrondi pour le calcul des taxes	`selection`	lecture seule related : `company_id.tax_calculation_rounding_method`
tax_country_id	Pays de la taxe Champ technique pour filtrer les taxes disponibles en fonction du pays fiscal et de la position fiscale.	`many2one` → res.country	calculé
tax_totals	Taxes totales	`json`	calculé
user_id	Acheteur	`many2one` → res.users
access_token	Jeton de sécurité	`char`	hérité de portal.mixin
access_url	URl d'accès au portail URl du portail client	`char`	calculé hérité de portal.mixin
access_warning	Avertissement d'accès	`text`	calculé hérité de portal.mixin
activity_calendar_event_id	Activité suivante de l'événement du calendrier	`many2one` → calendar.event	calculé hérité de mail.activity.mixin
activity_date_deadline	Date limite de l'activité à venir	`date`	lecture seulecalculé hérité de mail.activity.mixin
activity_exception_decoration	Indicateur d’exception d’activité Type d'activité d'exception enregistrée.	`selection`	calculé Valeurs : `warning` (Alerte), `danger` (Erreur) hérité de mail.activity.mixin
activity_exception_icon	Icône Icône pour indiquer une activité d'exception.	`char`	calculé hérité de mail.activity.mixin
activity_ids	Activités	`one2many` → mail.activity	inverse : `res_id` hérité de mail.activity.mixin
activity_plans_ids	Plans d'activité	`many2many` → mail.activity.plan	calculé hérité de mail.activity.mixin
activity_state	Statut de l'activité Status based on activities Overdue: Due date is already passed Today: Activity date is today Planned: Future activities.	`selection`	calculé Valeurs : `overdue` (En retard), `today` (Aujourd'hui), `planned` (Planifié) hérité de mail.activity.mixin
activity_summary	Résumé de l'activité suivante	`char`	related : `activity_ids.summary` hérité de mail.activity.mixin
activity_type_icon	Icône de type d'activité	`char`	related : `activity_ids.icon` hérité de mail.activity.mixin
activity_type_id	Type d'activités à venir	`many2one` → mail.activity.type	related : `activity_ids.activity_type_id` hérité de mail.activity.mixin
activity_user_id	Utilisateur responsable	`many2one` → res.users	lecture seulecalculé hérité de mail.activity.mixin
has_message	A un message	`boolean`	calculé hérité de mail.thread
message_attachment_count	Nombre de pièces jointes	`integer`	calculé hérité de mail.thread
message_follower_ids	Abonnés	`one2many` → mail.followers	inverse : `res_id` hérité de mail.thread
message_has_error	Erreur d'envoi du message Si coché, certains messages ont une erreur de livraison.	`boolean`	calculé hérité de mail.thread
message_has_error_counter	Nombre d'erreurs Nombre de messages avec des erreurs d'envoi	`integer`	calculé hérité de mail.thread
message_has_sms_error	Erreur d'envoi SMS Si coché, certains messages ont une erreur de livraison.	`boolean`	calculé hérité de mail.thread
message_ids	Messages	`one2many` → mail.message	inverse : `res_id` hérité de mail.thread
message_is_follower	Est un abonné	`boolean`	calculé hérité de mail.thread
message_needaction	Nécessite une action Si coché, de nouveaux messages demandent votre attention.	`boolean`	calculé hérité de mail.thread
message_needaction_counter	Nombre d'actions Nombre de messages nécessitant une action	`integer`	calculé hérité de mail.thread
message_partner_ids	Abonnés (Partenaires)	`many2many` → res.partner	calculé hérité de mail.thread
my_activity_date_deadline	Échéance de mon activité	`date`	lecture seulecalculé hérité de mail.activity.mixin
rating_ids	Évaluations	`one2many` → rating.rating	inverse : `res_id` hérité de mail.thread
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.fiscal.position : fiscal_position_id
account.incoterms : incoterm_id
account.move : invoice_ids
account.payment.term : payment_term_id
product.product : product_id
product.template : grid_product_tmpl_id
project.project : project_id
purchase.order : alternative_po_ids, duplicated_order_ids
purchase.order.group : purchase_group_id
purchase.order.line : order_line
purchase.requisition : requisition_id
res.company : company_id
res.country : tax_country_id
res.currency : company_currency_id, currency_id
res.partner : dest_address_id, partner_id
res.users : user_id
stock.picking : picking_ids
stock.picking.type : picking_type_id
stock.reference : reference_ids

Champs d'autres modèles qui pointent ici

account.move : purchase_id
account.move.line : purchase_order_id
bill.to.po.wizard : purchase_order_id
purchase.alternative.create : origin_po_id
purchase.alternative.warning : alternative_po_ids, po_ids
purchase.bill.line.match : purchase_order_id
purchase.bill.union : purchase_order_id
purchase.order : duplicated_order_ids
purchase.order.line : order_id
purchase.report : order_id
stock.lot : purchase_order_ids
stock.picking : purchase_id
stock.reference : purchase_ids

Lire ce modèle par l'API

Exemple d'appel à l'API JSON-2 d'Odoo 20 : 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/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: votre-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","company_id","currency_id","date_order","document_tax_mode"],"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/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","company_id","currency_id","date_order","document_tax_mode"], "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">purchase.order (Odoo 20.0)</a>

Sources

Données vérifiées le 25 septembre 2026 · Odoo 20.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