Wat is een API-koppeling?
Een API-koppeling is een verbinding tussen twee softwaresystemen, waardoor ze automatisch gegevens uitwisselen. Geen mens ertussen, geen overtypen, geen export en import.
De API is het onderdeel dat dat mogelijk maakt. Zie het als een stopcontact op een systeem: een vaste plek waar andere software op kan aansluiten om gegevens op te halen of af te leveren. De letters staan voor application programming interface, maar met die woorden schiet je niets op. Wat telt is wat er gebeurt: systeem A legt iets klaar, systeem B pakt het op.
Een voorbeeld dat de meeste bedrijven herkennen. Er komt een order binnen in je webshop. Zonder koppeling typt iemand die order over in de boekhouding, en daarna nog een keer in het voorraadsysteem. Met een koppeling gebeurt dat binnen een paar seconden, of het er nu drie per dag zijn of driehonderd.
API, koppeling of integratie: wat is nou wat?
Deze woorden worden door elkaar gebruikt, ook door leveranciers. Het verschil is klein maar handig om te kennen als je een offerte leest.
| Term | Wat het is | Wanneer je het hoort |
|---|---|---|
| API | De aansluiting die één systeem aanbiedt | ”Heeft dat pakket een API?” |
| API-koppeling | De verbinding die je tussen twee aansluitingen bouwt | ”We laten de webshop en de boekhouding koppelen” |
| API-integratie | Hetzelfde als een koppeling, alleen breder gebruikt | Vaak in offertes en bij grotere trajecten |
| Webhook | Systeem A duwt zelf een bericht naar B zodra er iets gebeurt | Bij meldingen die meteen moeten aankomen |
Een pakket kan dus wel een API hebben zonder dat er iets gekoppeld is. Die aansluiting zit er, er is alleen nog niemand die er een stekker in heeft gestoken. Vraag bij een offerte daarom altijd door op wat er precies gebouwd wordt, niet op het woord dat de leverancier kiest.
Wat een koppeling je oplevert
Er gebeuren twee dingen tegelijk, en het tweede is het interessantst.
Het eerste is meteen zichtbaar. Het overtypen stopt, je gegevens kloppen overal en niemand hoeft nog te controleren of de voorraad in twee systemen hetzelfde is. Dat is de aanleiding waarmee vrijwel elk koppeltraject begint.
Het tweede merk je pas als het draait. Zodra je systemen dezelfde gegevens delen, kun je dingen doen die daarvoor niet konden. Je ziet in één scherm wat een klant besteld, betaald en gevraagd heeft. Je kunt klanten een klantenportaal geven waarin ze hun eigen orders volgen. Je stuurt op cijfers van vanochtend in plaats van op een export van vorige week.
Dat tweede is waar de meeste bedrijven na een koppeling op uitkomen. De besparing is de reden om te beginnen, de kans die erachter zit is de eigenlijke opbrengst: gegevens die eerst vastzaten in het systeem waar ze zijn ingevoerd, kun je vanaf dat moment overal gebruiken.
Waar je een koppeling het eerst tegenkomt
Bijna elk MKB-bedrijf heeft er een paar liggen. Meestal zonder dat iemand ze zo noemt: het heet dan “dat lijstje dat Karin elke maandag bijwerkt”.
| Situatie | Wat de koppeling doet |
|---|---|
| Webshop en boekhouding | Van order naar factuur, zonder tussenstap |
| Exact of AFAS en je eigen systeem | Klanten, facturen en projecten op één waarheid |
| Planning en urenregistratie | Geplande uren worden geschreven uren |
| CRM en offertesysteem | Eén klantgegeven, overal hetzelfde |
| Voorraad en verkoopkanalen | Wat verkocht is, is overal meteen af |
| Leverancier en inkoop via EDI | Binnenkomende orders direct in je eigen systeem |
Herken je hier twee of meer van, dan zit er waarschijnlijk een halve dag per week in die niemand als werk heeft geboekt. Lees ook hoe software koppelen in de praktijk verloopt als je meerdere van deze stromen tegelijk hebt.
Welke koppelvraag heb jij?
Niet elke API-vraag is dezelfde vraag. Loop de beslisboom langs: zeg je “ja”, dan wijst de pijl naar rechts naar jouw uitkomst, zeg je “nee”, dan zak je een vraag lager.
Kom je er niet helemaal uit, of zit je tussen twee uitkomsten?
In een half uur hoor je wat bij jou past, wat het ongeveer kost en wat een slimme eerste stap is. Gratis en vrijblijvend, je zit nergens aan vast.
De drie uitkomsten verschillen in wie de aansluiting levert. Bij een koppeling gebruik je de API’s die er al zijn. Heeft jouw systeem er geen, dan laten we die API bouwen en koppelen we daarna. En bij een eigen API draai je het om: dan bied jij de aansluiting aan, zodat klanten of leveranciers zelf bij de gegevens kunnen die je met ze deelt.
Die laatste komt vaker voor dan bedrijven denken. Zodra een grote afnemer vraagt of ze “erop kunnen aansluiten”, gaat het daarover.
Wat kost een API-koppeling?
Een koppeling tussen twee systemen die allebei een goed gedocumenteerde API hebben, begint vanaf 3.000 euro. Bij Retrii werken we met een vaste prijs per fase, zodat je weet wat er staat voor je begint.
Wat de bandbreedte bepaalt:
- Hoeveel systemen meedoen. Twee is een koppeling, vijf is een landschap.
- Hoe goed de documentatie is. Een nette API scheelt weken. Een systeem waarvan de leverancier zelf niet meer weet hoe het werkt, kost die weken.
- Eén of twee richtingen. Alleen data ophalen is eenvoudiger dan data ophalen én terugschrijven.
- Wat er moet gebeuren als het misgaat. Een koppeling die stilvalt zonder dat iemand het merkt, is duurder dan de foutafhandeling die je vooraf inbouwt.
- Real-time of op vaste momenten. Elke minuut synchroniseren vraagt meer dan één keer per nacht.
Een koppeling tussen twee systemen met bruikbare documentatie staat meestal binnen 2 tot 4 weken live. Moet er eerst een API gebouwd worden op een bestaand systeem, reken dan op meer. Wil je een breder beeld van wat maatwerk kost, kijk dan naar de kosten van maatwerk software.
Vijf vragen die je stelt voor je tekent
- Heeft het andere systeem een gedocumenteerde API? Vraag om de link naar die documentatie, niet om een bevestiging. Het verschil tussen “ja hoor” en een werkende documentatiepagina is soms een maand werk.
- Eén richting of twee? Bepaal welk systeem de baas is over welk gegeven. Zonder die afspraak overschrijven twee systemen elkaars werk.
- Wat gebeurt er als de koppeling stilvalt? Krijgt iemand een melding, of ontdek je het pas als een klant belt over een order die nooit is aangekomen?
- Wie betaalt als de leverancier zijn API verandert? Dat gebeurt, en het is geen storing maar onderhoud. Leg vooraf vast bij wie die rekening ligt.
- Wat kost het per jaar om dit draaiend te houden? Een koppeling is geen eenmalige aankoop. Lees wat er in een SLA of onderhoudscontract hoort te staan voor je tekent.
De volgende stap
Een API-koppeling is de goedkoopste vorm van maatwerk die er bestaat. Je bouwt geen nieuw systeem, je laat de systemen die je al betaalt eindelijk samenwerken. Voor veel bedrijven is dat de eerste stap richting bedrijfsprocessen automatiseren, en meteen de stap met de kortste terugverdientijd.
Weet je welke twee systemen elkaar zouden moeten kennen, dan is de vraag alleen nog hoe. Bekijk wat er mogelijk is met software koppelen, of laat ons een API bouwen op het systeem dat er nu geen heeft.
