Documentation9 min de lecture

account_invoice_import : importer les factures fournisseurs sans ressaisie

Relevé sur une instance Odoo 18 Community, le module OCA `account_invoice_import` (dépôt `edi`, version 18.0.1.3.0, licence AGPL-3) ajoute 1 modèle, 104 champs et 1 menu : il crée une facture fournisseur brouillon à partir d'un fichier PDF ou XML, mais ne sait lire aucun format sans un module complémentaire. Lesquels installer, comment préconfigurer un fournisseur récurrent, et ce que la réforme 2026 change.

Numérisation et traitement automatisé de factures fournisseurs

La saisie des factures fournisseurs est le poste le plus ingrat d'une comptabilité. account_invoice_import fournit l'assistant qui la supprime : on dépose un ou plusieurs fichiers, Odoo en extrait le fournisseur, les montants, la date, les lignes et l'IBAN, et crée les factures brouillon correspondantes.

Avec un avertissement à poser d'emblée : seul, ce module ne sait lire aucun format. C'est le moteur et l'interface ; il faut y ajouter au moins un module de format, sans quoi la liste des formats pris en charge reste vide.

L'essentiel

  • Un assistant « Import Supplier Invoice or Refund » qui accepte plusieurs fichiers PDF ou XML à la fois.
  • Modules de format requis : account_invoice_import_facturx, _ubl, _simple_pdf ou _invoice2data. Sans eux, rien n'est interprété.
  • Détection des doublons : une facture déjà en brouillon pour ce fournisseur et ce numéro est ignorée avec un avertissement.
  • Avoirs gérés, avec conversion automatique d'un montant négatif en avoir.
  • Préconfiguration par fournisseur : produit, compte, taxes, journal et libellé par défaut.
  • Import par e-mail possible, via une passerelle de messagerie entrante.

Ce que le module ajoute à l'instance

ÉlémentNombre
Modèles créés1
Modèles étendus6
Champs ajoutés104
Menus1
Vues5
Actions de fenêtre2
Groupes de droits0

Le seul modèle créé est account.invoice.import.partner.create, l'assistant qui rattache une facture importée à un partenaire. Les six modèles étendus sont account.invoice.import (l'assistant lui-même), account.journal, account.move, res.company, res.config.settings et res.partner — ce dernier portant la préconfiguration par fournisseur, qui est le vrai levier de fiabilité.

Assistant d'import de factures fournisseurs : la zone de dépôt des fichiers PDF ou XML et la liste des formats pris en charge
Assistant d'import de factures fournisseurs : la zone de dépôt des fichiers PDF ou XML et la liste des formats pris en charge

La liste « Supported formats » affichée dans l'assistant est le meilleur diagnostic du module : si elle est vide, aucun module de format n'est installé, et l'import échouera quel que soit le fichier déposé.

Où le trouver dans Odoo

Point d'entréeCe qu'il fait
Facturation ▸ Fournisseurs ▸ Importer des factures fournisseurOuvre l'assistant complet
Tableau de bord comptable, vignette du journal d'Achats : UploadCrée les factures immédiatement, sans passer par l'assistant
Facture importée sans fournisseur identifié : Create or Update PartnerRattache ou crée le partenaire

Le deuxième point d'entrée est le plus rapide au quotidien et le moins connu : déposer les fichiers directement sur la vignette du journal d'achats du tableau de bord crée les factures sans ouvrir d'écran.

Une précision documentaire qui évite une recherche inutile : le fichier d'aide du dépôt mentionne encore un bouton Import Invoice File sur la facture fournisseur, destiné à mettre à jour une facture brouillon existante — par exemple issue d'un bon de commande. Ce bouton n'existe plus dans le code de la version 18.0 ; il a été remplacé par Create or Update Partner, qui ne sert qu'à rattacher ou créer le partenaire.

Cas d'usage

Importer une ou plusieurs factures manuellement

  1. Comptabilité ▸ Fournisseurs ▸ Importer des factures fournisseur.
  2. Déposer un ou plusieurs fichiers dans PDF or XML Invoices to Import.
  3. Vérifier le champ Company si l'instance est en multi-sociétés.
  4. Cliquer sur Import.
  5. Odoo indique le nombre de factures créées et ouvre la liste — ou la fiche, s'il n'y en a qu'une — des factures brouillon à vérifier et à valider. Les fichiers correspondant à des factures déjà existantes sont listés dans un avertissement.

