Importer des relevés bancaires dans Odoo n'est que la première étape. L'utilité réelle n'apparaît que lorsqu'un mouvement bancaire peut être associé de manière fiable à la bonne facture client, facture fournisseur, avoir ou paiement.
C'est précisément là qu'il manque à Odoo 19 Community une possibilité confortable dans l'interface utilisateur. Les lignes bancaires importées restent donc d'abord sur le compte d'attente bancaire et doivent être affectées à une écriture ouverte en vue de leur traitement ultérieur.
Pour notre propre installation Odoo 19 Community, nous avons donc développé le Bank Statement Matcher. Comme ce problème ne concerne pas que nous, nous mettons le module gratuitement à disposition sur GitHub sous la licence libre AGPL-3.
Accéder au projet sur GitHub :
Odoo 19 Bank Statement Matcher
De l'import du relevé bancaire à la bonne facture
Avec notre projet déjà publié Odoo 19 Bank Statement Import, différents formats de relevés bancaires peuvent être importés dans Odoo 19 Community. Cela comprend notamment CAMT.053, CAMT.054, OFX et SWIFT MT940.
Le nouveau Bank Statement Matcher complète cet import par l'étape de travail décisive suivante :
Quel mouvement bancaire importé correspond à quelle écriture ouverte ?
Le module parcourt les créances et les dettes ouvertes, évalue les correspondances possibles et indique aux utilisateurs pourquoi une affectation donnée est proposée. La proposition peut être vérifiée, confirmée, corrigée ou remplacée par une sélection manuelle.
Il en résulte pour Odoo 19 Community un flux de travail continu :
Importer le relevé bancaire
déterminer les affectations possibles
vérifier les propositions en lot
valider les correspondances sans ambiguïté
traiter manuellement les cas peu clairs
Ce que sait faire l'Odoo 19 Bank Statement Matcher
Le module a été développé pour un usage pratique en comptabilité. Il prend en charge notamment les fonctions suivantes :
recherche des factures, factures fournisseurs, avoirs et paiements correspondants
détermination automatique de propositions d'affectation lors de la création d'une ligne bancaire
affichage compréhensible de la règle d'affectation utilisée et de son niveau de fiabilité
nouvelle recherche à un moment ultérieur
affectation individuelle ou traitement groupé de plusieurs lignes bancaires
sélection manuelle d'une écriture ouverte lorsqu'aucune proposition ne convient
annulation d'une affectation déjà effectuée
détection de plusieurs correspondances équivalentes sans décision arbitraire
indications sur les devis ou commandes pour lesquels il n'existe pas encore d'écriture ouverte
transfert direct optionnel de l'import de relevés bancaires OCA vers la vue d'affectation
traduction allemande pour un code source en anglais
L'aperçu central est accessible dans Odoo sous Comptabilité → Comptabilité → Affectation des lignes bancaires. Les lignes bancaires encore ouvertes peuvent y être parcourues et traitées ensemble.
Une affectation traçable plutôt qu'une boîte noire
Pour les données financières, il ne suffit pas de proposer une correspondance quelconque. Les utilisateurs doivent pouvoir comprendre pourquoi un mouvement bancaire est censé correspondre à un document donné.
Le Bank Statement Matcher fonctionne donc avec des règles clairement définies et différents niveaux de confiance :
| Confiance | Règle | Signification |
|---|---|---|
| 100 | Référence | Un numéro de document, une référence de paiement ou une référence d'origine a été trouvé dans le libellé de l'écriture. |
| 80 | Partenaire et montant | Le partenaire commercial et le montant ouvert correspondent. |
| 60 | Montant unique | Le montant correspond exactement à une seule écriture ouverte. |
| 30 | Partenaire | Le partenaire correspond, mais pas le montant ; il ne s'agit que d'une indication. |
Pour chaque journal, on peut définir à partir de quel niveau de confiance une proposition sans ambiguïté peut être validée via l'action groupée. Les correspondances plus faibles restent visibles, mais doivent être vérifiées et confirmées individuellement.
Point important : le module ne comptabilise pas en arrière-plan sans surveillance. Il crée des propositions. Une affectation n'a lieu qu'à la suite d'une action délibérée de l'utilisateur – individuellement ou via le traitement groupé contrôlé.
Les références bancaires difficiles sont également prises en compte
Les banques ne transmettent pas toujours les références de paiement sous une forme uniforme. Un numéro de facture peut être associé à des noms, des chiffres ou d'autres informations. Les séparateurs peuvent manquer ou être représentés autrement que dans le document d'origine.
Le Matcher normalise donc les valeurs de comparaison et prend aussi en compte les transitions entre lettres et chiffres. Ainsi, des références peuvent par exemple être reconnues même lorsqu'elles ont été accolées directement à d'autres contenus dans le texte bancaire.
La recherche s'effectue volontairement du document Odoo vers le texte bancaire. Cela évite que de courtes suites de chiffres génériques du libellé de l'écriture ne conduisent à un grand nombre de correspondances inadaptées.
Les règles ne sont limitées ni à une banque particulière, ni à un pays donné, ni à un schéma de numérotation fixe. Cela rend le module intéressant aussi pour d'autres installations Odoo 19 Community.
Pourquoi une nouvelle recherche est importante
Tous les paiements bancaires ne peuvent pas être affectés dès l'import. En pratique, un paiement peut arriver avant que la facture correspondante ait été créée ou comptabilisée dans Odoo. Une facture fournisseur ou un avoir peut également n'être saisi que plus tard.
C'est pourquoi les lignes bancaires peuvent être revérifiées ultérieurement avec « Rechercher à nouveau ». Dès que l'écriture ouverte correspondante existe, un mouvement bancaire auparavant non affectable peut devenir une correspondance sans ambiguïté.
Si le texte bancaire mentionne par exemple un devis ou une commande pour lesquels il n'existe pas encore de facture, et donc pas d'écriture ouverte, le module fournit une indication utile. Au lieu d'afficher simplement « aucune correspondance », il signale qu'il faut éventuellement d'abord créer la facture.
La sécurité d'abord
Une affectation automatique erronée peut occasionner en comptabilité plus de travail qu'une ligne bancaire restée ouverte. Le Bank Statement Matcher a donc été volontairement conçu de manière prudente :
Les correspondances de même niveau ne sont pas départagées de manière arbitraire.
Les propositions faibles sont affichées, mais ne sont pas validées via l'action groupée.
Avant l'affectation, on vérifie à nouveau que l'écriture ouverte est toujours disponible.
Une écriture entre-temps soldée par un autre utilisateur n'est pas traitée une seconde fois.
Chaque ligne bancaire est traitée dans son propre point de sauvegarde de la base de données.
Une erreur sur une ligne bancaire n'empêche pas le traitement de toutes les autres lignes.
Les anciennes données incomplètes sans date de comptabilisation valide sont exclues par mesure de sécurité.
Le module soutient ainsi l'automatisation là où elle fait gagner du temps, et exige une décision manuelle là où les données ne sont pas assez claires.
Interaction avec notre Bank Statement Import
Le dépôt se compose de deux modules :
| Module | Fonction |
|---|---|
| account_statement_matcher | Fournit la recherche proprement dite, l'évaluation, la vérification et l'affectation. Nécessite uniquement le module Odoo account. |
| account_statement_matcher_import_oca | Pont optionnel vers l'import de relevés bancaires OCA. Après un import, la vue d'affectation avec les lignes nouvellement importées s'ouvre directement. |
Le pont optionnel s'installe automatiquement lorsque le Matcher et le module OCA account_statement_import_file sont tous deux présents. L'import de relevés bancaires et l'affectation qui suit s'enchaînent ainsi directement.
Vous trouverez plus d'informations sur l'import des formats bancaires pris en charge dans notre article :
Odoo 19 Bank Statement Import – nos extensions pour la communauté Odoo
Installation dans Odoo 19 Community
L'installation se déroule comme pour un module complémentaire Odoo ordinaire :
Copier les dossiers du module dans un chemin d'addons Odoo configuré.
Mettre à jour la liste des applications dans Odoo.
Installer le module Bank Statement Matcher.
Définir pour chaque journal bancaire si des propositions doivent être recherchées lors de l'import.
Choisir la valeur minimale souhaitée pour l'affectation groupée contrôlée.
Le module a été développé et testé pour Odoo 19.0 Community. Avant toute utilisation avec d'autres versions d'Odoo, il convient notamment de vérifier les modifications apportées aux fonctions internes de comptabilité et de rapprochement.
Comme pour toute extension dans le domaine comptable, nous recommandons de vérifier d'abord l'installation dans un environnement de test avec une copie de sa propre base de données et des relevés bancaires typiques.
Gratuit et open source pour la communauté Odoo
Chez Biricon IT Services GmbH, nous développons d'abord des solutions pour des besoins concrets de notre propre exploitation. Lorsqu'il en résulte un module d'usage général, nous ne souhaitons pas le cacher dans une seule installation.
L'Odoo 19 Bank Statement Matcher est donc disponible gratuitement en tant que projet open source. Le code source peut être consulté, vérifié, adapté et développé dans le cadre de la licence AGPL-3.
Notre objectif n'est pas d'automatiser à l'aveugle le plus grand nombre possible de décisions comptables. Nous voulons réduire le travail répétitif tout en veillant à ce que les affectations financières restent traçables et contrôlables.
Voilà comment nous concevons un développement open source pertinent : résoudre un problème réel, documenter la solution de manière transparente, puis la mettre à la disposition de la communauté.
Projet, code source et contribution
Le code source complet, les instructions d'installation et la documentation technique sont disponibles sur GitHub :
Ouvrir Odoo 19 Bank Statement Matcher sur GitHub
Nous apprécions les retours d'expérience, les rapports d'erreurs, les suggestions d'amélioration et les contributions de la communauté Odoo.
Gratuit. Traçable. Open source. Pour Odoo 19 Community.