Documentation9 min de lecture

account_reconcile_oca : le lettrage bancaire d'Odoo Community

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.

Relevés bancaires et pièces comptables sur un bureau

Le rapprochement bancaire est le poste où une comptabilité de PME perd le plus de temps, et c'est précisément là que l'édition Community d'Odoo est la plus courte : son lettrage natif est fonctionnel mais pauvre, sans suggestion automatique ni écran dédié.

account_reconcile_oca est la réponse de la communauté. C'est le module central du dépôt account-reconcile : il fournit le moteur et l'interface, et sert de dépendance aux autres modules du lot (account_reconcile_due_date, account_reconcile_analytic_tag, account_reconcile_oca_add_default_filters).

L'essentiel

  • Deux écrans : lettrage bancaire ligne par ligne de relevé, et lettrage par compte ou partenaire pour les comptes marqués « à lettrer ».
  • Suggestion automatique des contreparties, via les modèles de rapprochement fournis par account_reconcile_model_oca.
  • Deux modes par journal : « Edit Move » (modifie l'écriture d'origine) ou « Keep Suspense Accounts » (passe par le compte d'attente).
  • Agrégation d'affichage configurable : par relevé, par jour, par semaine ou par mois.
  • Écarts de change gérés automatiquement quand plusieurs devises sont en jeu.
  • Licence AGPL-3, dépôt OCA account-reconcile, branche 18.0.

Ce que le module ajoute à l'instance

Relevé sur une instance Odoo 18 Community où le module est installé, avec ses dépendances.

ÉlémentNombre
Modèles créés2
Modèles étendus7
Champs ajoutés87
Menus1
Vues17
Actions de fenêtre9
Groupes de droits0

Les deux modèles créés sont account.account.reconcile (l'objet de lettrage lui-même) et account.account.reconcile.data, qui mémorise l'état de travail de chaque utilisateur sur un lettrage en cours. C'est ce second modèle qui permet d'interrompre un rapprochement et de le reprendre plus tard sans perdre sa sélection.

Les sept modèles étendus sont account.bank.statement, account.bank.statement.line, account.journal, account.move.line, account.reconcile.abstract, res.company et res.config.settings. Aucun groupe de droits n'est créé : l'accès repose sur les groupes comptables standard d'Odoo.

Écran de lettrage d'account_reconcile_oca : la ligne de relevé bancaire à gauche, les écritures proposées en contrepartie à droite, et le solde à équilibrer
Écran de lettrage d'account_reconcile_oca : la ligne de relevé bancaire à gauche, les écritures proposées en contrepartie à droite, et le solde à équilibrer

Où le trouver dans Odoo

Le module n'ajoute qu'un seul menu, mais il greffe des points d'entrée sur presque tous les écrans comptables — c'est ce qui fait sa commodité, et ce qui le rend difficile à trouver quand on cherche « le » menu.

Point d'entréeCe qu'il ouvre
Facturation ▸ Comptabilité ▸ LettrerL'écran de lettrage par compte, sur tous les comptes marqués « à lettrer »
Tableau de bord, carte d'un journal de banque : Reconcile X ItemsLe lettrage bancaire filtré sur ce journal
Tableau de bord, carte d'un journal : X to checkLes lignes marquées « à vérifier »
Fiche d'un compte lettrable : bouton ReconcileLe lettrage par compte, filtré sur ce compte
Fiche partenaire, menu Action : ReconcileLe lettrage filtré sur ce partenaire
Liste des écritures, menu Action : ReconcileLe lettrage préfiltré sur le compte sélectionné
Pièce comptable liée à un relevé : bouton Bank reconcileLa ligne de relevé correspondante

Les deux réglages se trouvent ailleurs : Comptabilité ▸ Configuration ▸ Paramètres, bloc « Bank & Cash », pour l'agrégation par défaut de la société ; et sur chaque fiche de journal de banque ou de caisse pour le Reconcile Mode et l'agrégation propre à ce journal.

Cas d'usage

Rapprocher les lignes d'un relevé bancaire importé

Le cas quotidien. Il suppose que le relevé a déjà été importé, par exemple avec les modules du dépôt bank-statement-import.

  1. Tableau de bord Comptabilité, sur la carte du journal de banque : cliquer sur Reconcile X Items.
  2. Dans la vue kanban, ouvrir la carte d'une transaction.
  3. Si une contrepartie a été suggérée par un modèle de rapprochement, vérifier les lignes du tableau en haut de l'écran.
  4. Sinon, onglet Reconcile : chercher et ajouter les écritures correspondantes (factures, paiements).
  5. S'il reste un écart — frais bancaires, arrondi — onglet Manual operation : renseigner compte, partenaire, libellé et montant, ou cliquer sur un badge de modèle de rapprochement proposé au-dessus des onglets.
  6. Quand le rapprochement est équilibré, cliquer sur Validate.

Basculer un journal en mode « comptes d'attente »

Le réglage qui change la nature des écritures produites, et qu'il faut trancher avec son expert-comptable avant les premiers rapprochements.

  1. Comptabilité ▸ Configuration ▸ Journaux, ouvrir le journal de banque.
  2. Champ Reconcile Mode : choisir Keep Suspense Accounts au lieu de Edit Move.
  3. Enregistrer.

En mode « Edit Move », la validation modifie directement l'écriture d'origine de la transaction. En mode « Keep Suspense Accounts », elle produit une écriture de contrepartie distincte via le compte d'attente du journal. Le second est plus verbeux et plus traçable ; le premier donne un grand livre plus lisible.

Lettrer un compte client ou fournisseur en souffrance

  1. Comptabilité ▸ Lettrer, ou depuis la fiche du partenaire, menu Action ▸ Reconcile.
  2. Ouvrir la carte correspondant au compte ou au partenaire.
  3. Onglet Reconcile : sélectionner les écritures à rapprocher entre elles (factures et paiements en attente).
  4. Quand le solde est équilibré, cliquer sur Reconcile.

Marquer une transaction « à vérifier » avant validation

Le cas à quatre mains : un comptable prépare, un responsable valide.

  1. Depuis l'écran de rapprochement d'une ligne, cliquer sur Set as Checked quand la proposition est satisfaisante mais mérite un second regard.
  2. Le relecteur retrouve ces lignes par le lien X to check sur la carte du journal, dans le tableau de bord.
  3. Après contrôle, il valide normalement — ou repasse la ligne en To Check.

Configuration

  1. Installer le module : account_reconcile_model_oca, account_statement_base et base_sparse_field s'installent automatiquement comme dépendances.
  2. Comptabilité ▸ Configuration ▸ Paramètres, bloc « Bank & Cash » : définir l'agrégation de lettrage par défaut de la société.
  3. Sur chaque journal de banque ou de caisse : choisir le Reconcile Mode et, si besoin, une agrégation spécifique (le champ requiert le groupe account.group_account_readonly).
  4. Donner aux utilisateurs concernés le groupe account.group_account_user ou supérieur.
  5. Configurer des modèles de rapprochement (module account_reconcile_model_oca) : sans eux, aucune suggestion automatique, et le module perd l'essentiel de son intérêt.

La cinquième étape est celle qu'on oublie, et c'est elle qui fait la différence entre un écran confortable et un gain de temps réel. Un modèle de rapprochement sur les frais bancaires récurrents, un autre sur les prélèvements d'abonnement : deux règles bien posées traitent la moitié d'un relevé automatiquement.

Limites connues

Le dépôt signale un défaut connu sur ce module : la création d'activités dans le chatter. C'est le seul point répertorié à ce jour, et il ne touche pas le lettrage lui-même.

Deux limites d'usage, observées et non répertoriées comme défauts :

  • Le choix du Reconcile Mode se fait par journal et change la forme des écritures produites. Le modifier après des mois d'exploitation crée deux périodes de grand livre qui ne se lisent pas de la même façon.
  • Les écrans reposent fortement sur du JavaScript. Sur une instance très chargée, ils demandent un gabarit serveur confortable — c'est l'un des cas où une lenteur ressentie vient du nombre de lignes affichées, pas du module.

Sur ce dernier point, voir les cinq causes réelles d'une lenteur Odoo.

Identité technique

Nom techniqueaccount_reconcile_oca
Dépôt OCAaccount-reconcile, branche 18.0
Version du module18.0.1.1.14
LicenceAGPL-3
Dépendancesaccount_reconcile_model_oca, account_statement_base, base_sparse_field
Version Odoo18.0 Community

Ce module fait partie du socle que nous déployons. Il est documenté chez nous au même titre que les 1 724 autres modules communautaires de notre base — voir comment choisir un module communautaire sans se tromper.

Questions fréquentes

Le lettrage d'Odoo Community est-il vraiment insuffisant sans ce module ?

Il est fonctionnel mais pauvre : pas d'écran dédié, pas de suggestion automatique de contrepartie, pas de gestion confortable des écarts. Sur quelques dizaines de lignes par mois, on s'en sort. Au-delà, account_reconcile_oca change la nature du travail — et c'est l'un des modules qui comblent le mieux l'écart avec l'édition Enterprise.

Quelle différence entre « Edit Move » et « Keep Suspense Accounts » ?

En mode « Edit Move », la validation du rapprochement modifie directement l'écriture d'origine de la transaction bancaire. En mode « Keep Suspense Accounts », elle génère une écriture de contrepartie distincte via le compte d'attente du journal. Le second est plus traçable, le premier donne un grand livre plus lisible : c'est une décision à prendre avec votre expert-comptable, et avant les premiers rapprochements.

Faut-il installer d'autres modules pour que les suggestions fonctionnent ?

account_reconcile_model_oca s'installe automatiquement comme dépendance, mais il faut ensuite créer des modèles de rapprochement. Sans eux, aucune suggestion n'apparaît. C'est l'étape de configuration la plus rentable et la plus souvent omise.

Peut-on reprendre un lettrage interrompu ?

Oui : le modèle account.account.reconcile.data mémorise l'état de travail par utilisateur. Vous pouvez quitter un rapprochement en cours et le reprendre avec votre sélection intacte, ce qui compte sur un relevé de plusieurs centaines de lignes.

Ce module gère-t-il les écarts de change ?

Oui, automatiquement, lorsque plusieurs devises sont en jeu dans un rapprochement. C'est un point à vérifier dans votre paramétrage de devises avant les premiers lettrages multidevises, car les écritures d'écart doivent atterrir sur les bons comptes.

Pour aller plus loin

En résumé

account_reconcile_oca donne à Odoo Community deux écrans de lettrage, bancaire et par compte, avec suggestions automatiques et gestion des écarts. Deux décisions à prendre avant de commencer : le Reconcile Mode de chaque journal, et les modèles de rapprochement — sans eux, le module reste un écran confortable au lieu d'un gain de temps. Parlons de votre rapprochement bancaire.

Documentation OCAComptabilitéOdoo

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
Poste de travail affichant un journal d'activité détaillé
Relevé sur une instance Odoo 18 Community, le module OCA `auditlog` (dépôt `server-tools`, version 18.0.2.0.9, licence AGPL-3) crée 7 modèles, 105 champs et 6 menus : il journalise créations, lectures, modifications, suppressions et exports sur n'importe quel modèle Odoo, avec les valeurs avant et après. Comment le paramétrer sans faire exploser la base, et la case à ne pas cocher à la légère.
Lire la suite
Documentation OCA, Odoo