Exact Online koppelen aan je eigen software: wanneer, hoe en wat het kost

Introductie

Exact Online is voor veel Nederlandse bedrijven de financiele ruggengraat. Tegelijk draaien diezelfde bedrijven vaak eigen software ernaast: een webshop, een klantportaal, een planningstool of een intern systeem. Zodra die twee werelden niet met elkaar praten, ontstaat het bekende patroon van dubbel invoeren, handmatig overtypen en reconciliatieverschillen bij de maandafsluiting.

Een koppeling tussen je eigen software en Exact Online lost dat op, maar het is geen knopje dat je even omzet. In deze gids leggen we uit wanneer een koppeling de moeite waard is, wat technisch kan via de REST API, waar het lastig wordt en wat het ongeveer kost. We schrijven dit vanuit ervaring in Haarlem; op onze pagina over de Exact Online koppeling en het bredere API-koppelingen overzicht staat de technische aanpak nog uitgebreider.

Wanneer een Exact Online koppeling de moeite waard is

De duidelijkste signalen zijn operationeel. Iemand maakt een order aan in jouw systeem en typt diezelfde order daarna handmatig over in Exact. Of finance wacht elke maand op exports uit verschillende tools om de boeken kloppend te krijgen. Of klanten bellen om te vragen of hun factuur al betaald is, terwijl die informatie in Exact gewoon beschikbaar is. Stuk voor stuk zijn dit momenten waarop een koppeling tijd en fouten wegneemt.

De waarde van een koppeling is meestal groter dan alleen tijdwinst. Realtime inzicht in openstaande facturen en cashflow helpt bij sturen, en een geautomatiseerde koppeling levert een controleerbaar spoor van elke boeking op. Voor sectoren met krappe marges, zoals groothandel of e-commerce, vertaalt het verschil tussen handmatig en geautomatiseerd zich direct naar de bedrijfsvoering.

Niet elke situatie vraagt meteen een volledige integratie. Soms volstaat een eenrichtingsverkeer (orders naar Exact) voordat je betaalstatussen terug laat stromen naar een klantportaal. Op onze pagina over software koppelingen helpen we bepalen welke scope past bij je fase en budget.

Wat je technisch met de REST API kunt

Exact Online stelt een uitgebreide REST API beschikbaar waarmee je vrijwel alle entiteiten kunt lezen en schrijven: verkooporders, conceptfacturen, inkoopfacturen, grootboekrekeningen, relaties en projectmutaties. De volledige resource-lijst staat in de officiële Exact Online API-documentatie. In de praktijk betekent dit dat een order in jouw systeem automatisch een verkoopboeking of conceptfactuur in Exact kan worden, en dat betaalstatussen terug kunnen stromen naar je eigen applicatie.

Voor realtime gedrag gebruiken we waar mogelijk webhooks, zodat je applicatie binnen seconden weet dat er iets is gewijzigd. Waar webhooks niet beschikbaar zijn, vullen we aan met geplande synchronisatie die alleen verschillen verwerkt. Exact publiceert wijzigingen en known issues ook via Support Exact Online; dat volgen we actief zodat breaking changes niet als verrassing komen.

Bouw je nog aan de applicatie zelf, dan is onze pagina over een webapplicatie laten bouwen een logisch vertrekpunt. Een koppeling ontwerp je het best mee vanaf het datamodel, niet als laatste laagje na livegang.

OAuth 2.0 en tokenbeheer: waar koppelingen stilvallen

Exact gebruikt OAuth 2.0 voor API-toegang, conform het model dat ook in RFC 6749 is beschreven. Je applicatie vraagt toestemming aan een Exact-gebruiker, ontvangt een access token en een refresh token, en gebruikt die tokens bij elke API-aanroep. Access tokens verlopen; refresh tokens moeten periodiek ververst worden. Als die rotatie niet als betrouwbaar achtergrondproces is gebouwd, valt de koppeling vroeg of laat stil op een onhandig moment, vaak midden in de nacht of net voor maandafsluiting.

De Exact Online developer portal beschrijft app-registratie, scopes en redirect-URI’s. Wij slaan tokens versleuteld op, loggen refresh-fouten en alerten als een token niet meer vernieuwd kan worden. Microsoft’s uitleg van het authorization code flow is nuttig als referentie, ook al draait Exact op eigen endpoints: het patroon van code exchange, refresh en scope is hetzelfde.

Een veelvoorkomende fout is tokens in platte configuratiebestanden zetten of refresh-logica alleen in een cronjob zonder retry. Behandel OAuth als productie-infrastructuur, niet als een eenmalige setup tijdens de eerste sprint.

Administraties, grootboekmapping en rate limits

"De koppeling zelf is zelden het moeilijke deel. Het moeilijke deel is de boekhoudkundige logica eromheen kloppend krijgen."

— Sidney de Geus, co-founder MG Software

Veel organisaties beheren meerdere BV’s of vestigingen in aparte divisions. Elke API-aanroep moet expliciet de juiste administratie noemen. Fouten in die mapping kunnen boekingen in de verkeerde administratie laten landen; dat zie je pas bij consolidatie of audit, wanneer herstel duur is.

Grootboekmapping is minstens zo belangrijk. Hoe een order, korting of verzendkosten vertaalt naar grootboekregels verschilt per bedrijf en vraagt nauwe samenwerking met je finance team. Wij documenteren mapping als configuratie per division, niet als hardcoded logica verspreid door de code.