Préconfigurer un fournisseur récurrent

C'est l'étape qui transforme un import approximatif en import fiable, et elle se fait une fois par fournisseur. À réserver à ceux qui reviennent chaque mois : téléphonie, énergie, abonnements, loyers.

  1. Ouvrir la fiche du fournisseur, onglet contenant les informations de facturation.
  2. Dans le groupe Vendor Bills Import : renseigner soit Default Product, soit Default Expense Account + Default Taxes (ces deux derniers n'apparaissent que si aucun produit par défaut n'est choisi).
  3. Facultatif : Force Invoice Line Description, Force Single Invoice Line, Force Purchase Journal.
  4. Enregistrer.

Force Single Invoice Line est le réglage le plus utile sur les factures d'énergie et de télécommunications : il réduit une facture de quarante lignes de détail à une seule ligne comptable, ce qui est exactement ce que la comptabilité veut.

Rattacher une facture importée à un partenaire inconnu

  1. Ouvrir la facture brouillon issue d'un import sans partenaire identifié — un encadré d'avertissement apparaît en haut du formulaire.
  2. Cliquer sur Create or Update Partner, à côté du champ Partenaire.
  3. Vérifier les informations proposées dans l'assistant, puis valider.

Recevoir les factures par e-mail

Le cas d'une adresse dédiée — factures@… — à laquelle les fournisseurs envoient directement leurs pièces.

  1. Paramètres ▸ Technique ▸ E-mail ▸ Serveurs de messagerie entrants : configurer le serveur.
  2. Dans « Actions à effectuer sur les e-mails entrants », régler Create a new record sur le modèle account.invoice.import.
  3. En multi-sociétés, renseigner l'e-mail de la passerelle dans les paramètres de comptabilité.

Ce que la réforme 2026 change pour ce module

Depuis le 1er septembre 2026, les factures entre entreprises établies en France arrivent au format structuré et transitent par une plateforme agréée. Cela déplace l'intérêt de ce module, et il est honnête de le dire.

Origine de la factureCe qui la traiteFiabilité
Fournisseur français équipéLes modules de facturation électronique françaiseExacte — données structurées
Fournisseur hors de Franceaccount_invoice_import + module de formatÀ relire
Facture PDF résiduelleaccount_invoice_import_simple_pdf ou _invoice2dataÀ relire
Facture Factur-X reçue hors plateformeaccount_invoice_import_facturxBonne — XML embarqué

La première ligne va croître jusqu'au 1er septembre 2027, quand toutes les PME françaises émettront en électronique. Le périmètre de ce module se réduit donc aux fournisseurs étrangers et aux pièces résiduelles — ce qui reste utile, mais change l'ordre de grandeur. Voir la reconnaissance de factures en 2026 et ce qu'Odoo couvre nativement sur la réforme.

Configuration

  1. Installer account_invoice_import — aucune donnée de configuration n'est requise pour l'activer.
  2. Installer au moins un module de format : account_invoice_import_facturx, account_invoice_import_ubl, account_invoice_import_simple_pdf ou account_invoice_import_invoice2data. Sans eux, la liste « Supported formats » reste vide et rien ne s'importe.
  3. Préconfigurer le groupe Vendor Bills Import sur chaque fournisseur récurrent.
  4. Comptabilité ▸ Configuration ▸ Paramètres, section « Vendor Bills Import » : comptes d'ajustement débit et crédit, e-mail de la passerelle en multi-sociétés, création automatique du compte bancaire fournisseur.
  5. Pour l'import par e-mail : configurer le serveur de messagerie entrante et le pointer sur le modèle account.invoice.import.

Les comptes d'ajustement de l'étape 4 méritent une décision explicite : quand les montants extraits ne correspondent pas exactement au calcul d'Odoo — arrondis, taxe non retrouvée — le module ajoute une ligne d'ajustement. Sans comptes dédiés, ces écarts atterrissent n'importe où et personne ne les voit passer.

Côté droits, deux groupes sont impliqués : account.group_account_invoice pour l'accès complet à la configuration d'import sur le partenaire et au bouton Create or Update Partner, et account.group_account_readonly pour la lecture seule.

Limites connues

Le dépôt répertorie une limite technique : retirer la dépendance à base_iban et la déplacer dans un module de liaison séparé. Elle n'a pas d'incidence fonctionnelle, mais elle explique pourquoi base_iban s'installe avec le module.

