Wat is een API-koppeling? Uitleg voor ondernemers

Wat is een API-koppeling?

Een API-koppeling is een stukje software dat twee systemen gegevens laat uitwisselen. Het haalt iets op uit het ene systeem en zet het in het andere. Niemand hoeft het dan over te typen.

De koppeling gebruikt daarvoor de API van beide systemen. Een API is een vaste ingang van een softwarepakket. Achter die ingang liggen afspraken: welke gegevens je mag opvragen, welke je mag versturen en in welke vorm. Je kunt het zien als een loket. Je geeft een aanvraag af op de afgesproken manier, en je krijgt een antwoord terug.

Veel zakelijke pakketten hebben zo’n ingang. Denk aan boekhoudpakketten als Exact Online, AFAS en SnelStart, maar ook aan webshops, CRM-systemen en planningssoftware. Wil je de korte betekenis van het woord? Lees dan het begrip API-koppeling.

Wat is het verschil tussen een API en een API-koppeling?

Een API is de ingang van één systeem. Een API-koppeling is de verbinding die twee van die ingangen gebruikt. De API zit al in het pakket, de koppeling moet iemand maken of aanzetten.

Een vergelijking: de API is de deur van een gebouw. De koppeling is de koerier die bij de ene deur iets ophaalt en het bij de andere deur aflevert. Zonder deur kan de koerier niet naar binnen. Zonder koerier gebeurt er niets.

Hoe werkt een API-koppeling stap voor stap?

Een koppeling volgt vaste regels, in een vaste volgorde. Bijvoorbeeld zo:

1. Er is iets nieuws. De koppeling vraagt op vaste momenten aan het eerste systeem wat er nieuw is. Of dat systeem meldt het zelf, met een webhook.
2. Ophalen. De koppeling haalt de gegevens op, bijvoorbeeld een nieuwe order met de klant erbij.
3. Vertalen. Elk systeem noemt dingen anders. Het ene heeft een ‘klant’, het andere een ‘relatie’. Btw-codes en artikelnummers verschillen ook. De koppeling zet alles om naar de taal van het tweede systeem.
4. Wegschrijven. De koppeling zet de gegevens in het tweede systeem.
5. Controleren. Ging het goed? Dan noteert de koppeling dat in een logboek. Ging het mis? Dan volgt een melding.

Dat vertalen is vaak het meeste werk. Twee systemen kunnen elk prima werken en toch anders denken over wat een klant of een order is. Die regels leg je vooraf vast.

Welke gegevens kun je koppelen?

Je kunt bijna alles koppelen wat een systeem via zijn API beschikbaar maakt. Bij mkb-bedrijven gaat het bijvoorbeeld om:

• klanten en leveranciers (namen, adressen, contactpersonen);
• orders en offertes;
• facturen en de betaalstatus;
• gewerkte uren en planning;
• voorraad en artikelen;
• documenten, zoals een pdf van een factuur.

Denk aan combinaties als webshop en boekhouding, CRM en boekhouding, planning en facturatie, of een webformulier dat een aanvraag in je CRM zet. Typ jij nu ook dingen over? Lees dan hoe je dubbel invoeren herkent.

Wat is het verschil tussen een standaardkoppeling en een koppeling op maat?

Een standaardkoppeling is kant-en-klaar. Een koppeling op maat wordt voor jouw situatie gebouwd. Daartussen zit het koppelplatform.

Standaardkoppeling

Veel pakketten hebben een eigen app-store of overzicht met koppelingen. Exact Online heeft een app store met apps en koppelingen van andere bedrijven. SnelStart heeft een overzicht met koppelingen, bijvoorbeeld met webshops en betaaldiensten. Je zet zo’n koppeling aan en vult een paar instellingen in. De maker houdt hem bij. Wat hij kost, verschilt per koppeling: kijk dat na bij de aanbieder.

Het nadeel: een standaardkoppeling werkt zoals hij werkt. Wil je een uitzondering, een extra controle of een ander veld? Dan kan dat vaak niet.

Koppelplatform

Een koppelplatform is een online dienst waarin je koppelingen zelf in elkaar klikt. Je kiest een begin (‘nieuwe order in de webshop’) en een actie (‘maak een factuur in de boekhouding’). Dat werkt goed voor eenvoudige stappen. Bij veel regels en uitzonderingen wordt het snel onoverzichtelijk.

Koppeling op maat

Een koppeling op maat volgt jouw regels. Hij kan controles doen die bij jouw bedrijf horen, en hij stuurt een melding naar de juiste persoon als iets afwijkt. Het nadeel: iemand moet hem bouwen en onderhouden. Dat kost meer dan een standaardkoppeling aanzetten.

Mijn advies: kijk eerst of er een standaardkoppeling is die doet wat jij nodig hebt. Is die er, gebruik hem dan.

Werkt een koppeling één kant op of twee kanten op?

Dat kies je zelf. Eén kant op is het eenvoudigst: de order gaat van de webshop naar de boekhouding, en terug gaat er niets. Twee kanten op betekent dat een wijziging in het ene systeem ook in het andere komt, en andersom.

