Elke order die iemand overtypt van de webshop naar het boekhoudpakket kost een paar minuten en een kans op een tikfout. Bij 100 orders per week groeit dat uit tot dagen werk per jaar, en de fouten komen pas boven bij de klant of de accountant.
Een API koppeling is een verbinding tussen twee softwaresystemen die via een API (application programming interface) automatisch gegevens uitwisselen. Het ene systeem stelt een vraag of stuurt een bericht, het andere systeem antwoordt of verwerkt het, zonder dat iemand iets overtypt. Zo blijven orders, klantgegevens en voorraadstanden in webshop, ERP en boekhouding gelijk.
Je leest hieronder hoe een API koppeling werkt, welke voorbeelden je in Nederlandse bedrijven tegenkomt, wat de kosten bepaalt en wanneer je een koppeling laat maken. We bouwen al ruim dertig jaar software en koppelingen voor zorg, onderwijs, industrie, overheid en energie; de voorbeelden komen uit die praktijk.
Hoe een API koppeling werkt
Een API is de officiële ingang van een softwarepakket voor andere software. Waar een gebruiker inlogt via een scherm, klopt een ander systeem aan via de API: een vaste set adressen (endpoints) waar je gegevens kunt opvragen, aanmaken of wijzigen. De leverancier beschrijft in de documentatie welke vragen je mag stellen en in welk formaat het antwoord terugkomt, meestal JSON. Een uitgebreidere uitleg van het begrip API staat op Wikipedia.
De koppeling is het stuk software dat die ingang gebruikt. Het haalt bijvoorbeeld elke vijf minuten nieuwe orders op uit de webshop, vertaalt de velden naar het formaat van het ERP en stuurt ze door. De API is de tolk met een vaste woordenlijst; de koppeling is het gesprek dat je met die tolk voert, inclusief de afspraak over wat er gebeurt als de ander even niet opneemt.
Drie manieren om systemen te koppelen
- REST API. De meest gebruikte vorm. Je systeem vraagt actief gegevens op of stuurt ze in via HTTP, dezelfde techniek die een webbrowser gebruikt. Vrijwel elk modern pakket biedt er een, van Exact Online en AFAS tot HubSpot en Salesforce.
- Webhooks. Hier draait de richting om. Het bronsysteem meldt zelf dat er iets is gebeurd, bijvoorbeeld dat order 4531 is betaald. Je koppeling hoeft dan niet elke minuut te vragen of er nieuws is.
- Bestandsuitwisseling. Een CSV of XML export die op vaste tijden op een SFTP server wordt gezet en aan de andere kant wordt ingelezen. Ouderwets, en soms de enige optie bij software zonder API. Voor nachtelijke batches werkt het prima; voor voorraad die direct moet kloppen schiet het tekort.
In de praktijk combineer je deze vormen. Een webhook meldt een nieuwe order, een REST aanroep haalt de details op en een nachtelijke export controleert of alles klopt. Zodra meer dan twee of drie systemen met elkaar praten, groeit het aantal koppelingen snel en komt een tussenlaag in beeld; daarover lees je meer in ons artikel over middleware.
Op onze pagina over software integratie lees je hoe we koppelingen met ERP, CRM en legacy systemen aanpakken, van eerste inventarisatie tot beheer.
Voorbeelden van API koppelingen in de praktijk
De meeste koppelingen lossen hetzelfde probleem op: dezelfde gegevens leven in twee systemen en iemand houdt ze met de hand gelijk. Vier situaties die we vaak tegenkomen:
- Webshop naar Exact Online. Orders, klanten en betalingen gaan automatisch naar de boekhouding en de voorraadstand gaat de andere kant op.
- CRM naar ERP. Een gewonnen offerte in het CRM wordt een order in het ERP, met dezelfde klantcode en dezelfde prijzen.
- Planning naar HR. Gewerkte uren en diensten uit de roostertool gaan naar het salarispakket. De salarisadministratie hoeft geen roosters meer over te nemen en verwerkt alleen nog de uitzonderingen.
- RFID naar ERP. In de maakindustrie koppelen fabrikanten scanners en RFID lezers aan hun productcatalogus en ERP, zodat elke gescande pallet direct in het systeem staat. Voor Deron hebben we zo'n koppeling gebouwd.
Joris is hoofd bedrijfsbureau bij een technische groothandel met 35 medewerkers. Zijn team typt dagelijks zo'n 60 webshoporders over in het ERP, en elke maand zoekt de boekhouder een dag naar verschillen tussen webshop en grootboek. Een REST koppeling tussen webshop en ERP zet elke order binnen een minuut in het systeem, met de juiste klantcode en prijsafspraak. Het bedrijfsbureau houdt alleen de uitzonderingen over: orders van klanten zonder geldig btw nummer of met een afleveradres buiten de EU, in een aparte lijst klaar voor controle.
Hoe zo'n koppeling in de maakindustrie tot stand komt, beschrijven we stap voor stap in onze case over RFID gekoppeld aan de productcatalogus en het ERP bij Deron. Wil je liever eerst je eigen situatie doornemen, dan kan dat in een vrijblijvend adviesgesprek.
Wat bepaalt de kosten van een API koppeling
Een bedrag noemen zonder de systemen te kennen zou een gok zijn. Wel is aan te geven waar de uren in gaan zitten. Vijf factoren bepalen het grootste deel van de begroting:
- Aantal systemen en richtingen. Eén systeem dat leest uit een ander is overzichtelijk. Twee systemen die elkaar in beide richtingen bijwerken vragen om afspraken over wie gelijk heeft als beide tegelijk wijzigen.
- Kwaliteit van de API en de documentatie. Een moderne, goed beschreven REST API scheelt dagen werk ten opzichte van een verouderd koppelvlak waarvan de documentatie ontbreekt of afwijkt van de werkelijkheid.
- Datavolume en snelheid. 100 orders per dag is iets anders dan 10.000 voorraadmutaties per uur. Het volume bepaalt of een eenvoudig script volstaat of dat je wachtrijen en monitoring nodig hebt.
- Foutafhandeling. Bedenk vooraf wat er moet gebeuren als het ERP tien minuten offline is, als een klant twee keer in het CRM staat of als een verplicht veld leeg blijft. Het grootste deel van de bouwtijd zit in deze uitzonderingen; het standaardpad is meestal snel gebouwd.
- Beheer na oplevering. Leveranciers wijzigen hun API, certificaten verlopen en volumes groeien. Reken naast de bouw op monitoring en periodiek onderhoud.
Een koppeling tussen twee moderne pakketten met beperkt volume is vaak een kwestie van dagen; een koppeling tussen een webshop, een ERP en een verouderd magazijnsysteem met tienduizenden mutaties per dag is een project van weken tot maanden. Beide zijn een API koppeling; het verschil zit in de uitzonderingen die je afdekt.
API koppeling laten maken of een standaardconnector kiezen
Veel pakketten leveren bestaande koppelingen (connectors) naar populaire software, bijvoorbeeld tussen een webshopplatform en een boekhoudpakket. Zo'n connector volstaat als je proces standaard is en je genoegen neemt met de velden en de frequentie die de leverancier heeft bedacht.
Een API koppeling laten maken wordt interessant in drie situaties:
- Je proces wijkt af van de standaard: eigen artikelcodes, staffelprijzen per klant of goedkeuringsstappen die de connector niet kent.
- Eén van de systemen is maatwerk of een ouder pakket waarvoor geen connector bestaat.
- Je wilt eigenaar zijn van de logica, zodat de roadmap van een derde partij jouw proces niet bepaalt.
Marieke is HR adviseur bij een zorgorganisatie met 600 medewerkers. De roostertool heeft een standaardconnector naar het salarispakket, en die werkt goed voor gewone diensten. Onregelmatigheidstoeslagen en slaapdiensten komen er echter verkeerd doorheen, waardoor de salarisadministratie elke maand tientallen regels met de hand corrigeert. Een maatwerkkoppeling die de regels uit de cao toepast voordat de uren naar het salarispakket gaan, haalt die correcties weg. De connector blijft in gebruik voor al het andere.
Wij bouwen zulke koppelingen als onderdeel van maatwerk software en als los project, met een team van 30+ engineers in Nijmegen en Sarajevo. Dezelfde mensen die de koppeling bouwen houden hem draaiend, en dat telt voor software die dagelijks orders of salarisregels verwerkt.
Risico's die je vooraf afdekt
Een koppeling die vandaag werkt, kan volgend jaar stilvallen door een wijziging aan de andere kant. Vijf punten om vooraf te regelen:
- Ontbrekende of verouderde documentatie. Vraag de API documentatie op voordat je een offerte accepteert en test een paar aanroepen in een proefomgeving. Verschillen tussen documentatie en werkelijkheid komen zo boven voordat ze geld kosten.
- Rate limits. Leveranciers beperken het aantal aanroepen per minuut of per dag. Plan de frequentie op basis van hoe actueel de data moet zijn.
- Versiebeheer. API's veranderen. Een leverancier kondigt een nieuwe versie aan en zet de oude na een jaar uit. Zonder eigenaar die zulke berichten leest, stopt de koppeling op een willekeurige dinsdag. Leg vast wie de koppeling beheert en wie de release notes van de leverancier volgt.
- Oude systemen zonder API. Bij oudere pakketten blijft vaak alleen directe databasetoegang of bestandsuitwisseling over. Dat kan, met extra aandacht voor beveiliging en continuïteit. Het NCSC beschrijft de risico's van legacy systemen helder.
- Beveiliging. Elke koppeling is een extra deur naar je data. Werk met een aparte API sleutel per koppeling, met minimale rechten, en log wie wat wanneer ophaalt. Wij zijn ISO 9001 en ISO 27001 gecertificeerd en nemen die eisen als uitgangspunt voor elke koppeling die we bouwen.
Veelgestelde vragen
Wat kost een API koppeling?
Dat hangt af van het aantal systemen, de kwaliteit van de API documentatie, het datavolume en de eisen aan foutafhandeling en beheer. Een koppeling tussen twee moderne pakketten met beperkt volume is doorgaans een klein project; een koppeling met een oud systeem zonder documentatie vraagt om een uitgebreide inventarisatie vooraf. Na een verkennend gesprek geven we een concrete inschatting met heldere aannames.
Wat is het verschil tussen een API en een API koppeling?
Een API is de ingang die een softwarepakket aanbiedt aan andere software: de afspraken over welke gegevens je kunt opvragen en in welk formaat. Een API koppeling is de software die die ingang gebruikt om twee systemen daadwerkelijk gegevens te laten uitwisselen. De API is er meestal al; de koppeling laat je bouwen.
Waar kan ik een API koppeling laten maken?
Bij de leverancier van een van de pakketten, bij een integratieplatform of bij een softwarebedrijf dat zowel de koppeling bouwt als het beheer verzorgt. Let vooral op wie de koppeling na oplevering onderhoudt en wie eigenaar is van de code. Onze aanpak staat op de pagina over API development.
Hoe lang duurt het bouwen van een API koppeling?
Een eenvoudige koppeling tussen twee goed gedocumenteerde systemen staat vaak binnen enkele weken, inclusief testen. Koppelingen met meerdere systemen, hoge volumes of een verouderd pakket lopen op tot enkele maanden. De inventarisatie vooraf bepaalt de doorlooptijd meer dan het programmeerwerk zelf.
Kernpunten en volgende stap
Een API koppeling laat systemen automatisch gegevens uitwisselen, zodat niemand meer overtypt. Onthoud deze punten:
- De API is de ingang van een pakket; de koppeling is de software die er gebruik van maakt.
- REST, webhooks en bestandsuitwisseling hebben elk hun plek en worden vaak gecombineerd.
- De kosten hangen af van het aantal systemen, de documentatie, het volume, de foutafhandeling en het beheer.
- Een standaardconnector volstaat bij een standaardproces; laat een koppeling maken zodra je proces afwijkt of een systeem geen connector heeft.
- Leg vooraf vast wie de koppeling beheert en wie de wijzigingen van de leverancier volgt.
De volgende stap is een inventarisatie: welke systemen, welke gegevens, hoe vaak en wat er moet gebeuren bij fouten. Met ruim dertig jaar ervaring en meer dan 100 projecten kijken we graag met je mee. Plan een vrijblijvend gesprek en we zeggen eerlijk of een connector volstaat of dat een eigen koppeling loont.