Trois limites d'usage, plus importantes en pratique :

  • Aucun format n'est lu nativement. C'est la cause de la quasi-totalité des « ça ne marche pas » rapportés sur ce module.
  • Les factures importées restent en brouillon, et c'est voulu : il faut une relecture humaine. Un import n'est pas une comptabilisation.
  • La détection de doublons repose sur le couple fournisseur + numéro de facture. Un fournisseur qui renumérote, ou deux entités d'un même groupe avec des numérotations qui se recoupent, peuvent produire un faux positif — la facture est alors ignorée avec un simple avertissement.

La troisième limite est celle qui se découvre tard. Lisez l'avertissement de fin d'import : les fichiers ignorés y sont listés, et un fichier ignoré est une facture qui n'entrera jamais dans vos comptes.

Identité technique

Nom techniqueaccount_invoice_import
Dépôt OCAedi, branche 18.0
Version du module18.0.1.3.0
LicenceAGPL-3
Dépendancesaccount, base_business_document_import, base_iban
Modules de formataccount_invoice_import_facturx, _ubl, _simple_pdf, _invoice2data
Version Odoo18.0 Community

Questions fréquentes

Pourquoi mon import de facture échoue-t-il systématiquement ?

Parce qu'aucun module de format n'est installé. account_invoice_import est le moteur et l'interface ; il faut y ajouter account_invoice_import_facturx, _ubl, _simple_pdf ou _invoice2data. Le diagnostic est immédiat : si la liste « Supported formats » de l'assistant est vide, c'est cela.

Les factures importées sont-elles comptabilisées automatiquement ?

Non, elles sont créées en brouillon, et c'est volontaire : une relecture humaine reste nécessaire, notamment sur les lignes d'ajustement que le module ajoute quand les montants extraits ne correspondent pas exactement au calcul d'Odoo.

Comment éviter qu'une facture d'énergie crée quarante lignes comptables ?

Par le réglage Force Single Invoice Line dans le groupe « Vendor Bills Import » de la fiche fournisseur. C'est le paramètre le plus utile sur les factures de télécommunications et d'énergie, et il se pose une fois par fournisseur.

Ce module sert-il encore avec la facturation électronique obligatoire ?

Son périmètre se réduit : les factures de fournisseurs français équipés arrivent structurées par la plateforme agréée et sont traitées par les modules dédiés à la réforme. account_invoice_import reste utile pour les fournisseurs établis hors de France, les Factur-X reçus hors plateforme et les PDF résiduels.

Peut-on recevoir les factures directement par e-mail ?

Oui : configurez un serveur de messagerie entrante et réglez « Create a new record » sur le modèle account.invoice.import. Les factures envoyées à cette adresse créent alors des brouillons sans intervention. En multi-sociétés, renseignez l'e-mail de la passerelle dans les paramètres de comptabilité.

Pour aller plus loin

En résumé

account_invoice_import crée des factures fournisseurs brouillon depuis un PDF ou un XML — à condition d'installer un module de format, ce qui explique la quasi-totalité des échecs rapportés. Préconfigurez vos fournisseurs récurrents, posez des comptes d'ajustement, et lisez l'avertissement des fichiers ignorés. Parlons de vos factures fournisseurs.

Documentation OCAFacturation électroniqueComptabilité

Partager

Fiches connexes

Réunion d'approbation autour d'un document de travail
Relevé sur une instance Odoo 18 Community, le module OCA `base_tier_validation` (dépôt `server-ux`, version 18.0.3.5.1, licence AGPL-3) ajoute 1 modèle, 101 champs et 3 menus, mais ne s'active sur aucun document métier par lui-même : il lui faut un module d'implémentation. C'est le point qui surprend le plus — voici ce qu'il fait réellement, et comment le mettre en service.
Lire la suite
Documentation OCA, Odoo
Relevés bancaires et pièces comptables sur un bureau
Relevé sur une instance Odoo 18 Community, le module OCA `account_reconcile_oca` (dépôt `account-reconcile`, version 18.0.1.1.14, licence AGPL-3) ajoute 2 modèles, 87 champs et 17 vues : il remplace le lettrage limité de la Community par deux écrans dédiés, bancaire et par compte. Ce qu'il ajoute à l'instance, où le trouver, ses quatre cas d'usage et ses limites connues.
Lire la suite
Documentation OCA, Comptabilité