Odoo 19.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 13 autres modules. Il expose 130 champs, dont 124 déclarés directement sur le modèle ; 15 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: 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_discount, pos_event, pos_sale, pos_hr, pos_restaurant, pos_loyalty, pos_online_payment, pos_self_order, pos_online_payment_self_order, pos_self_order_qfpay, pos_sms
Hérite de (mixins): pos.bus.mixin pos.load.mixinhr.mixin

Champs du modèle

124 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

130 champs affichés sur 130

Nom technique	Libellé	Type	Détails
access_token	Jeton d'accès	`char`
active	Actif	`boolean`
advanced_employee_ids	Employés ayant un accès de manager Les employés liés aux utilisateurs ayant le rôle de gestionnaire du PdV sont automatiquement ajoutés à cette liste	`many2many` → hr.employee	ajouté par PdV - RH (`pos_hr`)
adyen_ask_customer_for_tip	Demandez un pourboire à vos clients	`boolean`	ajouté par PdV 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_terminal_payment	Validation automatiquement paiement terminal Valide automatiquement des commandes payées par un terminal de paiement.	`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_employee_ids	Employés ayant un accès de base Si laissé vide, tous les employés peuvent se connecter au PdV	`many2many` → hr.employee	ajouté par PdV - RH (`pos_hr`)
basic_receipt	Reçu de base Imprimer un ticket de base sans prix. Peut être utilisé pour des cadeaux.	`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 des paiements en espèces	`boolean`
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 PdV - Ventes (`pos_sale`)
currency_id	Devise	`many2one` → res.currency	calculé, stocké
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é
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_preset_id	Préréglage par défaut	`many2one` → pos.preset
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	Pourcentage de remise Le pourcentage de remise par défaut en cliquant sur le bouton Remise	`float`	ajouté par Remises du point de vente (`pos_discount`)
discount_product_id	Produit de remise Le produit utilisé pour appliquer la remise sur le ticket.	`many2one` → product.product	ajouté par Remises du point de vente (`pos_discount`)
down_payment_product_id	Montant de l'acompte Ce produit sera utilisé comme acompte sur une commande.	`many2one` → product.product	ajouté par PdV - Ventes (`pos_sale`)
epson_printer_ip	IP de l'imprimante Epson Adresse IP locale d’une imprimante de reçus Epson, ou son numéro de série si l’option "Mise à jour automatique du certificat" est activée dans les paramètres de l’imprimante.	`char`
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`)
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 PdV Commande autonome (`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_cashdrawer	Tiroir caisse Ouvrir automatiquement le tiroir-caisse.	`boolean`
iface_discount	Remises de la commande Permettre au caissier de faire une remise sur la totalité de la commande.	`boolean`	ajouté par Remises du point de vente (`pos_discount`)
iface_electronic_scale	Balance électronique Permet d'activer l'intégration d'une balance électronique.	`boolean`
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_print_skip_screen	Passer l'écran de prévisualisation L'écran de reçu sera passé si le reçu peut être imprimé automatiquement.	`boolean`
iface_print_via_proxy	Imprimer via un proxy Contourner l'impression via le navigateur pour imprimer via le proxy matériel.	`boolean`
iface_printbill	Impression de l'addition Permet d'imprimer l'addition avant le paiement.	`boolean`	ajouté par Restaurant (`pos_restaurant`)
iface_scan_via_proxy	Scanner via Proxy Permet d'activer la lecture de codes-barres depuis un lecteur connecté à distance et le glissement de cartes avec un lecteur de cartes Vantiv.	`boolean`
iface_splitbill	Partage d'addition Autoriser le partage d'une addition au point de vente.	`boolean`	ajouté par Restaurant (`pos_restaurant`)
iface_tax_included	Affichage des taxes	`selection`	requis Valeurs : `subtotal` (Prix hors taxes), `total` (Montant toutes taxes comprises)
iface_tipproduct	Conseils d'utilisation	`boolean`
invoice_journal_id	Journal des factures Journal comptable utilisé pour la création de factures.	`many2one` → account.journal
is_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`
is_header_or_footer	En-tête & pied de page personnalisés	`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`
is_order_printer	Imprimante de commandes	`boolean`
is_posbox	PosBox	`boolean`
journal_id	Journal du point de vente Journal comptable utilisé pour poster les pièces comptables et les paiements de facture de la session de Point de Vente.	`many2one` → account.journal
last_data_change	Date de dernière écriture	`datetime`	lecture seulecalculé, stocké
last_session_closing_cash	Caisse à la fermeture de la dernière session	`float`	calculé
last_session_closing_date	Date de fermeture de la dernière session	`date`	calculé
limit_categories	Limiter les catégories	`boolean`
manual_discount	Remises appliquées à la ligne	`boolean`
minimal_employee_ids	Employés avec accès minimal Si laissé vide, tous les employés peuvent se connecter au PdV	`many2many` → hr.employee	ajouté par PdV - RH (`pos_hr`)
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`	requis
note_ids	Modèles de notes Notes prédéfinies de ce point de vente.	`many2many` → pos.note
number_of_rescue_session	Nombre de sessions de sauvetage	`integer`	calculé
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_edit_tracking	Suivi des modifications de commandes Stocker les commandes modifiées dans le backend	`boolean`
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 périphériques à votre PdV sans IoT Box.	`boolean`
payment_method_ids	Modes de paiement	`many2many` → pos.payment.method
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` (Aussi vite que possible), `one` (Quand tous les articles sont prêts)
picking_type_id	Type d'opération	`many2one` → stock.picking.type	requis
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é
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
printer_ids	Imprimantes de commandes	`many2many` → pos.printer
proxy_ip	Adresse IP Nom d'hôte ou adresse IP du proxy matériel. Laisser vide pour utiliser l’auto-détection.	`char`
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`
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`
rounding_method	Arrondi des paiements en espèces	`many2one` → account.cash.rounding
route_id	Route particulière pour les produits délivrés plus tard.	`many2one` → stock.route
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 Commande autonome PDV / Paiement en ligne (`pos_online_payment_self_order`)
self_ordering_available_language_ids	Langues disponibles Langues disponibles pour le mode kiosque	`many2many` → res.lang	ajouté par PdV Commande autonome (`pos_self_order`)
self_ordering_default_language_id	Langue par defaut Langue par défaut pour le mode kiosque	`many2one` → res.lang	ajouté par PdV Commande autonome (`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 PdV Commande autonome (`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 PdV Commande autonome (`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 PdV Commande autonome (`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 PdV Commande autonome (`pos_self_order`)
self_ordering_image_home_ids	Ajouter des images Image à afficher sur l'écran de commande en libre-service	`many2many` → ir.attachment	ajouté par PdV Commande autonome (`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 PdV Commande autonome (`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 PdV Commande autonome (`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) ajouté par PdV Commande autonome (`pos_self_order`)
self_ordering_url	URL de commande en libre-service	`char`	calculé ajouté par PdV Commande autonome (`pos_self_order`)
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 le paiement Ajustez le montant autorisé par les terminaux de paiement pour ajouter un pourboire après le départ des clients ou en fin de journée.	`boolean`	ajouté par Restaurant (`pos_restaurant`)
ship_later	Expédier plus tard	`boolean`
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 PdV - SMS (`pos_sms`)
statistics_for_current_session	Statistiques de session	`json`	calculé
status	Statut	`selection`	calculé Valeurs : `inactive` (Inactif), `active` (Actif) ajouté par PdV Commande autonome (`pos_self_order`)
tax_regime_selection	Valeur de sélection du régime fiscal	`boolean`
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_fast_payment	Validation rapide du paiement Activez les modes de paiement rapides pour valider les commandes sur l’écran des produits.	`boolean`
use_presets	Utiliser les préréglages	`boolean`
use_pricelist	Utiliser une liste de prix.	`boolean`
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é
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 : invoice_journal_id, journal_id
barcode.nomenclature : fallback_nomenclature_id
crm.team : crm_team_id
hr.employee : advanced_employee_ids, basic_employee_ids, minimal_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 : printer_ids
pos.session : current_session_id, session_ids
product.pricelist : available_pricelist_ids, pricelist_id
product.product : 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.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.printer : pos_config_ids
pos.session : 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 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/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","company_id","iface_tax_included","picking_policy","picking_type_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","company_id","iface_tax_included","picking_policy","picking_type_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 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