Open source betekent voor ons: kennis en oplossingen delen

We ontwikkelen niet alleen software voor onze eigen behoeften – we willen ook oplossingen beschikbaar stellen aan de community die andere Odoo-gebruikers kunnen helpen.

Daarom hebben we onze modules voor het importeren van bankafschriften in Odoo 19 Community als opensourceproject gepubliceerd.

Het volledige project is gratis beschikbaar op GitHub:

Odoo 19 Bank Statement Import op GitHub

Ons doel is heel eenvoudig:

Een goed werkende en zo eenvoudig mogelijke manier bieden om bankafschriften in Odoo 19 Community te importeren – zonder dat daarvoor een betaalde uitbreiding nodig is.

Waarom eigenlijk een eigen project?

Odoo biedt in principe uitgebreide mogelijkheden voor de boekhouding en het verwerken van banktransacties. Maar juist bij het importeren van bankafschriften is het van belang welke bestandsformaten de betreffende bank aanbiedt.

In de praktijk kom je daarbij onder meer de volgende formaten tegen:

• CAMT.053
• CAMT.054
• OFX
• SWIFT MT940

Niet elk van deze formaten wordt in elke Odoo-versie in dezelfde mate ondersteund.

Vooral bij de overstap naar Odoo 19 merkten we dat er functionaliteit ontbrak die voor bestaande installaties wel degelijk van belang kan zijn.

In plaats van deze problemen alleen voor onze eigen installatie op te lossen, hebben we daarom besloten de oplossing openbaar en gratis beschikbaar te stellen.

Odoo 19 Community – Bankafschriften importeren

Onze repository is gebaseerd op de bijbehorende OCA-componenten voor Odoo 19 en vult deze aan met functies die nodig zijn voor gebruik in de praktijk.

Het project bevat onder meer de basisinfrastructuur voor bankafschriften en bestandsimport, evenals parsers voor verschillende bankformaten.

Hiermee kunnen bijvoorbeeld de volgende formaten worden verwerkt:

Daarmee ondersteunt het project een groot deel van de gangbare formaten voor bankafschriften.

OFX-ondersteuning voor Odoo 19

Een bijzonder kenmerk van ons project is de OFX-ondersteuning.

OFX was beschikbaar in oudere Odoo/OCA-versies, maar is uit de OCA-19.0-branch verwijderd. Ons project brengt deze functionaliteit voor Odoo 19 weer samen met de overige importmodules.

Dat is vooral interessant voor bedrijven waarvan de bank nog steeds OFX-bestanden voor elektronische bankafschriften aanbiedt.

Daarbij wilden we niet zomaar een volledig nieuwe, op zichzelf staande oplossing ontwikkelen.

In plaats daarvan hebben we voortgebouwd op de bestaande opensourcebasis en de onderdelen samengebracht voor Odoo 19.

Ook beschikbaar: SWIFT MT940

Een andere functie van ons project is het importeren van SWIFT MT940.

MT940 is een gangbaar formaat voor elektronische bankafschriften en wordt nog steeds gebruikt, met name door banken en in oudere bankintegraties.

Volgens onze projectdocumentatie is er voor de huidige Odoo-versies geen bijbehorende OCA-oplossing beschikbaar.

Daarom hebben we hiervoor een eigen module ontwikkeld:

account_statement_import_mt940

Hiermee kunnen ook MT940-bestanden rechtstreeks in Odoo 19 worden verwerkt.

Modulair opgebouwd

We hebben er bewust voor gekozen geen monolithische uitbreiding te ontwikkelen.

De functies zijn verdeeld over afzonderlijke Odoo-modules:

• account_statement_base
• account_statement_import_base
• account_statement_import_file
• account_statement_import_camt
• account_statement_import_camt54
• account_statement_import_ofx
• account_statement_import_ofx_by_acctid
• account_statement_import_mt940

Zo kunnen gebruikers precies de componenten installeren die ze daadwerkelijk nodig hebben.

Dat sluit ook aan bij de opensourcegedachte: een oplossing mag niet onnodig ingewikkeld worden, alleen omdat gebruikers verschillende behoeften hebben.

