Wat is een API koppeling? Uitleg in gewone taal

Een order komt binnen in je webshop. Iemand typt hem over in de boekhouding, past de voorraad aan in een spreadsheet en maakt een verzendlabel in het portaal van de vervoerder. Vier keer dezelfde gegevens, vier kansen op een fout. Een API koppeling laat die systemen zelf met elkaar praten, zodat die order één keer wordt ingevoerd en daarna vanzelf overal klopt. In dit artikel lees je wat een API koppeling is, hoe het werkt, welke voorbeelden er zijn en wat het kost.

Wat is een API koppeling?

Een API koppeling is een automatische verbinding tussen twee softwaresystemen, waarmee ze gegevens uitwisselen zonder dat een mens daartussen zit. API staat voor Application Programming Interface: een vaste set afspraken waarmee een systeem aangeeft welke gegevens een ander systeem mag opvragen of wegschrijven, en in welke vorm.

Vergelijk het met een restaurant. Jij bent de klant, de keuken is het andere systeem. Je loopt de keuken niet in, je bestelt via de ober met een menukaart. De API is die menukaart met ober: vaste gerechten, een vaste manier van bestellen, en de keuken houdt de controle over wat er gebeurt.

Hoe werkt een API koppeling?

Onder de motorkap stuurt het ene systeem een verzoek naar het andere, meestal via internet. Het andere systeem controleert of het verzoek mag, voert het uit en stuurt een antwoord terug. In de praktijk ziet dat er zo uit:

1. 01Er gebeurt iets, bijvoorbeeld: een klant plaatst een bestelling in de webshop.
2. 02De koppeling ziet de nieuwe bestelling, doordat de webshop een seintje geeft of doordat de koppeling regelmatig kijkt.
3. 03De koppeling haalt de gegevens op: klant, producten, aantallen, bedrag.
4. 04Ze zet de gegevens om naar de vorm die het andere systeem verwacht, zoals het juiste btw-tarief en grootboeknummer.
5. 05Ze schrijft de gegevens weg, bijvoorbeeld als verkoopfactuur in de boekhouding.
6. 06Gaat er iets mis, dan wordt dat gelogd en krijgt iemand een melding.

Toegang loopt via een sleutel of een inlog met toestemming, vaak via OAuth. Zo bepaal jij welke systemen bij welke gegevens mogen, en kun je die toegang ook weer intrekken.

API, koppeling of integratie: wat is het verschil?

De woorden worden door elkaar gebruikt. De API is de deur die een systeem openzet. De koppeling is de software die door die deur loopt en de gegevens verplaatst. Integratie is het bredere doel: systemen die samen werken als één geheel. Soms heeft een systeem geen API, bijvoorbeeld een oud pakket. Dan zijn er omwegen, zoals bestanden uitwisselen via een map of rechtstreeks uit een database lezen.

Voorbeelden van API koppelingen

Bijna elk modern bedrijfspakket heeft een API. Ter illustratie, dit zijn gangbare koppelingen bij Nederlandse bedrijven:

• Webshop naar boekhouding: orders uit WooCommerce, Shopify of Lightspeed worden automatisch facturen in Exact Online, SnelStart of Moneybird.
• Marktplaats naar voorraad: bestellingen van Bol.com komen binnen in je voorraad- of magazijnsysteem, en de voorraad gaat terug naar Bol.com.
• Magazijn naar vervoerder: een verzendlabel van PostNL of DHL wordt direct aangemaakt, of via een verzendplatform als Sendcloud, en de track-and-trace gaat naar de klant.
• HR en salaris: uren of medewerkers uit een planningstool worden doorgezet naar AFAS.
• CRM en boekhouding: een klant die in het CRM wordt aangemaakt, staat meteen als debiteur in de administratie.
• Rapportages: cijfers uit meerdere systemen komen samen in één dashboard, zonder exports.

Welke koppeling zinvol is, verschilt per bedrijf. Een goede vraag om mee te beginnen: welke gegevens typen we nu met de hand over van het ene naar het andere scherm?

Een voorbeeld stap voor stap

