Comment personnaliser vos factures Odoo :
Modèles, champs & design — Guide 2026

En 2026, la facture est à la fois un actif de marque et un objet de conformité

L'exercice 2026 a redéfini ce qu'une facture est censée faire. Ce n'est plus une simple demande de paiement statique—c'est un objet de données structurées consommé par les autorités fiscales, un point de contact identitaire que votre client voit au moment où l'argent est en jeu, et un enregistrement traitable par machine qui doit survivre aux audits, aux réseaux d'e-facturation et aux moteurs de rapprochement pilotés par IA. Odoo 19, avec la révélation d'Odoo 20 prévue lors des événements OXP en septembre 2026, est la version où les décisions de personnalisation cessent d'être cosmétiques et commencent à porter un vrai poids financier.

Le climat tarifaire rend le constat incontournable. Depuis avril 2026, les abonnements Enterprise encore sur des versions antérieures à v17 sont soumis à une surtaxe de 25 % pour version obsolète, qui s'ajoute à une hausse de 30 % sur le marché nord-américain et à une indexation annuelle de 7 %. Bien personnaliser ses factures aujourd'hui, c'est d'abord migrer vers une version supportée à jour, puis bâtir par-dessus les mises en page natives, les extensions Studio et l'héritage QWeb d'une manière qui survit aux deux prochaines mises à niveau.

Ce guide parcourt chaque couche de la personnalisation des factures en 2026 : le moteur de mise en page, les sections dynamiques, les champs personnalisés, l'éditeur de rapports Studio, l'ingénierie QWeb & XPath, l'e-facturation Peppol, les codes QR EPC, l'automatisation assistée par IA, et le manuel de dépannage pour les pannes qui cassent réellement les PDF en production.

Le paysage de migration 2026 : pourquoi votre stratégie facture commence par une décision de version

La feuille de route 2026 d'Odoo suit une stratégie de migration en trois vagues qui place la finance et la conformité en premier. La raison est simple : l'e-facturation obligatoire en Europe, dans certaines régions d'Amérique latine, dans le Golfe et chez une liste croissante d'acheteurs publics en Amérique du Nord exige que les documents financiers soient à la fois lisibles par l'humain et traitables par machine. Si vous personnalisez une facture sur une version obsolète, vous personnalisez un document qui ne correspond plus à l'intégrité structurelle des données qu'attend votre administration fiscale.

Côté développeur, le virage architectural se poursuit. Les endpoints d'intégration XML-RPC classiques sont désormais programmés pour suppression en v22, ce qui laisse aux équipes une fenêtre de transition pour migrer leurs systèmes externes qui consomment des données de factures vers le protocole JSON-2, plus efficace. Considérez cette fenêtre comme partie intégrante de votre stratégie facture, pas comme un projet séparé : c'est la façon dont les factures sont récupérées, signées et rendues en aval qui fait ou défait une migration.

Mise en page native : la fondation no-code dont hérite chaque facture

Avant de toucher au XML ou au Python, chaque facture Odoo doit être configurée au niveau de la Mise en page du document. C'est le moteur no-code qui définit l'identité visuelle partagée entre devis, commandes, factures et avoirs. Faites-le correctement et l'essentiel de votre travail de personnalisation disparaît.

Où la trouver

Allez dans Paramètres › Paramètres généraux › Sociétés › Mise en page du document puis cliquez sur Configurer la mise en page du document. La fenêtre modale expose quatre cadres de mise en page, chacun calé sur un rythme sectoriel différent :

Pas-à-pas : configurer la mise en page native

1. Ouvrez le tableau de bord — connectez-vous à l'environnement v19 et ouvrez le module Comptabilité ou Facturation.
2. Paramètres › Configuration — déroulez jusqu'au bloc Sociétés.
3. Configurer la mise en page du document — choisissez le cadre qui correspond à votre positionnement de marque.
4. Branding — uploadez un logo PNG ou SVG, fixez les couleurs primaire et secondaire via le sélecteur hex, choisissez l'alignement (gauche / centre / droite).
5. Typographie & arrière-plan — choisissez une police corporate (v19 a élargi le registre des polices riches ; pas besoin de CSS personnalisé dans la majorité des cas) et sélectionnez un style d'arrière-plan (Vide, Logo de démo, Upload personnalisé).
6. Slogan & pied de page — ajoutez la baseline de l'entreprise, les certifications (numéros ISO, statut B-Corp, etc.) et la mention légale du pied de page.
7. Continuer — sauvegarde les paramètres globaux et les applique à chaque document externe, dont les factures.

