Systemen koppelen: zo werkt een API-koppeling

Bijna elk bedrijf werkt met meerdere programma's: een website, een CRM voor klanten, een boekhoudpakket. Vaak weten die programma's niets van elkaar, en zit er iemand tussen die gegevens van het ene naar het andere overtypt. Een koppeling neemt dat werk over. Hieronder leggen we uit hoe dat werkt, zonder vakjargon, en waar je op moet letten.

Wat is een API-koppeling?

Een API-koppeling zet informatie automatisch over van het ene systeem naar het andere. API staat voor application programming interface. Forum Standaardisatie, de organisatie van de overheid voor digitale standaarden, omschrijft het als technische bestanden, documentatie en ondersteuning waarmee je een ander programma kunt aanroepen (Forum Standaardisatie, 2018). In gewone woorden: het is de afgesproken ingang van een programma, met de regels voor wat je daar mag aanleveren en opvragen.

Vergelijk het met een vaste koerier tussen twee afdelingen die elk in een ander gebouw zitten. De koerier haalt bij de ene afdeling een formulier op en levert het bij de andere af. Beide afdelingen hebben afgesproken hoe dat formulier eruitziet, zodat ze het allebei kunnen lezen. Een API-koppeling doet hetzelfde tussen twee programma's, maar dan binnen een paar seconden en zonder dat iemand iets hoeft over te typen. Zo kunnen programma's van verschillende leveranciers met elkaar praten.

Waarom koppelen zo handig is

Met een koppeling hoef je je bestaande software niet weg te gooien om je werk te verbeteren. Vaak heb je al grote pakketten waar je niet vanaf wilt, zoals je boekhouding of je CRM. Door een koppeling kun je nieuwe software ertussen plaatsen, die precies het stuk oplost dat nu ontbreekt.

Daarom hoeft maatwerk ook niet alles opnieuw vanaf nul te bouwen. Het eigenlijke maatwerk zit in het deel dat jouw werk ondersteunt, en via koppelingen sluit het aan op wat er al staat. Meer daarover lees je in ons artikel over wat maatwerksoftware is.

Zo kan het eruitzien: van website naar boekhouding

In gesprekken met ondernemers horen we steeds een vergelijkbaar beeld. Er is een standaard-CRM waar op zich niets mis mee is, maar aanvragen via de website komen er niet vanzelf in. De ondernemer moet elke aanvraag zelf beantwoorden en daarna de gegevens met de hand in het CRM zetten. Vervolgens stelt hij handmatig een offerte op, om soms te horen dat de klant toch niet geïnteresseerd is.

Met twee koppelingen kan een groot deel daarvan automatisch. De eerste zet een aanvraag van de website direct in het CRM. De tweede stuurt een geaccepteerde offerte door naar het boekhoudsysteem, zodat de factuur klaarstaat. De ondernemer houdt zo meer tijd over voor het werk zelf, en minder voor administratie. Dit voorbeeld is een samengesteld beeld uit meerdere gesprekken, geen beschrijving van één klant.

Wat er mis kan gaan bij een koppeling

Een koppeling die werkt zolang alles goed gaat, is pas het halve werk. De meeste problemen ontstaan juist als er iets afwijkt. Dit zijn de valkuilen die we het vaakst tegenkomen.

1. De beveiliging tussen de systemen

Elk systeem moet zeker weten dat het met de juiste partij praat. Dat heet authenticatie: de koppeling laat zien wie hij is, meestal met een sleutel of toegangscode. Wordt die sleutel slordig bewaard, of krijgt de koppeling meer rechten dan nodig, dan kan iemand anders er misbruik van maken. Dat doet ertoe omdat via een koppeling vaak klant- en financiële gegevens lopen.

2. Fouten die stil verdwijnen

Als een systeem een aanvraag weigert, moet iemand dat merken. Zonder goede foutafhandeling verdwijnt zo'n fout zonder melding, en ontdek je pas weken later dat er aanvragen ontbreken. Een goede koppeling legt elke mislukte poging vast en waarschuwt de juiste persoon.

3. Te veel verzoeken tegelijk

Leveranciers beperken hoeveel verzoeken een koppeling mag doen. Exact vraagt in zijn voorwaarden bijvoorbeeld dat een app niet onnodig verzoeken verstuurt, en houdt zich het recht voor om maatregelen te nemen bij overmatig gebruik (Exact, 2025). Een koppeling die daar geen rekening mee houdt, wordt op drukke momenten geweigerd, precies wanneer je hem het hardst nodig hebt.