Bij twee kanten op moet je één vraag goed beantwoorden: welk systeem heeft het laatste woord? Past iemand een adres aan in het CRM én in de boekhouding, welke versie geldt dan? Spreek je dat niet af, dan overschrijven de systemen elkaar. Daarom is twee kanten op meer werk, en dus ook duurder.

Wat gebeurt er als een koppeling faalt?

Dan komt een gegeven niet aan, of het komt half aan. Dat kan verschillende oorzaken hebben:

• een van de systemen is even niet bereikbaar;
• de toegang is verlopen, bijvoorbeeld een sleutel of wachtwoord;
• de leverancier heeft de API aangepast;
• de gegevens passen niet, zoals een order zonder klantnummer;
• de koppeling stuurt te veel verzoeken achter elkaar. Veel API’s hebben een grens aan het aantal verzoeken per minuut of per dag.

Een goede koppeling vangt dat op. Hij probeert het later opnieuw als een systeem even weg was. Hij zorgt dat een order niet twee keer wordt geboekt. En hij stuurt een melding naar een vaste persoon als het niet lukt, met de reden erbij.

Waarom is een melding bij een fout zo belangrijk?

Een koppeling werkt op de achtergrond. Niemand kijkt ernaar. Zonder melding merk je een fout pas als een klant belt over een factuur die niet klopt, of als de cijfers aan het eind van de maand niet sluiten. Met een melding weet je het op het moment dat het gebeurt. Dan los je één order op, en niet een hele stapel.

Wat heb je nodig voor een API-koppeling?

Je hebt toegang tot beide systemen nodig, en afspraken over de gegevens. Op een rij:

• Een API in beide systemen. Vraag na of je pakket er een heeft, en of hij in je abonnement zit. Soms vraag je de toegang eerst aan. SnelStart heeft daar bijvoorbeeld een aanvraagformulier voor.
• Inloggegevens voor de koppeling. Meestal een API-sleutel of een inlog via OAuth. Geef de koppeling alleen de rechten die hij nodig heeft.
• Afspraken over persoonsgegevens. Gaan er gegevens van klanten of medewerkers door de koppeling? Dan geldt de AVG. Verwerkt een andere partij die gegevens voor jou, bijvoorbeeld omdat de koppeling bij die partij draait? Dan sluit je met die partij een verwerkersovereenkomst.
• Iemand die het werk kent. Een collega die weet hoe het nu gaat, en welke uitzonderingen er zijn.
• Een vaste persoon voor meldingen. Wie lost het op als er iets misgaat?

Is een API-koppeling veilig?

Een koppeling is zo veilig als je hem inricht. Een paar basisregels helpen. Geef de koppeling alleen toegang tot de gegevens die hij nodig heeft. Bewaar sleutels en wachtwoorden op een veilige plek, niet in een e-mail of een gedeeld document. Stuur alleen gegevens door die het andere systeem nodig heeft. En leg vast wie de koppeling beheert en wie de meldingen krijgt.

Een koppeling haalt ook tikfouten weg: hij neemt de gegevens over zoals ze zijn. Dat werkt twee kanten op. Staat er een fout in het eerste systeem, dan staat die straks ook in het tweede.

Wanneer blijft overtypen goedkoper dan koppelen?

Overtypen is prima als het om weinig werk gaat. Een koppeling kost geld om te bouwen en om bij te houden. Dat moet opwegen tegen het werk dat hij overneemt. Overtypen is vaak de betere keuze als:

• het om een paar regels per week gaat;
• je manier van werken nog vaak verandert;
• je een van de systemen binnenkort vervangt;
• een van de systemen geen API heeft. Dan is een export die je op vaste momenten inleest soms een goed alternatief.

Twijfel je? Schrijf dan een paar weken op hoe vaak iemand overtypt, hoe lang dat duurt en welke fouten daaruit komen. Dan zie je vanzelf of een koppeling past. Lees ook wat een API-koppeling kost.

Hoe help ik je met een API-koppeling?

Ik begin met een bedrijfsanalyse. Ik kijk welke gegevens waar worden overgetypt, welke systemen je hebt en of er al een standaardkoppeling bestaat die genoeg is. Ik krijg geen provisie van leveranciers. De analyse kost €500 per dag, aanbevolen is een week. Daarna krijg je een voorstel met een vaste prijs.

Moet er een koppeling op maat komen, dan bouw ik die zelf. Een koppeling tussen twee systemen kost bij mij vanaf €4.500, exclusief btw. Daar zit een melding bij als er iets misgaat. Hosting en onderhoud spreken we per maand in overleg af. Lees meer over hoe ik koppelingen en automatisering aanpak, of plan een gesprek.

Veelgestelde vragen

Bronnen: Exact Online app store, SnelStart: koppelingen, SnelStart: API-koppeling aanvragen, Exact Online REST API, AFAS: externe software koppelen met Profit en Autoriteit Persoonsgegevens: verantwoordelijke en verwerker. Geraadpleegd op 7 oktober 2026.