Exact Online koppelen: API, data ontsluiten en integratie

Waarom de koppeling het echte werk is

Als mensen zoeken naar een AI-koppeling voor Exact Online, gaat de aandacht vaak naar het slimme deel: welk model leest mijn facturen? In de praktijk zit het meeste werk aan de andere kant. De vraag is niet of een model een factuurregel kan lezen, maar of de gegevens betrouwbaar heen en weer gaan tussen jouw administratie en het systeem dat ermee werkt.

Exact Online is een gesloten cloudomgeving met een goed gedocumenteerde API. Dat is prettig, want je hoeft niet te schrapen of te improviseren. Maar het betekent ook dat je je aan de spelregels van die API houdt, en die spelregels bepalen wat er praktisch mogelijk is.

Hoe de Exact Online API in grote lijnen werkt

Exact Online biedt een REST-API en, voor bepaalde onderdelen, een XML-API. Toegang loopt via OAuth: je registreert een app, de klant geeft toestemming, en je krijgt een token waarmee je namens die administratie mag werken. Dat token verloopt en moet ververst worden, en die verversing is precies waar veel zelfbouwkoppelingen na een paar maanden stilvallen.

Daarnaast werkt Exact met divisies. Elke administratie is een eigen divisie, en vrijwel elke aanroep hangt aan een divisienummer. Bedrijven met meerdere entiteiten onderschatten dat vaak. Een koppeling die voor een administratie werkt, is niet automatisch een koppeling die voor twaalf administraties werkt.

• OAuth-tokens verlopen en moeten automatisch ververst worden, ook als er dagen niets gebeurt.
• Er geldt een limiet op het aantal aanroepen per minuut en per dag, per app en per administratie.
• Elke aanroep hoort bij een divisie, dus multi-entiteit vraagt om expliciete inrichting.
• Niet alles wat je in de schermen ziet, is via de API beschikbaar of op dezelfde manier gestructureerd.

Limieten zijn geen detail

De limieten op het aantal API-aanroepen zijn de belangrijkste ontwerpbeperking. Wil je bij elke stap in je proces live opvragen wat de actuele voorraad, prijs of debiteurstand is, dan ben je die limiet sneller kwijt dan je denkt, zeker bij volume.

Dat dwingt tot keuzes. Welke gegevens haal je live op omdat ze op het moment zelf moeten kloppen, en welke gegevens haal je periodiek op en houd je lokaal bij? Prijsafspraken en artikelstamgegevens veranderen zelden per uur. Openstaande posten en voorraad soms wel.

Een goede koppeling maakt die keuze bewust en legt hem vast, met nette retries en met een wachtrij die aanroepen spreidt in plaats van ze in bursts te versturen. Dat is saai werk en precies het werk dat bepaalt of je koppeling over twee jaar nog draait.

Wanneer je data repliceert

Zoekopdrachten als replicate exact online komen niet uit de lucht vallen. Zodra je iets wil dat verder gaat dan een enkele transactie, bijvoorbeeld rapportage, analyse of het naast elkaar leggen van jaren, loop je tegen de grenzen van live opvragen aan.

Dan repliceer je: je haalt periodiek de relevante tabellen op en zet ze in je eigen datastore of datawarehouse. Daar kun je vervolgens vrij op zoeken, aggregeren en vergelijken zonder elke keer de API te belasten. Voor analyse en voor het geheugen van een AI-collega is dat vaak de juiste keuze.

• Repliceer wat je vaak en breed bevraagt: artikelen, relaties, prijsafspraken, historische boekingen.
• Haal live op wat op het moment zelf moet kloppen: openstaande posten, actuele voorraad, kredietlimiet.
• Leg vast hoe vers je replica is, zodat niemand een beslissing neemt op gegevens van gisteren zonder het te weten.
• Houd rekening met verwijderingen en correcties, niet alleen met nieuwe records.

Schrijven is strenger dan lezen

Gegevens uit Exact Online halen is de makkelijke helft. Het wordt serieus zodra je gaat schrijven: verkooporders aanmaken, inkoopfacturen boeken, betalingen afletteren. Daar hoort een andere lat bij, want een fout is niet meer een verkeerd scherm maar een verkeerde boeking.

In de praktijk betekent dat idempotentie, zodat een herhaalde aanroep na een time-out geen dubbele order oplevert. Het betekent controle vooraf op de velden die Exact zelf niet afdwingt maar die jouw administratie wel nodig heeft. En het betekent dat je elke schrijfactie logt met een verwijzing naar het brondocument.

Dat is ook waar het verschil zit tussen een integratie die af en toe iets aanmaakt en een AI-collega die dagelijks honderden boekingen doet. De tweede kan alleen bestaan als schrijven aantoonbaar veilig is.

Wat dit betekent voor een AI-koppeling

De vraag wat de beste AI-koppeling voor Exact Online is, heeft daarom geen productantwoord maar een architectuurantwoord. Het model dat de documenten leest is uitwisselbaar. De laag ertussen, die authenticatie, limieten, replicatie, validatie en logging regelt, is wat je koopt.

Bij ons zit die laag vast in het platform. De AI-collega die orders leest, gebruikt dezelfde koppeling als de agent die facturen matcht en de agent die openstaande posten aflettert. Daardoor hoef je de integratie niet per proces opnieuw te bouwen en hoef je bij een tweede of derde proces alleen nog de logica in te richten.

Hetzelfde geldt als je meerdere systemen hebt. Naast Exact werken we ook in SAP, AFAS, Dynamics 365, Odoo en Bouwworks. De processen erboven blijven gelijk, alleen de koppeling eronder verschilt.

Aan de slag

Denk je na over een koppeling met Exact Online, begin dan bij de vraag welk proces je wil verbeteren en welke gegevens dat proces nodig heeft. De techniek volgt daaruit, niet andersom. Een koppeling zonder proces is een dure leiding zonder water.

In een Quick Scan kijken we samen naar je administratie, je volumes en de processen waar de tijd nu in gaat zitten. Daarna weet je concreet wat er via de API kan, wat je beter repliceert en welk proces het snelst rendeert. Typisch sta je binnen acht weken live.