Odoo Studio : ajouter des champs personnalisés et éditer les rapports sans écrire de module

Studio occupe le terrain intermédiaire entre les paramètres natifs et le code complet. C'est l'outil adapté quand vous avez besoin d'un champ qui n'existe pas en standard, d'une colonne sur le PDF imprimé, ou d'un bloc conditionnel—sans le coût d'un module personnalisé livré en production.

Pas-à-pas : ajouter un champ personnalisé via Studio

1. Ouvrez une facture et cliquez sur l'icône clé à molette (Activer Studio) en haut à droite.
2. Choisissez la vue Formulaire ; Studio affiche une barre latérale avec les types de champs.
3. Glissez-déposez le type de champ dont vous avez besoin (Monétaire, Sélection, Many2One, Lié, etc.) sur le formulaire.
4. Configurez les propriétés :
   • Libellé — ex. « Éco-contribution »
   • Nom technique — Studio préfixe avec x_studio_
   • Visibilité — obligatoire, invisible ou pilotée par domaine
   • Pour les champs relationnels, fixez le modèle cible (par ex. res.users pour un commercial secondaire)
5. Fermez Studio — vous revenez à l'interface standard avec le champ en place.

L'éditeur de rapports Studio

L'éditeur de rapport PDF en v19 dévie de l'éditeur de formulaire. Au lieu de glisser des champs, vous composez les modèles avec des commandes slash et des blocs conditionnels :

QWeb & XPath : ingénierie de personnalisations qui survivent aux mises à niveau

Pour tout ce qui dépasse le plafond de Studio, la bonne réponse est l'héritage QWeb depuis un module personnalisé. La règle cardinale est la même qu'elle l'a toujours été : hériter, ne pas surcharger. Les éditions directes sur account.report_invoice_document sont effacées à chaque mise à niveau. Les modèles hérités survivent parce que l'ORM les applique en couche par-dessus la base.

Anatomie d'un rapport de facture personnalisé

Chaque rapport a deux pièces : un enregistrement ir.actions.report (les métadonnées) et un modèle QWeb (la structure). Le rapport de facture personnalisé minimum :

Pour un approfondissement orienté développeur sur les modèles de factures QWeb—numéros de PO, codes projet, instructions de virement, mises en page multi-sociétés, contenu conditionnel—voir notre guide compagnon Level Up Your Billing : A Step-by-Step Guide to Customizing Odoo Invoices.

<odoo>
  <record id="action_report_custom_invoice"
          model="ir.actions.report">
    <field name="name">Premium Invoice Template</field>
    <field name="model">account.move</field>
    <field name="report_type">qweb-pdf</field>
    <field name="report_name">
      my_module.custom_invoice_template
    </field>
    <field name="binding_model_id"
           ref="account.model_account_move"/>
  </record>

  <template id="custom_invoice_template"
            inherit_id="account.report_invoice_document">
    <xpath expr="//div[@name='reference']"
           position="after">
      <div t-if="o.x_customer_po"
           class="col-auto col-3 mw-100 mb-2">
        <strong>Customer PO:</strong>
        <p class="m-0" t-field="o.x_customer_po"/>
      </div>
    </xpath>
  </template>
</odoo>

Antisèche des positions XPath

Rendre des images binaires sur le PDF

L'obstacle technique numéro un en v19 sur les factures : les photos produits s'affichent dans l'aperçu web mais disparaissent du PDF. Le moteur wkhtmltopdf ne peut pas récupérer les champs binaires d'image comme le fait le navigateur. La parade est de les embarquer en base64 via le widget image :

