Odoo-koppelingen in België: API, connectoren en integraties

Wie op zoek is naar een Odoo-connector, heeft meestal een concreet probleem: gegevens worden nog handmatig overgetypt tussen Odoo en een webshop, een bankpakket, een transportsoftware of het boekhoudkantoor. Dat kost tijd en levert fouten op. Een goede integratie met Odoo lost dat op, maar alleen als vooraf duidelijk is welke gegevens wanneer, in welke richting en onder wiens verantwoordelijkheid uitgewisseld worden.

Op deze pagina overlopen we de manieren waarop Odoo met andere systemen praat, welke koppelingen Belgische bedrijven het vaakst nodig hebben en hoe u een flux cadreert voor u een offerte aanvaardt.

Hoe Odoo met andere systemen communiceert

Er zijn grofweg vier routes, van licht naar zwaar.

1. Ingebouwde koppelingen in de standaardmodules, bijvoorbeeld betaalproviders of verzendmethodes.
2. Extensies uit de Odoo-appstore of van de gemeenschap.
3. Een tussenplatform (integratieplatform of automatiseringstool) dat Odoo met meerdere pakketten verbindt.
4. Een maatkoppeling via de API, geschreven door uw integrator.

Welke route past, hangt af van het aantal systemen, de kritiekheid van de gegevens en de verwachte veranderingen. Een koppeling met de webshop die dagelijks bestellingen binnenhaalt, vraagt een andere aanpak dan een eenmalige import van klantgegevens.

De Odoo API: JSON-2 als referentie

De API van Odoo is de basis van elke maatkoppeling. In de documentatie van de externe API presenteert Odoo JSON-2 als de huidige API. Ze werkt met API-sleutels, toegangsrechten, de keuze van de database en transacties. XML-RPC en JSON-RPC worden er als historisch behandeld, met een migratiegids naar JSON-2.

Praktisch betekent dat drie dingen:

• Laat een nieuwe koppeling bouwen op JSON-2, niet op de oudere protocollen.
• Bestaande koppelingen die nog op XML-RPC of JSON-RPC draaien, verdienen een plek op uw planning voor de volgende versiewissel. Lees daarvoor ook de pagina over Odoo-versies en -edities.
• Een API-sleutel is gekoppeld aan een gebruiker en zijn rechten. Maak voor elke koppeling een eigen technische gebruiker met enkel de rechten die nodig zijn, en nooit een sleutel op naam van een medewerker.

De API is een kwestie van formule

Let op de licentie. Volgens de prijspagina van Odoo behoort de externe API tot de functies van de formule Custom. Die formule kost 44,90 EUR per gebruiker en per maand (met een kortingstarief van 56,90 EUR dat twaalf maanden geldt voor de bij de start bestelde gebruikers), met hosting op Odoo Online, Odoo.sh of op eigen server; de kosten van Odoo.sh zijn daar niet in begrepen. De formule Standaard kost 24,90 EUR per gebruiker en per maand, de gratis formule One App Free is beperkt tot één toepassing.

Voor wie vandaag in een lagere formule werkt en later een maatkoppeling wil, is dat een budgetpunt dat vaak over het hoofd wordt gezien. De volledige logica van de tarieven vindt u bij Odoo-prijzen.

Een tweede nuance: betalende gebruikers zijn de gebruikers met toegang tot de backend. Portaalgebruikers, zoals klanten en leveranciers, tellen volgens Odoo niet mee als betalend. Dat is relevant als u een extern portaal of een klantenplatform wilt laten samenwerken met uw gegevens.

Appstore en gemeenschap: veel aanbod, wisselende kwaliteit

Odoo spreekt van vijftig hoofdtoepassingen, en van een gemeenschap die meer dan vijftigduizend extra toepassingen heeft bijgedragen. Dat aanbod is groot, maar niet uniform. Een extensie uit de gemeenschap is geen product van Odoo zelf en wordt niet noodzakelijk bijgehouden bij elke nieuwe versie.

Stel bij elke extensie deze vragen voor u ze installeert:

