Bankafschriften in Odoo importeren is slechts de eerste stap. Het eigenlijke nut ontstaat pas wanneer een bankmutatie betrouwbaar aan de juiste verkoopfactuur, inkoopfactuur, creditnota of betaling kan worden gekoppeld.
Precies op dit punt ontbreekt in Odoo 19 Community een comfortabele mogelijkheid in de gebruikersinterface. Geïmporteerde bankregels blijven daardoor eerst op de tussenrekening van de bank staan en moeten voor verdere verwerking aan een openstaande boekingspost worden toegewezen.
Voor onze eigen Odoo 19 Community-installatie hebben we daarom de Bank Statement Matcher ontwikkeld. Omdat dit probleem niet alleen ons treft, stellen we de module gratis beschikbaar op GitHub onder de vrije AGPL-3-licentie.
Naar het project op GitHub:
Odoo 19 Bank Statement Matcher
Van bankafschriftimport tot de juiste factuur
Met ons reeds gepubliceerde project Odoo 19 Bank Statement Import kunnen verschillende bankafschriftformaten in Odoo 19 Community worden ingelezen. Daartoe behoren onder meer CAMT.053, CAMT.054, OFX en SWIFT MT940.
De nieuwe Bank Statement Matcher vult deze import aan met de volgende beslissende werkstap:
Welke geïmporteerde bankmutatie hoort bij welke openstaande post?
De module doorzoekt openstaande vorderingen en schulden, beoordeelt mogelijke treffers en toont de gebruikers waarom een bepaalde toewijzing wordt voorgesteld. Het voorstel kan worden gecontroleerd, bevestigd, gecorrigeerd of vervangen door een handmatige selectie.
Zo ontstaat voor Odoo 19 Community een doorlopende werkstroom:
Bankafschrift importeren
mogelijke toewijzingen bepalen
voorstellen gezamenlijk controleren
eenduidige treffers overnemen
onduidelijke gevallen handmatig verwerken
Wat de Odoo 19 Bank Statement Matcher kan
De module is ontwikkeld voor praktisch gebruik in de boekhouding. Ze ondersteunt onder meer de volgende functies:
zoeken naar passende facturen, inkoopfacturen, creditnota's en betalingen
automatische bepaling van toewijzingsvoorstellen bij het aanmaken van een bankregel
begrijpelijke weergave van de gebruikte toewijzingsregel en de zekerheid ervan
opnieuw zoeken op een later tijdstip
afzonderlijke toewijzing of gezamenlijke verwerking van meerdere bankregels
handmatige selectie van een openstaande post als geen voorstel past
ongedaan maken van een reeds uitgevoerde toewijzing
herkenning van meerdere gelijkwaardige treffers zonder willekeurige beslissing
aanwijzingen voor offertes of bestellingen waarvoor nog geen openstaande boekingspost bestaat
optionele rechtstreekse overdracht van de OCA-bankafschriftimport naar de toewijzingsweergave
Duitse vertaling bij Engelstalige broncode
Het centrale overzicht is in Odoo bereikbaar via Boekhouding → Boekhouding → Bankregeltoewijzing. Daar kunnen nog openstaande bankregels gezamenlijk worden doorzocht en verwerkt.
Navolgbare toewijzing in plaats van een black box
Bij financiële gegevens is het niet voldoende om zomaar een treffer voor te stellen. Gebruikers moeten kunnen zien waarom een bankmutatie bij een bepaald document zou horen.
De Bank Statement Matcher werkt daarom met duidelijk gedefinieerde regels en verschillende betrouwbaarheidsniveaus:
| Betrouwbaarheid | Regel | Betekenis |
|---|---|---|
| 100 | Referentie | Een documentnummer, betalingsreferentie of herkomstreferentie is gevonden in de boekingstekst. |
| 80 | Partner en bedrag | Zakelijke partner en openstaand bedrag komen overeen. |
| 60 | Eenduidig bedrag | Het bedrag komt exact overeen met slechts één openstaande post. |
| 30 | Partner | De partner klopt, maar het bedrag niet; dit is slechts een aanwijzing. |
Voor elk journaal kan worden vastgelegd vanaf welk betrouwbaarheidsniveau een eenduidig voorstel via de bulkactie mag worden overgenomen. Zwakkere treffers blijven zichtbaar, maar moeten afzonderlijk worden gecontroleerd en bevestigd.
Belangrijk hierbij: de module boekt niet onbeheerd op de achtergrond. Ze maakt voorstellen. Een toewijzing vindt pas plaats door een bewuste handeling van de gebruiker – afzonderlijk of via de gecontroleerde bulkverwerking.
Ook lastige bankreferenties worden meegenomen
Banken verzenden betalingsreferenties niet altijd in een uniforme vorm. Een factuurnummer kan gekoppeld zijn aan namen, cijfers of andere gegevens. Scheidingstekens kunnen ontbreken of anders worden weergegeven dan in het oorspronkelijke document.
De matcher normaliseert daarom de vergelijkingswaarden en houdt ook rekening met overgangen tussen letters en cijfers. Zo kunnen referenties bijvoorbeeld ook worden herkend als ze in de banktekst rechtstreeks aan andere inhoud zijn vastgeplakt.
Er wordt bewust gezocht van het Odoo-document naar de banktekst. Zo wordt voorkomen dat korte, algemene cijferreeksen uit de boekingstekst tot een groot aantal onpassende treffers leiden.
De regels zijn niet beperkt tot een bepaalde bank, een bepaald land of een vast nummeringsschema. Dat maakt de module ook interessant voor andere Odoo 19 Community-installaties.
Waarom opnieuw zoeken belangrijk is
Niet elke bankbetaling kan al bij de import worden toegewezen. In de praktijk kan een betaling binnenkomen voordat de bijbehorende factuur in Odoo is aangemaakt of geboekt. Ook een inkoopfactuur of creditnota kan pas later worden geregistreerd.
Daarom kunnen bankregels met “Opnieuw zoeken” op een later tijdstip nogmaals worden gecontroleerd. Zodra de passende openstaande post aanwezig is, kan van een eerder niet toewijsbare bankmutatie een eenduidige treffer worden.
Noemt de banktekst bijvoorbeeld een offerte of een bestelling waarvoor nog geen factuur en dus geen openstaande post bestaat, dan geeft de module een nuttige aanwijzing. In plaats van alleen “geen treffer” te tonen, wijst ze erop dat mogelijk eerst de factuur moet worden aangemaakt.
Veiligheid gaat voor
Een onjuiste automatische toewijzing kan in de boekhouding meer werk veroorzaken dan een openstaande bankregel. De Bank Statement Matcher is daarom bewust voorzichtig opgezet:
Even hoog beoordeelde treffers worden niet willekeurig opgelost.
Zwakke voorstellen worden getoond, maar niet via de bulkactie overgenomen.
Vóór het toewijzen wordt opnieuw gecontroleerd of de openstaande post nog beschikbaar is.
Een inmiddels door een andere gebruiker vereffende post wordt niet nogmaals verwerkt.
Elke bankregel wordt verwerkt binnen een eigen databasebewaarpunt (savepoint).
Een fout bij één bankregel verhindert de verwerking van alle andere regels niet.
Onvolledige oudere gegevens zonder geldige boekingsdatum worden voor de zekerheid uitgesloten.
Zo ondersteunt de module automatisering waar die tijd bespaart, en vraagt ze om een handmatige beslissing waar de gegevens niet eenduidig genoeg zijn.
Samenspel met onze Bank Statement Import
De repository bestaat uit twee modules:
| Module | Taak |
|---|---|
| account_statement_matcher | Biedt het eigenlijke zoeken, beoordelen, controleren en toewijzen. Vereist alleen de Odoo-module account. |
| account_statement_matcher_import_oca | Optionele brug naar de OCA-bankafschriftimport. Na een import wordt direct de toewijzingsweergave met de nieuw geïmporteerde regels geopend. |
De optionele brug installeert zich automatisch als zowel de matcher als de OCA-module account_statement_import_file aanwezig zijn. De bankafschriftimport en de daaropvolgende toewijzing grijpen daardoor rechtstreeks in elkaar.
Meer over de import van de ondersteunde bankformaten vindt u in ons bericht:
Odoo 19 Bank Statement Import – onze uitbreidingen voor de Odoo Community
Installatie in Odoo 19 Community
De installatie verloopt zoals bij een gebruikelijke Odoo-extramodule:
De modulemappen kopiëren naar een geconfigureerd Odoo-addonspad.
De app-lijst in Odoo bijwerken.
De module Bank Statement Matcher installeren.
Per bankjournaal vastleggen of bij de import naar voorstellen moet worden gezocht.
De gewenste minimumwaarde voor de gecontroleerde bulktoewijzing kiezen.
De module is ontwikkeld en getest voor Odoo 19.0 Community. Vóór gebruik met andere Odoo-versies moeten met name wijzigingen in de interne boekhoud- en afstemmingsfuncties worden gecontroleerd.
Zoals bij elke uitbreiding in het boekhoudgebied raden we aan de installatie eerst te controleren in een testomgeving met een kopie van de eigen database en typische bankafschriften.
Gratis en open source voor de Odoo Community
Wij bij Biricon IT Services GmbH ontwikkelen oplossingen eerst voor concrete eisen uit ons eigen bedrijf. Als daaruit een algemeen bruikbare module ontstaat, willen we die niet in één enkele installatie verbergen.
De Odoo 19 Bank Statement Matcher is daarom gratis beschikbaar als open-sourceproject. De broncode kan worden ingezien, gecontroleerd, aangepast en binnen de kaders van de AGPL-3-licentie verder worden ontwikkeld.
Ons doel is niet om zo veel mogelijk boekingsbeslissingen blindelings te automatiseren. We willen terugkerend werk verminderen en er tegelijk voor zorgen dat financiële toewijzingen navolgbaar en controleerbaar blijven.
Zo zien wij zinvolle open-sourceontwikkeling: een reëel probleem oplossen, de oplossing transparant documenteren en haar vervolgens ter beschikking stellen aan de community.
Project, broncode en medewerking
De volledige broncode, de installatie-instructies en de technische documentatie zijn beschikbaar op GitHub:
Odoo 19 Bank Statement Matcher openen op GitHub
We stellen praktijkervaringen, foutrapporten, verbetervoorstellen en bijdragen uit de Odoo Community zeer op prijs.
Gratis. Navolgbaar. Open source. Voor Odoo 19 Community.