Documentation8 min de lecture

Relevés bancaires : import de fichiers, agrégateurs et rapprochement

Le module OCA `account_statement_import_online` (dépôt `bank-statement-import`, version 18.0.1.1.2, licence AGPL-3) fournit le cadre permettant d'**alimenter automatiquement les relevés bancaires par service en ligne**, avec son référentiel de **fournisseurs** — et six modules branchent chacun un service concret. Quatorze autres modules traitent l'import de tableurs, le CAMT.054 et le rapprochement.

Relevé bancaire consulté sur un écran

Saisir un relevé bancaire à la main est la tâche comptable la plus répétitive qui soit. L'import de fichiers la supprime à moitié : il reste à télécharger le fichier chaque semaine, dans le bon format, sur le bon portail.

Quinze modules communautaires couvrent les deux voies — le fichier et l'agrégateur. Ils terminent le dépôt bank-statement-import.

Résumé

Sept modules traitent l'alimentation en ligne : un cadre générique de fournisseurs de relevés, et six services concrets — un agrégateur Open Banking à interface gratuite, un agrégateur belge, deux plateformes de paiement, un service de change, et un agrégateur nord-américain.

Quatre modules traitent l'import de fichiers : le format tableur avec ses correspondances de colonnes — parce que ces fichiers n'ont aucune structure normalisée —, sa variante pour les fichiers en HTML déguisé en tableur, le CAMT.054 des avis de détail de paiements groupés, et la correction du rattachement de journal sur les fichiers OFX.

Quatre modules enfin traitent l'aval : le lien au rapprochement bancaire communautaire, la génération de lignes de relevé depuis des écritures existantes, la suppression en cascade des lignes avec le relevé, et le mode de calcul de l'index des lignes.

L'essentiel

  • Des relevés alimentés par service en ligne, sans téléchargement.
  • Six agrégateurs et plateformes branchés sur un cadre commun.
  • L'import de tableurs avec correspondance de colonnes paramétrable.
  • Les fichiers en HTML déguisé en tableur, un cas réel traité.
  • Le CAMT.054 : avis de détail des paiements groupés.
  • Le rattachement de journal corrigé sur les fichiers OFX.
  • Le lien au rapprochement bancaire communautaire.
  • Des lignes de relevé générées depuis des écritures existantes.

Ce que ces modules ajoutent à l'instance

FamilleModulesNombre
Cadre en ligneaccount_statement_import_online1
Servicesaccount_statement_import_online_gocardless, account_statement_import_online_ponto, account_statement_import_online_paypal, account_statement_import_online_stripe, account_statement_import_online_wise, account_statement_import_online_plaid6
Import de fichiersaccount_statement_import_sheet_file, account_statement_import_sheet_html_file, account_statement_import_camt54, account_statement_import_ofx_by_acctid4
Avalaccount_statement_import_file_reconcile_oca, account_statement_import_move_line, account_bank_statement_cascade_delete, account_statement_line_order4

Les menus : Facturation ▸ Configuration ▸ Banques ▸ Online Bank Statement Providers et Facturation ▸ Configuration ▸ Comptabilité ▸ Statement Sheet Mappings.

L'agrégateur plutôt que le fichier

L'import de fichier supprime la saisie mais pas la tâche : quelqu'un doit se connecter au portail de la banque, télécharger le relevé dans le bon format, et le déposer dans Odoo. Chaque semaine, pour chaque compte. L'agrégateur supprime l'étape entière.

account_statement_import_online fournit le cadre générique : un référentiel de fournisseurs de relevés en ligne, sous Facturation ▸ Configuration ▸ Banques ▸ Online Bank Statement Providers.

Six modules branchent un service concret sur ce cadre :

ModuleServiceNature
..._gocardlessGoCardless Bank Account DataAgrégation Open Banking, interface gratuite
..._pontoMyPonto.comAgrégateur, notamment comptes belges
..._plaidPlaid.comAgrégateur, orienté marché nord-américain
..._paypalPayPalPlateforme de paiement
..._stripeStripePlateforme de paiement
..._wiseWise (ex-TransferWise)Service de change et de comptes multidevises