Gratis voor de Odoo Community

Misschien wel het belangrijkste:

De software is gratis beschikbaar.

We stellen de door ons ontwikkelde uitbreidingen beschikbaar aan de Odoo Community.

Voor het gebruik van onze uitbreidingen zijn geen licentiekosten verschuldigd.

De broncode is openbaar beschikbaar op GitHub en kan daar worden bekeken, gebruikt, aangepast en verder ontwikkeld.

Het project valt onder de AGPL-3-licentie, overeenkomstig de gebruikte OCA-basis.

Waarom doen we dit?

Open source werkt op de lange termijn alleen als mensen niet alleen nemen, maar ook iets teruggeven.

De Odoo Community Association (OCA) werkt vanuit precies die gedachte en stelt tal van uitbreidingen voor Odoo als open source beschikbaar. Ook voor het importeren van bankafschriften is er een uitgebreide verzameling communitymodules.

Daar willen wij ons steentje aan bijdragen.

We profiteren zelf van opensourceprojecten.

Dus geven we ook iets terug.

Een opensourceproject hoeft daarbij niet altijd een enorm framework of een compleet nieuw ERP-systeem te zijn.

Soms is een kleine uitbreiding die een concreet probleem oplost al genoeg.

Als die oplossing vervolgens tien, honderd of duizend andere Odoo-gebruikers werk bespaart, is de ontwikkeling al de moeite waard geweest.

Voor Odoo Community – niet alleen voor onze eigen installatie

Bij de ontwikkeling vonden we het belangrijk om de modules niet specifiek op onze eigen omgeving af te stemmen.

We willen dat de repository ook interessant is voor andere installaties van Odoo 19 Community.

Daarom staan de modules samen in een openbaar toegankelijke repository en kunnen ze onafhankelijk van onze eigen Odoo-installatie worden gebruikt.

Natuurlijk kan elke bank, afhankelijk van het exportformaat, haar eigen bijzonderheden hebben. Daarom zijn ook feedback, foutmeldingen en verbeteringen vanuit de community welkom.

Open source leeft van actieve deelname

Het project is nadrukkelijk niet bedoeld als een afgerond geheel.

Wie een fout vindt, een aanvullende toepassing heeft of een verbetering wil bijdragen, kan rechtstreeks aan het project meewerken.

Dat is een van de grote voordelen van open source:

De doorontwikkeling van een oplossing hoeft niet beperkt te blijven tot de oorspronkelijke ontwikkelaar.

Een gebruiker kan ontwikkelaar worden.

Een ontwikkelaar kan een verbetering bijdragen.

En die verbetering is vervolgens weer voor iedereen beschikbaar.

Installatie en broncode

De volledige broncode, de modulestructuur en de installatie-instructies zijn te vinden op GitHub:

GitHub – Odoo 19 Bank Statement Import

Voor het importeren van OFX en MT940 zijn daarnaast de bijbehorende Python-bibliotheken nodig. De specifieke afhankelijkheden zijn ook in de repository gedocumenteerd.

Onze bijdrage aan de Odoo-community

Met dit project willen we een bescheiden signaal afgeven:

Software hoeft niet altijd verkocht te worden om de ontwikkeling ervan waardevol te maken.

Soms levert een oplossing het meeste op als die vrij toegankelijk is en door zoveel mogelijk mensen gebruikt en verder ontwikkeld kan worden.

We ontwikkelen de software in de eerste plaats omdat we zelf een oplossing nodig hebben.

Als daar vervolgens een bruikbare uitbreiding voor andere Odoo-gebruikers uit voortkomt, stellen we die graag beschikbaar aan de community.

Precies daarom hebben we de Odoo 19 Bank Statement Import Module gepubliceerd.

Gratis. Open source. Voor de Odoo-community.

Project op GitHub

Naar het GitHub-project: Odoo 19 Bank Statement Import

Feedback, issues, verbetervoorstellen en natuurlijk ook bijdragen vanuit de community zijn van harte welkom.

Open source werkt het beste als we er samen aan werken.