4. Geen tweede poging

Soms is een systeem even niet bereikbaar, bijvoorbeeld door onderhoud. Een goede koppeling probeert het dan na een tijdje opnieuw. Zonder dat mechanisme gaat het bericht verloren door een storing van een paar minuten.

5. Gegevens die niet eenduidig zijn

Twee systemen kunnen hetzelfde gegeven verschillend opschrijven. Een bekend voorbeeld zijn tijdzones: een systeem uit de Verenigde Staten slaat een tijd anders op dan een Europees systeem, waardoor een afspraak ineens uren verschuift. Hetzelfde geldt voor bedragen met of zonder btw. Spreek daarom precies af hoe elk gegeven wordt overgedragen.

6. Alleen testen of het goed gaat

Veel koppelingen worden alleen getest met een keurige aanvraag waarbij alles klopt. In de praktijk laat iemand een veld leeg of verstuurt hij een formulier twee keer. Test daarom ook wat er gebeurt als het misgaat, want daar zitten de meeste problemen.

7. Privacy en de AVG

Het is verleidelijk om alle gegevens maar door te sturen, omdat het kan. De AVG vraagt het tegenovergestelde: verwerk nooit meer persoonsgegevens dan nodig. Werkt een andere partij gegevens voor je bij, dan heb je een verwerkersovereenkomst nodig, en je blijft zelf verantwoordelijk (Ondernemersplein). Bedenk dus per koppeling welke gegevens echt mee moeten.

Wat een koppeling kost en wat onderhoud betekent

De kosten van een koppeling bestaan uit twee delen: het bouwen, en wat de leverancier van het systeem vraagt voor toegang. Voor het bouwen noemt Score Agency in 2026 bedragen van €500 tot €3.000 voor een eenvoudige koppeling die gegevens één kant op stuurt, €3.000 tot €10.000 voor een koppeling die twee kanten op werkt met controles, en €10.000 tot €25.000 of meer als er meerdere systemen bij betrokken zijn. Dat zijn bedragen van een aanbieder, dus gebruik ze als richting.

Daarnaast vragen sommige leveranciers zelf geld om toegang te krijgen tot hun systeem. Grote partijen willen daarmee overzicht houden over wie er koppelt. Die prijzen staan vaak niet op hun website. Volgens CleverTech hoor je de prijs voor toegang bij veel leveranciers pas in een persoonlijk gesprek. Exact rekent voor klanten op dit moment niets voor koppelen, maar houdt zich in zijn voorwaarden het recht voor om dat in de toekomst wel te doen (Exact, 2025). Vraag de toegangskosten dus altijd vooraf na.

Een koppeling is nooit helemaal af. De systemen aan beide kanten veranderen: een leverancier past zijn API aan of wijzigt zijn voorwaarden. Exact kan zijn voorwaarden bijvoorbeeld op elk moment aanpassen. Reken daarom op onderhoud, waarbij iemand de koppeling in de gaten houdt en bijwerkt als er aan een van de kanten iets verandert.

Bestaat er al een kant-en-klare koppeling voor de twee systemen die je gebruikt, kijk dan eerst daarnaar. In de Exact App Store staan bijvoorbeeld 301 apps. Een eigen koppeling loont vooral als die er niet is, of als je specifieke uitzonderingen goed afgehandeld wilt hebben.

Minder administratie, en wat dat betekent voor je mensen

Een koppeling neemt overtypwerk weg, en dat raakt mensen op verschillende manieren. Sommige medewerkers zijn juist aangenomen om de administratie te doen. Voor hen gaat het erom dat het werk slimmer kan, zodat ze minder tijd kwijt zijn aan overtypen en meer aan controleren en opvolgen. Daar zit een balans in die je bewust moet bekijken.

De grootste winst zit vaak bij de mensen die het eigenlijke werk doen: een zorgmedewerker, een monteur in de installatietechniek of een groenwerker. Voor hen is administratie iets wat erbij komt. Als een koppeling een deel daarvan wegneemt, houden zij meer tijd over voor het werk waar ze voor gekozen hebben en dat ze leuk vinden.

Hoe wij koppelingen bouwen

Een goede koppeling begint bij de vraag welke gegevens waar naartoe moeten, en wie er last heeft van het overtypen. Daarna kijken we wat de systemen aan beide kanten mogelijk maken, en hoe we fouten en privacy goed regelen. Meestal hoeft er niets weg: we bouwen om je bestaande pakketten heen of koppelen eraan. Hoe we dat aanpakken, lees je bij koppeling laten maken.