La mention « interface gratuite » du premier module n'est pas un détail commercial : l'agrégation bancaire se facture généralement par compte et par mois, et c'est ce coût qui fait renoncer la plupart des PME. L'Open Banking européen a changé cette donne.

Les deux plateformes de paiement répondent à un autre besoin : rapprocher les encaissements en ligne, dont le relevé n'est pas bancaire mais fourni par le prestataire.

Les fichiers, dans la vraie vie

account_statement_import_sheet_file ajoute le format tableur — texte, CSV, tableur — à l'assistant d'import, avec un référentiel de correspondances de colonnes sous Facturation ▸ Configuration ▸ Comptabilité ▸ Statement Sheet Mappings.

Le README dit pourquoi ce module existe : ces fichiers n'ont aucune structure normalisée. Chaque banque, chaque plateforme exporte ses colonnes dans son ordre, avec ses libellés et son format de date. La correspondance paramétrable est la seule réponse praticable.

account_statement_import_sheet_html_file traite un cas que personne n'invente : des fichiers portant l'extension d'un tableur mais contenant en réalité du HTML. Le README le qualifie de cas fréquent.

  • account_statement_import_camt54 spécialise l'import CAMT.054 — les avis de détail de paiements groupés, typiquement les encaissements clients par lot.
  • account_statement_import_ofx_by_acctid corrige un problème de rattachement de journal sur les fichiers OFX dont l'identifiant technique de compte ne correspond pas au numéro de compte bancaire.

Le CAMT.054 est le format qui permet de rapprocher un encaissement groupé : la banque crédite un montant global, le fichier donne le détail client par client.

Les formats CAMT et OFX de base sont traités dans import de relevés bancaires CAMT et OFX.

Ce qui vient après l'import

account_statement_import_file_reconcile_oca est la colle entre l'import de fichiers et l'interface de rapprochement bancaire communautaire — celle qui remplace l'écran de rapprochement standard.

account_statement_import_move_line permet de générer des lignes de relevé depuis des écritures comptables existantes.

Le second répond à un cas de reprise : des encaissements comptabilisés sans relevé — par exemple une reprise d'historique — qu'il faut rattacher à un relevé pour les rapprocher. Sans lui, la reprise reste non rapprochée pour toujours.

  • account_bank_statement_cascade_delete supprime les lignes avec le relevé : sans lui, supprimer un relevé laisse ses lignes orphelines.
  • account_statement_line_order ajoute une option sur le journal bancaire modifiant le mode de calcul de l'index interne des lignes — donc leur ordre.

L'ordre des lignes compte plus qu'il n'y paraît : un relevé dont les lignes ne sont pas dans l'ordre chronologique rend le contrôle de solde progressif impossible.

L'interface de rapprochement communautaire est traitée dans account_reconcile_oca : le lettrage bancaire.

Limites connues

  • Les six services en ligne dépendent d'interfaces externes : un changement côté fournisseur casse le connecteur, et la correction vient du dépôt communautaire.
  • L'agrégation bancaire se facture généralement par compte et par mois : vérifier le modèle économique du service avant de s'engager, sauf pour l'interface Open Banking gratuite.
  • Un agrégateur accède à vos comptes bancaires : la question de la délégation d'accès et de la localisation des données se pose avant la question technique.
  • La correspondance de colonnes est à maintenir : une banque qui change son export casse l'import silencieusement.
  • account_statement_import_camt54 suppose le module CAMT de base installé.
  • account_statement_import_file_reconcile_oca suppose l'interface de rapprochement communautaire : elle remplace l'écran standard, ce qui est un choix d'ergonomie à instruire.
  • Le mode de calcul de l'index touche l'ordre des lignes existantes : à changer sur une base de recette d'abord.
  • La suppression en cascade est irréversible : c'est son objet, mais elle supprime des lignes rapprochées si le relevé est supprimé.

Identité technique

