API-koppeling laten maken: hoe twee systemen met elkaar gaan praten, wat het kost en waar het misgaat

Een API-koppeling laten maken klinkt technisch, maar de aanleiding is bijna altijd hetzelfde: twee systemen die niet met elkaar praten, en een medewerker die het verschil dagelijks met de hand overbrugt. Bestellingen uit de webshop die iemand overtikt in het boekhoudpakket. Voorraad die in twee plekken bijgehouden wordt en altijd net niet klopt. Een koppeling lost dat op door de systemen rechtstreeks gegevens te laten uitwisselen.

Wat een API eigenlijk is, zonder jargon

Een API is een afgesproken manier waarop een systeem informatie vrijgeeft en opdrachten aanneemt. Zie het als een serviceloket: jouw software klopt aan met een vraag ("geef me alle bestellingen van vandaag") of een opdracht ("maak deze klant aan"), en het andere systeem antwoordt in een vast formaat. Zolang beide partijen zich aan dat loket houden, hoeven ze niets van elkaars binnenkant te weten. Daarom kun je een webshop koppelen aan een boekhoudpakket zonder dat een van beide herbouwd hoeft te worden.

Wanneer heb je een koppeling nodig?

De vuistregel: zodra dezelfde gegevens op twee plekken leven en iemand ze handmatig synchroon houdt, verdient een koppeling zichzelf terug. Een koppeling is vaak onderdeel van een groter maatwerk software traject, maar net zo goed een losse opdracht. Een paar veelvoorkomende situaties:

• Webshop naar boekhouding: orders, facturen en betalingen automatisch doorzetten naar je administratie.
• CRM naar e-mail of marketing: nieuwe leads en klantgegevens gesynchroniseerd houden tussen systemen.
• Voorraad of planning tussen systemen: één bron van waarheid in plaats van twee lijsten die uit elkaar lopen.
• Eigen software naar een externe dienst: een betaalprovider, verzendpartij of datadienst aanhaken op je platform.

Wat bepaalt de prijs van een API-koppeling?

Een eenvoudige koppeling tussen twee systemen die allebei een nette, gedocumenteerde API hebben, kost meestal tussen de 1.500 en 5.000 euro. Wordt het complexer, met meerdere systemen, gegevens die onderweg omgezet of opgeschoond moeten worden, of een systeem zonder fatsoenlijke API, dan loopt het op naar 10.000 euro of meer. De grootste kostendrivers:

• Kwaliteit van de API's. Een moderne, goed gedocumenteerde API is snel te koppelen. Een verouderd systeem zonder documentatie kost veel meer uitzoekwerk.
• Datatransformatie. Als veld A in het ene systeem niet één-op-één op veld B in het andere past, moet er logica tussen die de gegevens vertaalt.
• Richting en frequentie. Eenrichtingsverkeer dat één keer per nacht draait is eenvoudiger dan een realtime koppeling die twee kanten op synchroniseert.
• Foutafhandeling. Wat gebeurt er als het andere systeem even plat ligt? Een robuuste koppeling vangt dat op in plaats van data stil te laten verdwijnen.

Waar koppelingen in de praktijk misgaan

De koppeling die in de demo werkt en in productie wekelijks omvalt, is een klassieker. Bijna altijd komt dat doordat de randgevallen zijn overgeslagen: een bestelling zonder e-mailadres, een product dat in het ene systeem is verwijderd maar in het andere nog bestaat, een API die zonder aankondiging zijn formaat wijzigt. Een koppeling is geen eenmalig kunstje, het is een verbinding die moet blijven werken terwijl beide systemen onafhankelijk doorontwikkelen.

Daarom bouwen we koppelingen met logging en foutmeldingen erin, zodat je ziet wanneer er iets misgaat in plaats van er weken later achter te komen omdat de cijfers niet kloppen. En we leggen vast wat er moet gebeuren bij uitval, zodat er geen gegevens stilletjes verloren gaan.

Een koppeling is pas klaar als hij ook werkt op de dag dat het andere systeem zich niet aan de regels houdt.

Hoe Datagrove een koppeling aanpakt

Datagrove is een development agency in Amsterdam. We bouwen platforms, mobiele apps en de koppelingen daartussen voor MKB en scale-ups. Bij een koppeling beginnen we met de vraag welke gegevens precies moeten stromen, in welke richting en hoe vaak. Daarna kijken we naar de API's aan beide kanten en wat ze wel en niet toelaten, voordat we een prijs noemen. Zo voorkom je dat een koppeling halverwege duurder uitvalt omdat een systeem minder meewerkt dan gedacht.

Twijfel je of jouw systemen te koppelen zijn, of wil je weten wat een specifieke koppeling kost? Plan een vrijblijvend gesprek. Vertel welke twee systemen het betreft, dan zeggen we eerlijk of het eenvoudig is of niet.