<span t-esc="line.product_id.image_128"
      t-options="{
        'widget': 'image',
        'max_width': '64',
        'class': 'rounded'
      }"/>

Peppol, codes QR EPC et total en lettres : personnaliser pour la conformité

Le focus Wave 1 finance de 2026 est porté par l'e-facturation obligatoire. Personnaliser une facture sans intégrer Peppol, les codes QR EPC et les structures spécifiques aux locales, c'est livrer un travail incomplet—il échouera dès que vous expédierez à l'international ou onboarderez un client du secteur public.

Activer Peppol dans Odoo 19

1. Ouvrez Comptabilité › Configuration › Paramètres › Facturation électronique et cliquez sur Activer Peppol.
2. Fournissez l'identifiant d'endpoint Peppol (numéro de TVA ou GLN).
3. Pour chaque client, fixez le format e-facture sur l'onglet Comptabilité de la fiche contact (Factur-X, UBL, CII, etc.).
4. Lorsque la facture est envoyée, v19 attache automatiquement le XML structuré à côté du PDF.

Codes QR EPC / SEPA

1. Dans Comptabilité › Configuration › Paramètres, activez Codes QR sous Paiements clients.
2. Vérifiez que le journal bancaire porte à la fois IBAN et BIC.
3. Renseignez le champ Banque destinataire sur l'onglet Autres infos de la facture.
4. Odoo génère automatiquement le code QR EPC en bas du document imprimé ; les clients de la zone SEPA peuvent payer en scannant via leur appli bancaire.

Les équivalents régionaux sont supportés via les modules de localisation : Pix (Brésil), FPS (Hong Kong), VietQR (Vietnam) et les diverses localisations du CCG.

Total en lettres

Dans plusieurs juridictions, le total écrit en toutes lettres est une obligation légale destinée à empêcher la falsification après impression. Activez-le sous Comptabilité › Configuration › Paramètres › Factures clients › Afficher le total en lettres. Pour un contrôle par journal (forçage en majuscules, surcharges de langue pour les factures bilingues), plusieurs modules de qualité OCA exposent une configuration au niveau journal sans forker le cœur.

L'IA dans la facturation : OCR, Ask AI et vibe coding

Dans Odoo 19, l'IA est la couche d'interaction de l'ERP, pas un sidecar. Pour le travail facture, cela se traduit par trois capacités concrètes autour desquelles concevoir vos personnalisations :

• OCR + préférences d'apprentissage — le moteur qui digitalise les factures fournisseurs alimente aussi des modèles taillés par fournisseur. Les corrections manuelles entraînent un profil par fournisseur qui s'améliore avec l'usage.
• Agent Ask AI — Ctrl + K ou le bouton de la barre supérieure ; requêtes conversationnelles sur les données de facturation, synthèse de l'historique de litige, traduction automatique des messages du chatter, recherche sémantique (« trouve la facture de l'audit ESG de septembre dernier »).
• Vibe coding & génération d'images (v19.2) — décrivez un portail ou une mise en page de document en langage naturel, générez des visuels produits directement dans l'ERP. Les mêmes images produits coulent automatiquement dans vos modèles de factures personnalisés.

Quand vous concevez des champs de facture personnalisés, préférez des champs bien nommés et bien typés à des dépôts de Char en texte libre. L'agent Ask AI et le moteur de modèles OCR raisonnent sur vos données via les libellés et les types de champs—nommer un champ x_customer_po_number avec un texte d'aide donne une automatisation nettement meilleure que x_studio_field_4d2a1.

Trois pièges de production qui cassent la personnalisation des factures

Le parcours (e-)facturation de l'Odoo Academy

Le parcours 2026 de l'Academy sur l'e-facturation est structuré comme une progression de 2 heures 2 minutes qui amène les équipes des fondations base de données jusqu'à Peppol, en passant par les localisations régionales (Vietnam Form 01/GTGT, CCG/Arabie saoudite, etc.) et la transmission par le comptable. Il se marie bien avec ce guide comme compagnon pratique — cours complet sur Odoo Academy : (e-)facturation.

Ouvrir le cours Odoo Academy : (e-)facturation →