Les quinze modules viennent du dépôt OCA bank-statement-import, branche 18.0 — dont tous les modules sont désormais documentés ici —, tous en licence AGPL-3. Les dépendances internes : account_statement_import_base, account_statement_import_file, account_statement_import_camt, account_statement_import_ofx et account_statement_base. Les dépendances externes : account_reconcile_oca pour le rapprochement, web_widget_dropdown_dynamic pour un des services en ligne.

Voir aussi import de relevés bancaires CAMT et OFX et account_reconcile_oca : le lettrage bancaire.

Questions fréquentes

Peut-on alimenter les relevés bancaires d'Odoo automatiquement ?

Oui : account_statement_import_online fournit le cadre, et six modules branchent un service — un agrégateur Open Banking à interface gratuite, un agrégateur belge, deux plateformes de paiement, un service de change, un agrégateur nord-américain. L'import de fichier supprime la saisie mais pas la tâche de téléchargement hebdomadaire.

Pourquoi l'import de tableurs demande-t-il un paramétrage ?

Parce que ces fichiers n'ont aucune structure normalisée : chaque banque exporte ses colonnes dans son ordre, avec ses libellés et son format de date. account_statement_import_sheet_file fournit un référentiel de correspondances de colonnes, qui est la seule réponse praticable — et qu'il faut maintenir, une banque qui change son export cassant l'import silencieusement.

Que faire d'un fichier .xlsx qui est en réalité du HTML ?

account_statement_import_sheet_html_file traite exactement ce cas, que son README qualifie de fréquent : des fichiers portant l'extension d'un tableur mais contenant du HTML. Personne n'invente ce module — il existe parce que des banques exportent ainsi.

Comment rapprocher un encaissement groupé de plusieurs clients ?

Avec le format CAMT.054 et account_statement_import_camt54 : la banque crédite un montant global, le fichier donne le détail client par client. C'est le format des avis de détail de paiements groupés, typiquement les encaissements clients par lot.

Peut-on rapprocher des encaissements comptabilisés sans relevé ?

Oui, avec account_statement_import_move_line, qui génère des lignes de relevé depuis des écritures existantes. C'est le cas d'une reprise d'historique : sans ce module, ces encaissements restent non rapprochés pour toujours.

Se faire accompagner

Le rapprochement bancaire est la tâche comptable où l'automatisation rend le plus, et le choix décisif n'est pas technique : passer par un agrégateur signifie déléguer un accès à ses comptes bancaires. La question de la localisation des données et de la nature du prestataire se pose avant celle du format.

Nous instruisons donc ce point d'abord, puis nous mettons en place l'import de fichiers comme solution de repli — parce qu'un agrégateur indisponible ne doit pas arrêter la comptabilité. Voir les prestations d'Atalios Consulting ou demander un rappel.

Pour aller plus loin

En résumé

Saisir un relevé bancaire à la main est la tâche comptable la plus répétitive qui soit. L'import de fichiers la supprime à moitié : il reste à télécharger le fichier chaque semaine, sur le bon portail. Quinze modules couvrent les deux voies. Parlons de votre rapprochement.

Documentation OCAComptabilitéOdoo Community

Partager

Fiches connexes

Baies de serveurs dans une salle machine
Le module OCA `queue_job` (dépôt `queue`, version 18.0.3.4.1, licence LGPL-3) ajoute à Odoo une **file de travaux de fond** avec ses canaux, ses fonctions et ses tâches, sous le menu **File d'attente des tâches** : c'est la brique dont dépendent plus de quarante modules communautaires, et la première à surveiller en exploitation. Vingt-six autres modules traitent les composants, la configuration hors base, l'impression serveur et l'IoT.
Lire la suite
Documentation OCA, Exploitation
Câbles réseau branchés sur un commutateur
Le module OCA `endpoint` (dépôt `web-api`, version 18.0.1.1.4, licence LGPL-3) permet de **déclarer un point d'entrée HTTP depuis l'interface**, sous **Paramètres ▸ Technique ▸ Endpoints** : une adresse, une méthode, un traitement — sans écrire de module. Vingt-trois autres modules traitent le cache, les imports par sessions, les échanges de factures et l'agenda.
Lire la suite
Documentation OCA, Intégration
Import de relevés bancaires dans Odoo | Atalios