Stel: een groothandel verkoopt via een eigen Shopify-winkel en via Bol.com, en boekt in Exact Online. Zonder koppeling downloadt iemand elke ochtend de orders van beide kanalen, typt ze over en past de voorraad aan in een spreadsheet. Met koppelingen komen orders van beide kanalen in één lijst binnen. Het magazijn pickt ze, het verzendlabel wordt automatisch aangemaakt en de factuur staat daarna al in de boekhouding.

De voorraad wordt na elke verkoop teruggezet naar beide kanalen. Zo verkoop je geen product twee keer dat er nog maar één keer ligt. Het handwerk verschuift van overtypen naar controleren van de uitzonderingen die de koppeling meldt.

Wat levert een API koppeling op?

• Tijd: overtypen en kopiëren verdwijnt. Wat iemand elke dag een uur kost, gebeurt in seconden.
• Minder fouten: geen typefouten, geen vergeten orders, geen verkeerde aantallen.
• Actuele gegevens: voorraad, orders en facturen kloppen op elk moment, niet pas na de volgende export.
• Schaalbaarheid: tien keer zoveel orders betekent niet tien keer zoveel handwerk.

Wat zijn de kosten van een API koppeling?

Dat hangt vooral af van drie dingen: hoe goed de API's aan beide kanten zijn, hoeveel logica er tussen zit en hoeveel gegevensstromen je wilt. Een eenvoudige koppeling die orders één kant op doorzet, is overzichtelijk. Een koppeling die twee kanten op synchroniseert, uitzonderingen afhandelt en fouten herstelt, is meer werk.

Als algemene orde van grootte in de Nederlandse markt beginnen bureaus hun 'vanaf'-prijzen voor een koppeling rond de €2.500, en complexe koppelingen lopen op tot €10.000 of meer. Houd daarnaast rekening met onderhoud, want API's van andere partijen veranderen. Meer over wat de prijs bepaalt lees je in wat kost maatwerk software.

Hoe kan ik zelf een API koppeling maken?

Er zijn drie routes, van eenvoudig naar maatwerk:

• Een kant-en-klare app of plugin: veel pakketten hebben een app store met standaard koppelingen, bijvoorbeeld tussen een webshop en Exact Online. Goedkoop en snel, zolang je proces standaard is.
• Een koppelplatform zoals Zapier of Make: je klikt stromen bij elkaar zonder te programmeren. Handig voor eenvoudige stromen, maar bij grote aantallen of complexe regels worden het abonnement en het beheer lastig.
• Een maatwerk koppeling: gebouwd rond jouw regels, met foutafhandeling en monitoring. Dit is de keuze als de standaardroutes niet genoeg doen, of als de koppeling bedrijfskritisch is.

Zelf programmeren kan ook, als er iemand in huis is die de API-documentatie leest en de koppeling daarna blijft onderhouden. Onderschat dat laatste niet: een koppeling die stilletjes stopt, merk je pas als de voorraad niet meer klopt.

Waar moet je op letten bij een API koppeling?

• Welk systeem is leidend voor welke gegevens? Anders overschrijven systemen elkaar.
• Wat gebeurt er als iets misgaat? Een goede koppeling probeert opnieuw en meldt wat ze niet kan oplossen.
• Monitoring: je wilt weten dat de koppeling draait, niet pas na een klacht van een klant.
• Persoonsgegevens: zorg dat alleen de nodige gegevens worden uitgewisseld, en dat afspraken met leveranciers volgens de AVG op orde zijn.
• Onderhoud: leveranciers passen hun API's aan. Iemand moet dat bijhouden.

Waar kan ik een API koppeling laten maken?

Past een standaard app of koppelplatform niet bij je proces, dan is een maatwerk koppeling de volgende stap. Op onze pagina over API koppelingen laten maken lees je hoe wij koppelingen bouwen en bewaken. Gaat het om grotere gegevensstromen tussen meerdere systemen, kijk dan ook naar data-integratie of naar processen automatiseren.

Weet je nog niet precies wat je nodig hebt? Neem contact op en vertel welke gegevens je nu overtypt. Dan zeggen we eerlijk of een standaard app volstaat of dat maatwerk loont.