• Wie onderhoudt ze, en is dat onderhoud contractueel afgesproken?
• Is ze beschikbaar voor de versie waarmee u werkt, en voor de volgende?
• Onder welke licentie wordt ze verspreid, en past dat bij uw hostingkeuze? De Community-versie staat onder LGPLv3, terwijl de Enterprise-versie onder de licentie Odoo Enterprise Edition v1.0 valt en enkel mag gebruikt worden met een geldig Enterprise-abonnement voor het juiste aantal gebruikers.
• Raakt ze aan de standaardtabellen, en maakt ze een latere migratie van Odoo moeilijker?

Een extensie die niemand opvolgt, wordt bij de volgende versie vaak de reden waarom een upgrade stokt. Zie ook de overzichtspagina over Odoo-modules voor wat al standaard aanwezig is.

Welke koppelingen Belgische bedrijven het vaakst nodig hebben

Onderstaande tabel groepeert de gebruikelijke koppelingen. Ze toont de aard van de flux, niet een vaste oplossing: de concrete aanpak hangt af van uw pakket en van de versie van Odoo.

E-commerce: de ingebouwde route eerst bekijken

De module Odoo eCommerce beheert volgens de documentatie catalogus en varianten, klantenaccounts, B2B en B2C, verlaten winkelmandjes, leveringswijzen, retours en facturatie, met ondersteuning voor meerdere websites. Ze koppelt aan meer dan twintig betaalproviders, waaronder Stripe, PayPal, Adyen en Mollie, en verspreidt producten via Google Merchant Center, TikTok, Facebook of Instagram.

Dat betekent dat een webshop die u rechtstreeks in Odoo bouwt, geen aparte connector nodig heeft: bestelling, voorraad en factuur staan in dezelfde database. Een connector komt pas in beeld als u al een bestaande shop op een ander platform hebt, of als u via marktplaatsen verkoopt die elk hun eigen formaat hanteren. Meer over de sectorkant leest u op ERP voor e-commerce.

Voor Vlaamse webwinkels is vooral de betaalmethode belangrijk: Bancontact is in België de verwachte keuze, dus controleer bij de keuze van de provider of die methode beschikbaar is en hoe de terugbetaling wordt afgehandeld.

Bank, boekhouding en btw

De financiële koppelingen zijn in België de gevoeligste, omdat de btw-aangifte en de jaarrekening ervan afhangen. Binnen de boekhouding en financiën van Odoo worden bankuittreksels ingelezen en afgepunt met openstaande facturen. Belgische bedrijven werken daarvoor traditioneel met CODA-bestanden, die de bank aanlevert.

Drie aandachtspunten:

• Afpuntregels: hoe beter de mededeling op de factuur (gestructureerde mededeling), hoe hoger het percentage dat automatisch wordt afgepunt. Spreek dat af voor u de koppeling afwerkt.
• De boekhouder: vele Belgische kmo's laten de aangifte door een extern kantoor opstellen. Spreek af of het kantoor rechtstreeks in Odoo werkt, of exportbestanden ontvangt, en wie het formaat valideert. Achtergrond bij de aangifte vindt u in onze gids over btw in België en ERP.
• Rechten: een externe boekhouder heeft doorgaans enkel leesrechten of beperkte boekingsrechten nodig. Geef niet meer dan dat.

Peppol en elektronische facturatie

Voor zakelijke facturen is elektronische uitwisseling via Peppol een vast thema geworden. De vraag is niet alleen of Odoo Peppol-berichten kan versturen en ontvangen, maar ook hoe dat past in uw bestaande processen: wie bewaakt de afgekeurde berichten, wat gebeurt er met aankoopfacturen die binnenkomen, en wie keurt ze goed?

Onze gids over Peppol en e-facturatie legt de Belgische context uit. Voor de koppeling zelf geldt: laat uw integrator schriftelijk vastleggen welke berichttypes u gebruikt, welk toegangspunt actief is en hoe de ontvangen facturen in de goedkeuringsstroom terechtkomen. De wettelijke kant staat in de gids over wettelijke verplichtingen voor ERP.

BI, EDI en handtekening