Tot slot zijn de rate limits van Exact restrictiever dan veel teams verwachten, vooral bij het importeren van historische data of bulk-syncs. Batch-verwerking, backoff en idempotente requests zijn geen nice-to-have; ze voorkomen dubbele boekingen wanneer een request timeout krijgt en opnieuw wordt verstuurd.

Wat een koppeling kost en hoe lang het duurt

Een eerste productiekoppeling met een afgebakend doel, bijvoorbeeld verkooporders die als conceptfactuur in Exact landen, valt doorgaans binnen een paar sprints. De prijs binnen die scope hangt af van het aantal entiteiten dat je wilt synchroniseren, de complexiteit van de grootboekmapping en of er een testomgeving beschikbaar is.

Voor organisaties met meerdere administraties, complexe mapping of grote volumes adviseren we een gefaseerde aanpak, waarbij elke fase een werkend en testbaar resultaat oplevert. Zo voorkom je een lang traject zonder tussentijdse waarde. Fase één levert vaak al de meeste tijdwinst op; fase twee voegt bijvoorbeeld betaalstatus terug naar je portaal toe.

Voor een eerste bandbreedte kun je onze calculator gebruiken, en op de pagina over software koppelingen lees je hoe we integraties in het algemeen prijzen en beheren. Onderhoud na livegang hoort in je jaarplan: Exact wijzigt API’s, en OAuth-tokens blijven aandacht vragen.

Veelgemaakte fouten

De meest gemaakte fout is proberen alles tegelijk te synchroniseren. Een koppeling die in een keer orders, facturen, voorraad, relaties en projecten omvat, is moeilijk te testen en moeilijk te onderhouden. Begin klein, met de stroom die de meeste handmatige tijd kost, en breid daarna uit op basis van wat in productie blijkt te werken.

Een tweede klassieker is het negeren van foutafhandeling. Een API-aanroep kan falen door een timeout, een rate limit of tijdelijke onbereikbaarheid. Zonder idempotente verzoeken en een nette wachtrij voor mislukte mutaties krijg je dubbele boekingen of stille datafouten. Dat zijn precies het soort fouten die pas bij de maandafsluiting opvallen, wanneer ze het duurst zijn om uit te zoeken.

Een derde fout is geen monitoring na go-live. Een koppeling die stilvalt door een verlopen token merk je pas als finance klopt dat er geen nieuwe facturen meer binnenkomen. Wij monitoren sync-lag, failed jobs en token-age actief, vaak in hetzelfde onderhoudsretainer-model als de rest van de applicatie.

Lessen uit Haarlem: Exact-koppelingen in projecten

Bij MG Software in Haarlem hebben we meerdere Exact-koppelingen gebouwd voor klanten in wholesale, dienstverlening en e-commerce. Een recent traject: een orderportaal voor een groothandel in de regio Haarlem-Amsterdam, waarbij goedgekeurde orders automatisch als conceptfactuur in Exact landen en betaalstatussen 's nachts terug syncen naar het portaal. Discovery duurde een week, OAuth en division-mapping twee sprints, de eerste productiestroom nog eens twee sprints. Pas daarna voegden we voorraadmutaties toe.

Wat we daar leerden: finance moet mapping reviewen vóór de eerste testboeking, niet achteraf. De testadministratie van Exact ving drie mappingfouten op die in productie direct zichtbaar waren geweest. Ook bleek rate limiting alleen bij bulk-import van historische orders een issue; door nachtelijke batches en exponential backoff losten we dat zonder dataverlies op.

Die projecten draaien nu op een onderhoudsretainer waarin we kwartaalmatig Exact API-release notes checken en dependency-updates doorvoeren. Een koppeling is geen eenmalig project; het is een levende integratie. Wie dat vooraf beseft, budgetteert realistischer en vermijdt verrassingen wanneer Exact een endpoint deprecate.

Hoe wij het aanpakken

We beginnen met een korte discovery waarin we samen bepalen welke Exact-entiteiten relevant zijn, in welke richting data stroomt en welke boekhoudregels van toepassing zijn. Daarna richten we OAuth 2.0 veilig in, met versleutelde tokenopslag en automatische rotatie, en ontwikkelen we tegen een Exact testadministratie zodat we nooit met productiedata experimenteren.

Elke mutatie wordt idempotent opgezet, mislukte verzoeken belanden in een wachtrij met volledige context, en we monitoren de koppeling actief na livegang. Omdat Exact regelmatig API-wijzigingen doorvoert, bouwen we een abstractielaag die zulke wijzigingen isoleert, zodat een update van Exact niet je hele integratie raakt.

Wil je het proces vergelijken met andere ERP- of boekhoudkoppelingen, bekijk dan ons integratie-overzicht. Staat legacy software tussen je portaal en Exact, dan kan gefaseerde herontwikkeling soms goedkoper zijn dan yet another export-script.

Conclusie

Een Exact Online koppeling is geen technisch trucje, maar een investering die handmatig werk en fouten structureel wegneemt. Het succes zit hem niet in de API zelf, maar in de zorgvuldigheid rond OAuth, administraties, grootboekmapping, rate limits en foutafhandeling. Begin klein, bouw betrouwbaar, en breid uit op basis van wat werkt.

Wil je je eigen software laten praten met Exact Online? Neem contact op met MG Software of bekijk eerst onze uitgebreide pagina over de Exact Online koppeling. We brengen je proces in kaart en bouwen een koppeling die ook bij de maandafsluiting klopt.