Odoo 20.0 Community · Persistant

pos.config : champs, relations et API

Le modèle pos.config (« Configuration du point de vente ») est un modèle persistant déclaré par le module Point de Vente, puis enrichi par 16 autres modules. Il expose 150 champs, dont 144 déclarés directement sur le modèle ; 17 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: pos.config
Libellé: Configuration du point de vente
Type: Persistant (models.Model)
Table SQL: pos_config
Module d'origine: Point de Vente (point_of_sale)
Étendu par: l10n_fr_pos_cert, pos_adyen, pos_bancontact_pay, pos_discount, pos_event, pos_sale, pos_hr, pos_restaurant, pos_loyalty, pos_stock, pos_online_payment, pos_self_order, pos_online_payment_self_order, pos_self_order_bancontact_pay, pos_self_order_event, pos_sms
Hérite de (mixins): pos.bus.mixin pos.load.mixinhr.mixin

Champs du modèle

144 champs propres, 0 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

150 champs affichés sur 150

Nom technique	Libellé	Type	Détails
access_token	Jeton d'accès	`char`
active	Actif	`boolean`
adyen_ask_customer_for_tip	Demandez un pourboire à vos clients	`boolean`	ajouté par POS Adyen (`pos_adyen`)
amount_authorized_diff	Montant de l'écart autorisé Ce champ montre l'écart maximum autorisé entre le solde final et le solde théorique à la clôture d'une session, pour ceux qui ne sont pas managers du PdV. Si ce maximum est atteint, l'utilisateur verra apparaître un message d'erreur à la fermeture de la session lui indiquant qu'il doit contacter son manager.	`float`
auto_validate_electronic_payment	Validation automatique des paiements électroniques Valide automatiquement les commandes payées via un moyen de paiement électronique (terminaux, codes QR, …).	`boolean`
available_preset_ids	Préréglages disponibles	`many2many` → pos.preset
available_pricelist_ids	Listes de prix disponibles Mettre plusieurs listes de prix à disposition du point de vente. Vous pouvez également appliquer une liste de prix à des clients spécifiques à partir de leur formulaire de contact (onglet Ventes). Pour être valide, cette liste de prix doit être répertoriée ici en tant que liste de prix disponible. Autrement, la liste de prix par défaut sera appliquée.	`many2many` → product.pricelist
basic_receipt	Gift Receipt Print gift ticket without prices. Can be used for gifts.	`boolean`
cash_control	Contrôle avancé des espèces Contrôlez le montant de la caisse à l'ouverture et à la fermeture.	`boolean`	calculé
cash_rounding	Arrondi du total	`boolean`
cashier_employee_ids	Employees with cashier level access Full register access. Can process sales, discounts, refunds, and close out payments.	`many2many` → hr.employee	ajouté par POS - HR (`pos_hr`)
closing_journal_id	Closing Journal Journal used specifically for PoS session closing and reverse entries	`many2one` → account.journal	requiscalculé, stocké
company_has_template	La société a un plan comptable	`boolean`	calculé
company_id	Société	`many2one` → res.company	requis
crm_team_id	Équipe commerciale Les ventes du Point de Vente seront associées à cette équipe commerciale.	`many2one` → crm.team	ajouté par POS - Sales (`pos_sale`)
currency_id	Devise	`many2one` → res.currency	calculé, stocké
current_cash_register_balance	Cash Register	`float`	calculé
current_session_id	Session en cours	`many2one` → pos.session	calculé
current_session_state	Statut de la session en cours	`char`	calculé
current_user_id	Responsable de la session en cours	`many2one` → res.users	calculé
custom_email	E-mail	`char`
custom_logo	Logo	`image`
custom_logo_name	Nom du logo	`char`
custom_phone	N° de téléphone	`char`
custom_receipt_address	Adresse	`char`
custom_website	Site Web	`char`
customer_display_bg_img	Image de fond	`image`
customer_display_bg_img_name	Nom de l'image d'arrière-plan	`char`
default_bill_ids	Pièces/billets	`many2many` → pos.bill
default_fiscal_position_id	Position fiscale par défaut	`many2one` → account.fiscal.position
default_partner_id	Default Customer The default customer used in PoS session closing	`many2one` → res.partner	requis
default_preset_id	Préréglage par défaut	`many2one` → pos.preset
default_product_id	Default Product This product will be used as default product on productless SOLs.	`many2one` → product.product	requis ajouté par POS - Sales (`pos_sale`)
default_screen	Écran par défaut	`selection`	Valeurs : `tables` (Tables), `register` (S'inscrire) ajouté par Restaurant (`pos_restaurant`)
device_seq_id	Séquence d’appareil	`many2one` → ir.sequence	lecture seule
discount_pc	Discount Value The default discount value when clicking on the Discount button	`float`	ajouté par Point of Sale Discounts (`pos_discount`)
discount_product_id	Produit de remise Le produit utilisé pour appliquer la remise sur le ticket.	`many2one` → product.product	ajouté par Point of Sale Discounts (`pos_discount`)
down_payment_product_id	Montant de l'acompte Ce produit sera utilisé comme acompte sur une commande.	`many2one` → product.product	requis ajouté par POS - Sales (`pos_sale`)
email	E-mail du ticket	`char`	calculé, stocké
fallback_nomenclature_id	Nomenclature de secours	`many2one` → barcode.nomenclature
fast_payment_method_ids	Modes de paiement rapides Ces méthodes de paiement seront disponibles pour le paiement rapide	`many2many` → pos.payment.method	calculé, stocké
fiscal_position_ids	Positions fiscales Ceci est utile pour les restaurants qui proposent des services sur place et à emporter, qui impliquant des taux de TVA spécifiques.	`many2many` → account.fiscal.position
floor_ids	Plans du restaurant Les salles du restaurant servies par ce point de vente.	`many2many` → restaurant.floor	ajouté par Restaurant (`pos_restaurant`)
floor_plan	Plan de salle	`json`	calculé ajouté par Restaurant (`pos_restaurant`)
floor_plan_settings	Paramètres du plan de salle	`json`	ajouté par Restaurant (`pos_restaurant`)
group_pos_manager_id	Groupe de managers du point de vente Ce champ sert à transmettre l'ID du groupe de managers du PdV au client du point de vente.	`many2one` → res.groups
group_pos_user_id	Groupe de l'utilisateur du point de vente Ce champ sert à transmettre l'ID du groupe d'utilisateurs du PdV au client du point de vente.	`many2one` → res.groups
has_active_session	A une session active	`boolean`	calculé
has_paper	A du papier	`boolean`	ajouté par POS Self Order (`pos_self_order`)
iface_available_categ_ids	Catégories de produit disponibles dans le PdV Le point de vente affichera uniquement les produits qui sont dans une des hiérarchies de catégories sélectionnée. Si aucune catégorie n'est précisée, tous les produits disponibles seront affichés.	`many2many` → pos.category
iface_big_scrollbars	Barres de défilement larges Pour les écrans tactiles industriels peu précis.	`boolean`
iface_discount	Remises de la commande Permettre au caissier de faire une remise sur la totalité de la commande.	`boolean`	ajouté par Point of Sale Discounts (`pos_discount`)
iface_group_by_categ	Regrouper les produits par catégories Afficher les produits regroupés par catégories.	`boolean`
iface_print_auto	Impression automatique du reçu Le reçu sera automatiquement imprimé à la fin de chaque commande.	`boolean`
iface_printbill	Impression de l'addition Permet d'imprimer l'addition avant le paiement.	`boolean`
iface_tax_included	Affichage des taxes	`selection`	requis Valeurs : `subtotal` (Prix hors taxes), `total` (Montant toutes taxes comprises)
iface_tipproduct	Conseils d'utilisation	`boolean`
is_installed_account_accountant	La comptabilité complète est-elle installée	`boolean`	calculé
is_margins_costs_accessible_to_every_user	Marges & Coûts Si désactivé, seul le gérant du Point de Vente peut voir la marge et le coût du produit dans les informations du produit.	`boolean`
journal_id	Journal du point de vente Journal used for customer invoices and refunds credit notes.	`many2one` → account.journal
kanban_dashboard_graph	Tableau de bord graphique Kanban	`text`	calculé
last_data_change	Date de dernière écriture	`datetime`	lecture seulecalculé, stocké
last_session_closing_date	Date de fermeture de la dernière session	`date`	calculé
limit_categories	Limiter les catégories	`boolean`
logged_employee_ids	Logged Employee All employees who have logged into the current session	`many2many` → hr.employee	lecture seule related : `current_session_id.logged_employee_ids` ajouté par POS - HR (`pos_hr`)
logo	Logo du ticket	`image`	calculé, stocké
manager_employee_ids	Employees with manager level access Full access, including reporting, cash management, and session close.	`many2many` → hr.employee	ajouté par POS - HR (`pos_hr`)
manual_discount	Remises appliquées à la ligne	`boolean`
module_pos_appointment	Réservation en ligne	`boolean`
module_pos_avatax	Intégration PdV Avatax Utiliser la correspondance automatique des taxes avec Avatax dans le PdV	`boolean`
module_pos_discount	Remises globales	`boolean`
module_pos_hr	Module PdV RH Montrer l'écran de connexion de l'employé	`boolean`
module_pos_restaurant	Est un bar/restaurant	`boolean`
module_pos_sms	SMS activé Activer la fonctionnalté SMS pour point_de_vente	`boolean`
name	Point de Vente Un identifiant interne du point de vente.	`char`	requistraduisible
note_ids	Modèles de notes Notes prédéfinies de ce point de vente.	`many2many` → pos.note
only_round_cash_method	N'appliquer l'arrondi que sur les paiements en espèces	`boolean`
order_backend_seq_id	Séquence de commande backend	`many2one` → ir.sequence	lecture seule
order_line_seq_id	Séquence de ligne de commande	`many2one` → ir.sequence	lecture seule
order_seq_id	Séquence des commandes	`many2one` → ir.sequence	lecture seule
other_devices	Autres périphériques Connecter des imprimantes à votre PdV.	`boolean`
payment_method_ids	Modes de paiement	`many2many` → pos.payment.method
phone	Téléphone du ticket	`char`	calculé, stocké
picking_policy	Politique d'expédition Si vous livrez tous les produits en même temps, le bon de livraison sera planifié sur base du produit avec le plus grand délai. Autrement, il le sera sur le plus court.	`selection`	requis Valeurs : `direct` (Dès que possible, avec des reliquats), `one` (Quand tous les articles sont prêts) ajouté par PoS - Stock (`pos_stock`)
picking_type_id	Type d'opération	`many2one` → stock.picking.type	requis ajouté par PoS - Stock (`pos_stock`)
pos_session_duration	Durée de la session PdV	`char`	calculé
pos_session_state	Statut de la session du PdV	`char`	calculé
pos_session_username	Nom d'utilisateur de la session du PdV	`char`	calculé
pos_snooze_ids	Snoozed Records	`one2many` → pos.snooze	inverse : `pos_config_id`
preparation_devices	Appareils de préparation Connectez des imprimantes de préparation pour imprimer au bar, en cuisine, ...	`boolean`
preparation_printer_ids	Imprimantes de préparation	`many2many` → pos.printer
pricelist_id	Liste de prix par défaut La liste de prix utilisée si aucun client n'est sélectionné ou si aucune liste de prix de vente n'est configurée pour le client.	`many2one` → product.pricelist
receipt_address	Adresse du ticket	`char`	calculé, stocké
receipt_footer	Pied de page du reçu : Un texte court qui sera inséré comme pied de page dans le ticket de reçu.	`text`
receipt_header	En-tête du reçu : Un texte court qui sera inséré comme en-tête dans le ticket de reçu.	`text`
receipt_printer_ids	Imprimantes de reçus	`many2many` → pos.printer
restrict_price_control	Limiter les modifications de prix aux managers Seuls les utilisateurs disposant des droits d'accès de manager dans l'application PdV peuvent modifier le prix d'un produit sur des commandes.	`boolean`
restrictive_employee_ids	Employees with restrictive level access Can process sales and close payments, but not apply discounts, refunds, or cancel orders.	`many2many` → hr.employee	ajouté par POS - HR (`pos_hr`)
rounding_method	Méthode d'arrondi	`many2one` → account.cash.rounding
route_id	Route spécifique pour les produits livrés ultérieurement.	`many2one` → stock.route	ajouté par PoS - Stock (`pos_stock`)
self_order_online_payment_method_id	Paiement en ligne autonome Le mode de paiement en ligne à utiliser lorsqu'un client paie une commande autonome en ligne.	`many2one` → pos.payment.method	ajouté par POS Self-Order / Online Payment (`pos_online_payment_self_order`)
self_ordering_available_language_ids	Langues disponibles Langues disponibles pour le mode kiosque	`many2many` → res.lang	ajouté par POS Self Order (`pos_self_order`)
self_ordering_default_language_id	Langue par defaut Langue par défaut pour le mode kiosque	`many2one` → res.lang	ajouté par POS Self Order (`pos_self_order`)
self_ordering_default_user_id	Utilisateur par défaut Les droits d'accès de cet utilisateur seront utilisés lors de la visite du site web de commande en libre-service lorsqu'aucune session n'est ouverte.	`many2one` → res.users	ajouté par POS Self Order (`pos_self_order`)
self_ordering_image_background_ids	Définir l’image d’arrière-plan Image à afficher en arrière-plan	`many2many` → ir.attachment	ajouté par POS Self Order (`pos_self_order`)
self_ordering_image_brand	Image de marque du kiosque de commande en libre-service Image à afficher sur l'écran de commande en libre-service	`image`	ajouté par POS Self Order (`pos_self_order`)
self_ordering_image_brand_name	Nom de l'image de marque du kiosque de commande en libre-service Nom de l'image à afficher sur l'écran de commande en libre-service	`char`	ajouté par POS Self Order (`pos_self_order`)
self_ordering_image_home_ids	Ajouter un média Éléments multimédias à afficher sur l'écran de commande en libre-service	`many2many` → ir.attachment	ajouté par POS Self Order (`pos_self_order`)
self_ordering_mode	Mode de commande en libre-service Choisir le mode de commande en libre-service	`selection`	requis Valeurs : `nothing` (Désactiver), `consultation` (Menu QR), `mobile` (Menu QR + Commande), `kiosk` (Kiosque) ajouté par POS Self Order (`pos_self_order`)
self_ordering_pay_after	Payer après : Choisir le moment où le client paiera	`selection`	requis Valeurs calculées dynamiquement ajouté par POS Self Order (`pos_self_order`)
self_ordering_primary_color	Couleur	`char`	ajouté par POS Self Order (`pos_self_order`)
self_ordering_service_mode	Mode de service de commande en libre-service Choisir le mode kiosque	`selection`	requis Valeurs : `counter` (Zone d'enlèvement), `table` (Table), `dynamic_qr` (Dynamic QR) ajouté par POS Self Order (`pos_self_order`)
self_ordering_url	URL de commande en libre-service	`char`	calculé ajouté par POS Self Order (`pos_self_order`)
session_closing_daily_hour	Daily Closing Hour The hour at which the session will be automatically closed when the closing mode is set to 'Daily'.	`float`
session_closing_mode	Closing Mode	`selection`	lecture seule Valeurs : `daily` (Quotidien), `closing` (At closing)
session_ids	Sessions	`one2many` → pos.session	inverse : `config_id`
set_maximum_difference	Fixer l'écart maximum Fixer l'écart maximum autorisé entre le montant attendu et compté à la fermeture de la session	`boolean`
set_tip_after_payment	Définir le pourboire après paiement Ajustez le montant autorisé sur les terminaux de paiement afin d’ajouter un pourboire après le départ des clients ou en fin de journée.	`boolean`
ship_later	Expédier plus tard	`boolean`	ajouté par PoS - Stock (`pos_stock`)
show_category_images	Afficher les images de la catégorie Afficher les images de la catégorie dans l'interface Point de Vente.	`boolean`
show_product_images	Afficher les images du produit Afficher les images du produit dans l'interface Point de Vente.	`boolean`
sms_receipt_template_id	Modèle de reçu SMS Le SMS sera envoyé au client sur la base de ce modèle.	`many2one` → sms.template	ajouté par POS - SMS (`pos_sms`)
statistics_for_current_session	Statistiques de session	`json`	calculé
status	Statut	`selection`	calculé Valeurs : `inactive` (Inactif), `active` (Actif) ajouté par POS Self Order (`pos_self_order`)
supervised_employee_ids	Employees with supervised level access Can process sales, but a higher level must approve before payment is closed	`many2many` → hr.employee	ajouté par POS - HR (`pos_hr`)
tax_regime_selection	Valeur de sélection du régime fiscal	`boolean`
tip_percentage_1	Pourcentage du pourboire 1	`integer`
tip_percentage_2	Pourcentage du pourboire 2	`integer`
tip_percentage_3	Pourcentage du pourboire 3	`integer`
tip_product_id	Produit de pourboire Ce produit est utilisé comme référence sur les tickets des clients.	`many2one` → product.product
trusted_config_ids	Configurations du Point de Vente sécurisé	`many2many` → pos.config
use_closing_entry_by_product	Écriture de clôture par produit Afficher la répartition des lignes de vente par produit dans l'écriture de clôture générée automatiquement.	`boolean`
use_course_allocation	Activer l’attribution des plats	`boolean`	ajouté par Restaurant (`pos_restaurant`)
use_custom_receipt_info	Personnaliser les infos À compléter si les informations de votre magasin diffèrent de celles de votre entreprise	`boolean`
use_download_invoice	Télécharger la facture Automatically download the invoice PDF when an order is invoiced.	`boolean`
use_fast_payment	Validation rapide du paiement Activez les modes de paiement rapides pour valider les commandes sur l’écran des produits.	`boolean`
use_header_or_footer	En-tête & pied de page personnalisés	`boolean`
use_order_printer	Imprimante de commandes	`boolean`
use_presets	Utiliser les préréglages	`boolean`
use_pricelist	Utiliser une liste de prix.	`boolean`
use_show_items_on_course_ticket	Show Items on Fired Course Ticket Show items again on the fired course ticket in preparation printer	`boolean`	ajouté par Restaurant (`pos_restaurant`)
uuid	UUID Un identificateur global et unique pour la configuration du PdV, utilisé pour éviter les conflits dans les données générées par les clients.	`char`	lecture seule
warehouse_id	Entrepôt	`many2one` → stock.warehouse	calculé, stocké ajouté par PoS - Stock (`pos_stock`)
website	Site web du ticket	`char`	calculé, stocké
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.cash.rounding : rounding_method
account.fiscal.position : default_fiscal_position_id, fiscal_position_ids
account.journal : closing_journal_id, journal_id
barcode.nomenclature : fallback_nomenclature_id
crm.team : crm_team_id
hr.employee : cashier_employee_ids, logged_employee_ids, manager_employee_ids, restrictive_employee_ids, supervised_employee_ids
ir.attachment : self_ordering_image_background_ids, self_ordering_image_home_ids
ir.sequence : device_seq_id, order_backend_seq_id, order_line_seq_id, order_seq_id
pos.bill : default_bill_ids
pos.category : iface_available_categ_ids
pos.config : trusted_config_ids
pos.note : note_ids
pos.payment.method : fast_payment_method_ids, payment_method_ids, self_order_online_payment_method_id
pos.preset : available_preset_ids, default_preset_id
pos.printer : preparation_printer_ids, receipt_printer_ids
pos.session : current_session_id, session_ids
pos.snooze : pos_snooze_ids
product.pricelist : available_pricelist_ids, pricelist_id
product.product : default_product_id, discount_product_id, down_payment_product_id, tip_product_id
res.company : company_id
res.currency : currency_id
res.groups : group_pos_manager_id, group_pos_user_id
res.lang : self_ordering_available_language_ids, self_ordering_default_language_id
res.partner : default_partner_id
res.users : current_user_id, self_ordering_default_user_id
restaurant.floor : floor_ids
sms.template : sms_receipt_template_id
stock.picking.type : picking_type_id
stock.route : route_id
stock.warehouse : warehouse_id

Champs d'autres modèles qui pointent ici

loyalty.program : pos_config_ids
pos_self_order.custom_link : pos_config_ids
pos.bill : pos_config_ids
pos.category : pos_config_ids
pos.config : trusted_config_ids
pos.details.wizard : pos_config_ids
pos.make.payment : config_id
pos.order : config_id
pos.payment.method : config_ids
pos.price.inclusion.wizard : config_id
pos.printer : pos_config_ids
pos.session : config_id
pos.snooze : pos_config_id
report.pos.order : config_id
res.config.settings : pos_config_id, pos_trusted_config_ids
restaurant.floor : pos_config_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/pos.config/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: votre-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","closing_journal_id","company_id","default_partner_id","default_product_id"],"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}/pos.config/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","closing_journal_id","company_id","default_partner_id","default_product_id"], "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/pos-config">pos.config (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