Voor rapportage kiezen veel bedrijven een BI-tool naast Odoo. Dat kan via de API, of via een gerepliceerde kopie van de gegevens voor zware analyses. Het tweede voorkomt dat dashboards de productiedatabase vertragen, maar vraagt een extra beheerde stap. Kies op basis van het aantal gebruikers van het dashboard en de gewenste verversingsfrequentie, niet op basis van wat modieus is.

Bij EDI gaat het om gestructureerde berichten met grote afnemers of distributeurs. Hier bepaalt de klant het formaat; u past zich aan. Reken op een tussenlaag die berichten omzet, valideert en bij fout terugmeldt.

Voor elektronische handtekening op offertes of contracten vraagt u eerst of een eenvoudige handtekening volstaat of dat uw sector een strengere vorm vereist. Dat is een juridische vraag, geen technische.

Een integratieflux cadreren: de vragen die u moet kunnen beantwoorden

Een offerte voor een koppeling is pas vergelijkbaar als elke kandidaat dezelfde vragen heeft beantwoord. Gebruik deze lijst als programma van eisen voor één flux:

1. Bron van waarheid: welk systeem is leidend voor klanten, producten, prijzen en voorraad?
2. Richting: eenrichting of tweerichting? Tweerichtingsverkeer vergroot het risico op conflicten.
3. Moment: realtime, per interval of op aanvraag? Niet elke flux moet direct lopen.
4. Volume en pieken: denk aan uitverkoop of seizoenspieken.
5. Foutafhandeling: wat gebeurt er als het externe systeem niet bereikbaar is? Wie krijgt de melding?
6. Gegevenskwaliteit: welke velden zijn verplicht, welke codes moeten omgezet worden?
7. Beveiliging: welke technische gebruiker, welke rechten, waar staan de sleutels?
8. Test: is er een testomgeving voor beide kanten, en wie keurt de resultaten goed?

Hoe u het geheel in een project plaatst, staat in de implementatiepagina voor Odoo. Voor ontwikkelingen die buiten de standaard vallen, hoort ook de afspraak over maatwerk in Odoo erbij.

Wie onderhoudt de koppeling?

Dit is de vraag die in de praktijk het vaakst ontbreekt. Een koppeling heeft minstens drie verantwoordelijken:

• Uw bedrijf: bepaalt de bedrijfsregels en keurt wijzigingen goed.
• De integrator: onderhoudt zijn code, volgt de foutmeldingen op en test bij elke versiewissel van Odoo.
• De leverancier van het externe pakket: beheert zijn eigen API en kondigt wijzigingen aan.

Leg die rolverdeling vast in een onderhoudsovereenkomst, met reactietijden en een duidelijk aanspreekpunt. Het geheel past in de afspraken rond support en onderhoud van Odoo. Denk ook aan de hosting: een koppeling met een server in uw eigen netwerk stelt andere eisen dan een koppeling met Odoo Online, zoals beschreven bij Odoo in de cloud.

Veelgemaakte fouten

• Een koppeling bestellen zonder te weten welke formule de API toelaat.
• Extensies installeren zonder onderhoudsafspraak.
• Geen technische gebruiker per koppeling, waardoor één vertrekkende medewerker alles blokkeert.
• Geen testomgeving, zodat wijzigingen rechtstreeks in productie belanden.
• De Belgische bijzonderheden (CODA, Peppol, btw-aangifte) pas bij de livegang bekijken.

Een geschikte integrator vinden

Niet elke Odoo-partner heeft ervaring met elke koppeling. Vraag naar vergelijkbare flux in een Belgische context en naar hun werkwijze rond testen en onderhoud. Over de Belgische kant van het pakket leest u meer bij Odoo in België. Via onze gratis dienst koppelen we uw aanvraag aan een integrator die past bij uw situatie; het project zelf voert die integrator uit, wij zijn niet verbonden aan Odoo of aan een andere uitgever.

De genoemde softwarenamen zijn handelsmerken van hun respectievelijke eigenaren en worden uitsluitend ter informatie vermeld. Deze site is onafhankelijk en niet verbonden aan een softwareleverancier.