Terug naar Blog

Software en tools

API koppeling laten maken: drie routes, de kosten en wat je vooraf vastlegt

API koppeling laten maken? Zo kies je tussen een kant-en-klare koppeling, een koppelplatform of maatwerk, wat de prijs bepaalt en wat je vooraf vastlegt.

aiworktalent Redactie · · 16 min leestijd

API koppeling laten maken: drie routes, de kosten en wat je vooraf vastlegt

Een API koppeling laten maken betekent dat je twee systemen automatisch gegevens laat uitwisselen, bijvoorbeeld je webshop en je boekhouding. Vaak hoeft daar niets voor gebouwd te worden. Kijk eerst of er een kant-en-klare koppeling bestaat, dan of een koppelplatform het kan, en kies pas daarna voor maatwerk. Wat het kost, hangt naast de techniek vooral af van hoe goed je vooraf vastlegt wat er moet gebeuren.

Deze post gaat over het laten maken zelf: de route, de prijs, je vraag aan een specialist en de afspraken over code en sleutels. De technische valkuilen, zoals velden die niet op elkaar passen en limieten op het aantal aanroepen, staan in het artikel over koppelen aan je bestaande systemen. Die herhalen we hier niet.

Wat is een API-koppeling, in gewone taal?

Een API is een afgesproken loket van een softwarepakket. Via dat loket mag een ander programma gegevens opvragen of afleveren, volgens vaste regels. Een koppeling is het stukje software dat bij het ene loket iets ophaalt en het bij het andere aflevert. Komt er een betaalde bestelling binnen in je webshop, dan maakt de koppeling er een verkoopfactuur van in je boekhouding. Zonder koppeling tikt iemand dat over.

Een koppeling kan op vaste momenten vragen of er iets nieuws is, bijvoorbeeld elke vijf minuten. Of het bronsysteem meldt het zelf zodra het gebeurt; dat heet een webhook. Niet elk pakket kan dat tweede, en dat bepaalt mee hoe snel gegevens aan de andere kant staan.

Hoe zo'n loket eruitziet, verschilt per pakket. Neem AFAS Profit als voorbeeld. Dat heeft een eigen API met GetConnectoren om gegevens op te halen en UpdateConnectoren om ze toe te voegen, te wijzigen of te verwijderen. De toegang regel je in een App Connector: daarin maak je een token aan en bepaal je welke connectoren dat token mag gebruiken. Een specialist die het pakket kent, weet meteen wat er kan, en dat scheelt uren.

Heeft een systeem geen API, dan lukt koppelen vaak toch via een omweg zoals een exportbestand. Dat is wel kwetsbaarder en duurder in onderhoud.

Systemen koppelen: drie routes en wanneer welke past

Wie systemen wil koppelen, heeft drie routes. Ze verschillen in prijs, in hoeveel je kunt aanpassen en in wie verantwoordelijk is als het stopt met werken.

Route Wat het is Past als Let op
Kant-en-klare koppeling Een koppeling uit de app-store of het partneroverzicht van je software, gebouwd en onderhouden door een ander. Je pakketten en je werkwijze gangbaar zijn. Je kunt weinig aanpassen. Controleer welke velden wel en niet overkomen.
Koppelplatform Een tussenstation zoals Zapier, Make of n8n, waarin stappen aan elkaar worden geklikt. Er geen kant-en-klare koppeling is, of je net andere regels nodig hebt. Het abonnement groeit mee met het gebruik. Het platform ziet je gegevens langskomen.
Maatwerk Code die speciaal voor jouw situatie wordt geschreven en op een server draait. De logica ingewikkeld is, het volume groot, of de koppeling bedrijfskritisch. Hoogste eenmalige kosten. Iemand moet hem hosten, bewaken en bijwerken.

Route 1: de kant-en-klare koppeling

Begin hier, ook als je denkt dat jouw situatie bijzonder is. Veel pakketten hebben een overzicht van koppelingen die anderen al hebben gebouwd. AFAS verwijst bijvoorbeeld naar partner.afas.nl voor bestaande oplossingen die plug and play zijn. Volgens de eigen helppagina hebben AFAS-partners hun koppeling gecertificeerd en zijn ze verplicht security tests te doen. Zo'n koppeling is soms gratis en soms een maandbedrag van de aanbieder.

Je neemt wel wat er is. Vraag daarom na welke velden er precies overgaan, in welke richting, en wie het oplost als het misgaat. Doet de koppeling negentig procent van wat je wilt? Dan is het vaak goedkoper om de rest in je werkwijze op te lossen dan er maatwerk omheen te laten bouwen.

Route 2: een koppelplatform

Een koppelplatform zit tussen je systemen in. Je bouwt er een reeks stappen in: als in systeem A dit gebeurt, doe dan dat in systeem B. Een eenvoudige koppeling tussen twee moderne pakketten kun je soms zelf maken. Een specialist is vooral nuttig voor de uitzonderingen: een klant die nog niet bestaat, een leeg veld, een systeem dat even niet reageert.

De platforms rekenen elk anders af, waardoor het prijsverschil groter is dan de tarieventabellen doen vermoeden. Hoe je dat voor jouw situatie uitrekent, staat in de vergelijking n8n vs Zapier, met Make als derde optie.

Route 3: maatwerk

Maatwerk is code die alleen voor jou bestaat. Elke regel, uitzondering en controle kan erin. Het betekent ook dat er een server nodig is en iemand die de code bijhoudt. Maatwerk loont vooral bij veel gegevens, bij regels die te ingewikkeld worden voor een platform, of als een storing direct geld kost. Een tussenvorm komt ook voor: een koppelplatform voor het gewone werk, met één stukje eigen code voor de stap die het platform niet kan.

Wat kost een API koppeling laten maken?

Een onafhankelijke bron die publiceert wat een koppeling gemiddeld kost, hebben wij niet gevonden. De bedragen die je online tegenkomt, komen vrijwel altijd van partijen die koppelingen bouwen of verkopen. Wat wel gemeten is, is het uurtarief. Volgens het Knab Zzp Uurtarievenboekje 2026, onderzoek onder meer dan 20.000 zzp'ers, rekent een zelfstandige software developer gemiddeld 94 euro per uur exclusief btw. Dat is zelfrapportage: een indicatie, geen prijslijst.

De eenmalige kosten zijn dan uren keer tarief. Een rekenvoorbeeld met verzonnen uren: zestien uur werk kost bij 94 euro ruim 1.500 euro exclusief btw, veertig uur ongeveer 3.760 euro. Hoeveel uur het bij jou wordt, hangt vooral af van deze punten:

  • De documentatie van beide systemen. Een goed beschreven API met een testomgeving scheelt uren zoeken en proberen.
  • Eén of twee richtingen. Gegevens alleen van A naar B sturen is veel eenvoudiger dan twee systemen die elkaar bijwerken.
  • Het aantal velden en uitzonderingen. Elke regel als "behalve bij buitenlandse klanten" is extra bouwen en extra testen.
  • De staat van je gegevens. Dubbele klanten of rommelige artikelcodes moeten eerst worden opgeschoond.
  • Foutafhandeling. Een koppeling die netjes meldt wat er misging, kost meer dan een die alleen werkt als alles goed gaat. Dat is het waard.

Vraag daarom geen totaalbedrag, maar een urenraming per onderdeel: uitzoeken, bouwen, testen, documenteren en opleveren. Dan kun je twee offertes echt naast elkaar leggen.

De kosten die doorlopen

Een koppeling is nooit helemaal af. De systemen aan beide kanten veranderen, en de koppeling moet mee. Zet deze posten in je begroting:

Post Wat het is Waar je op let
Abonnement Het maandbedrag van een kant-en-klare koppeling of van het koppelplatform. Bij platforms groeit het mee met hoe vaak de koppeling draait.
API-toegang Niet elk pakket biedt de API in elk abonnement aan, en er kunnen limieten gelden. Vraag bij beide leveranciers na of je huidige abonnement API-toegang bevat, en tot welke limiet.
Hosting De server waarop maatwerkcode draait. Zet dit op naam van je eigen bedrijf, niet op die van de bouwer.
Onderhoud Aanpassen als een leverancier zijn API verandert of een oude versie uitzet. Spreek vooraf af wie dat doet, binnen welke tijd en tegen welk tarief.

Hoe vaak zo'n API-wijziging voorkomt, verschilt per leverancier. Shopify is een duidelijk voorbeeld. Volgens de eigen documentatie brengt Shopify elke drie maanden een nieuwe API-versie uit, en wordt elke stabiele versie minimaal twaalf maanden ondersteund. Een maatwerkkoppeling met een Shopify-webshop moet je dus minstens eens per jaar laten nalopen. Vraag bij elk pakket na hoe dat ritme eruitziet.

Wat je vastlegt voordat je een specialist vraagt

De grootste besparing zit niet in een lager uurtarief, maar in een duidelijke vraag. Een specialist die moet raden wat je bedoelt, rekent die onzekerheid mee of komt later met meerwerk. Schrijf deze zes punten op, ook als je ze nog niet allemaal zeker weet:

  1. Welke gegevens. Niet "de klanten", maar welke velden: naam, adres, btw-nummer, e-mailadres. Wat niet nodig is, laat je weg.
  2. Welke richting. Van de webshop naar de boekhouding, of ook terug?
  3. Hoe vaak en hoe snel. Moet een bestelling binnen een minuut in je boekhouding staan, of is eens per nacht genoeg?
  4. Wie de bron van de waarheid is. Per gegeven één systeem dat wint als er een verschil is. Bijvoorbeeld klantgegevens uit het CRM en de betaalstatus uit de boekhouding.
  5. Wat er gebeurt bij fouten. Wie krijgt een melding, wat gebeurt er met een record dat niet over kon, en wie zet het recht?
  6. Hoeveel en sinds wanneer. Om hoeveel bestellingen of klanten per maand gaat het, en moeten oude gegevens ook mee?

Zo'n omschrijving hoeft niet lang te zijn. Een fictief voorbeeld: "Bij elke betaalde bestelling in de webshop moet er binnen een uur een verkoopfactuur in de boekhouding staan, met klant, artikelen en btw. Bestaat de klant nog niet, maak hem dan aan op basis van het e-mailadres. Lukt het niet, dan krijgt de administratie een mail met het bestelnummer. Het gaat om ongeveer tweehonderd bestellingen per maand. Oude bestellingen hoeven niet mee." Met die vijf zinnen kan een specialist een serieuze raming maken.

Afspraken over code, toegang en sleutels

Een koppeling is klein, en juist daarom wordt er weinig over afgesproken. Tot de bouwer onbereikbaar is en niemand weet waar de code staat. Leg deze punten vast, ook bij een klus van een paar dagen:

  • Eigendom van de code. Betalen voor de bouw maakt je niet automatisch eigenaar: het auteursrecht ontstaat bij degene die de code schrijft. Huur je een zelfstandige of een bureau in, dan blijft het daar tenzij je de overdracht schriftelijk regelt. Hoe je dat doet, staat in het artikel over maatwerksoftware laten maken. Spreek ook af dat de code in een omgeving staat waar jij bij kunt.
  • Accounts op jouw naam. Het account bij het koppelplatform en de hosting horen op naam van je eigen bedrijf te staan. De specialist krijgt daarin een eigen gebruiker, die je uitzet als de samenwerking stopt.
  • Sleutels in jouw omgeving. Een API-sleutel is het wachtwoord van de koppeling. Laat de specialist die zelf in jouw account aanmaken, met alleen de rechten die de koppeling nodig heeft. Bij AFAS kan dat via de App Connector, waarin je per token bepaalt welke connectoren het mag gebruiken.
  • Documentatie. Wat de koppeling doet, welke velden overgaan, waar code en instellingen staan, en wat je doet bij de meest voorkomende fout. Genoeg om een andere specialist het te laten overnemen.
  • Bewaking en foutmeldingen. Wie krijgt een melding als het misgaat, en binnen welke tijd reageert de bouwer? Een koppeling die stil faalt, merk je pas als een klant belt over een factuur die nooit kwam.
  • Onderhoud. Wie past de koppeling aan als een leverancier zijn API wijzigt, en tegen welk tarief? Leg dat vast voordat het nodig is.

Bij een kant-en-klare koppeling ben je geen eigenaar maar gebruiker. Daar telt vooral wie hem onderhoudt, en wat er met je gegevens en je werkwijze gebeurt als de aanbieder ermee stopt.

Privacy en beveiliging

Er gaan bijna altijd persoonsgegevens door een koppeling. Het koppelplatform of de hostingpartij verwerkt die gegevens dan voor jou, en vaak de specialist ook. Met elke partij die persoonsgegevens in jouw opdracht verwerkt, sluit je een verwerkersovereenkomst; artikel 28 van de AVG eist dat. Het Ondernemersplein zegt erbij dat je zelf verantwoordelijk blijft voor wat je uitbesteedt. Wat er in zo'n overeenkomst hoort, staat in het artikel over de verwerkersovereenkomst.

Het Ondernemersplein geeft nog een regel die bij koppelingen veel scheelt: "Vraag nooit meer persoonsgegevens dan nodig." Koppel dus alleen de velden die aan de andere kant echt gebruikt worden. Een boekhouding heeft een factuuradres nodig, geen geboortedatum of klantnotities. Vraag ook waar het koppelplatform je gegevens verwerkt. Gaan ze buiten de Europese Economische Ruimte, dan gelden er extra regels voor die doorgifte.

Dan de sleutels. Stuur een API-sleutel nooit per mail of chat, want daar blijft hij jarenlang staan. Laat de specialist de sleutel zelf in jouw omgeving aanmaken, of gebruik de deelfunctie van een wachtwoordmanager. Vervang sleutels als de samenwerking stopt. Kan iemand met een gelekte sleutel bij klantgegevens, dan kan dat een datalek zijn. Volgens het Ondernemersplein meld je een datalek binnen 72 uur na ontdekking bij de Autoriteit Persoonsgegevens als er gevolgen kunnen zijn voor de mensen om wie het gaat. Een verwerker moet zo'n lek aan zijn opdrachtgever melden. Spreek dus af hoe snel je specialist je waarschuwt.

Waar AI wel en niet past

Een gewone koppeling is geen AI. Hij volgt vaste regels: als dit veld gevuld is, zet het daar neer. Dat is automatisering, en dat wil je ook, want het doet elke keer hetzelfde. Wie je een "AI-koppeling" verkoopt voor iets wat alleen gegevens van A naar B zet, verkoopt je een woord.

AI past wel waar de invoer geen vaste vorm heeft. Denk aan inkoopfacturen als pdf van tientallen leveranciers, elk met een eigen opmaak, of bestellingen die als vrije tekst in een e-mail binnenkomen. Een AI-model kan daar velden als leverancier, bedrag en factuurnummer uithalen. Daarna brengt de gewone koppeling ze verder. AI is dan een voorstap, niet de koppeling zelf.

Reken er wel op dat zo'n model soms een fout maakt. Bouw daarom een controle in: bedragen die niet optellen of een onbekende leverancier gaan eerst langs een mens. En voor het model betaal je meestal per gebruik, bovenop de andere kosten.

Wanneer je beter geen koppeling laat maken

  • Het volume is klein. Tik je tien orders per maand over, reken dan uit hoeveel tijd dat echt kost. Een koppeling met abonnement en onderhoud verdient zich dan soms nooit terug.
  • Je werkwijze ligt nog niet vast. Een koppeling legt je huidige proces vast. Verander je over drie maanden van aanpak, dan betaal je twee keer.
  • Er komt een pakketwissel aan. Ga je volgend jaar over op een ander boekhoudpakket, laat dan nu geen maatwerk bouwen op het oude.
  • Niemand leest de meldingen. Pakt niemand in je bedrijf een foutmelding op, dan vervang je zichtbaar handwerk door onzichtbare fouten.
  • Alles zou op naam van de bouwer komen. Eerst de accounts op jouw naam, dan pas bouwen.

Soms is een bureau de betere keuze dan een zelfstandige. Bijvoorbeeld als de koppeling bedrijfskritisch is, buiten kantooruren bewaakt moet worden, of als er veel systemen aan elkaar hangen. Eén persoon kan ziek of op vakantie zijn, en dan ligt je koppeling stil.

Veelgestelde vragen

Wat kost een API koppeling laten maken?

Dat hangt vooral af van de route. Een kant-en-klare koppeling is soms gratis en soms een maandbedrag. Een koppelplatform kost een abonnement plus de uren om het in te richten. Bij maatwerk betaal je vooral uren. Een onafhankelijke bron voor wat een koppeling gemiddeld kost, hebben wij niet gevonden. Volgens het Knab Zzp Uurtarievenboekje 2026 rekent een zelfstandige software developer gemiddeld 94 euro per uur exclusief btw. Een rekenvoorbeeld met verzonnen uren: zestien uur werk kost bij dat tarief ruim 1.500 euro, veertig uur ongeveer 3.760 euro. Reken daarnaast op doorlopende kosten: abonnementen, hosting en onderhoud als een leverancier zijn API wijzigt.

Wat is het verschil tussen een kant-en-klare koppeling, een koppelplatform en maatwerk?

Een kant-en-klare koppeling haal je uit de app-store of het partneroverzicht van je software. Iemand anders heeft hem gebouwd en onderhoudt hem; jij zet hem aan en stelt hem in. Een koppelplatform zoals Zapier, Make of n8n is een tussenstation waarin jij of een specialist stappen aan elkaar klikt. Maatwerk is code die speciaal voor jouw situatie wordt geschreven en op een server draait. Kijk in die volgorde: eerst kant-en-klaar, dan een platform, en pas maatwerk als de eerste twee niet volstaan.

Hoe gaat het maken van een AFAS-koppeling in de praktijk?

AFAS Profit heeft een eigen API. Gegevens ophalen gaat via GetConnectoren, gegevens toevoegen, wijzigen of verwijderen via UpdateConnectoren. Toegang regel je in een App Connector: daarin maak je een token aan en bepaal je welke connectoren dat token mag gebruiken. Zo geef je een koppeling alleen de rechten die hij nodig heeft. Voor bestaande koppelingen verwijst AFAS naar partner.afas.nl. Volgens de helppagina van AFAS hebben partners hun koppeling gecertificeerd en moeten ze security tests doen. Kijk dus eerst of je koppeling daar al bestaat voordat je iets laat bouwen.

Wie is eigenaar van een koppeling die ik laat bouwen?

Niet automatisch jij. Het auteursrecht op code ontstaat bij degene die hem schrijft. Huur je een zelfstandige of een bureau in, dan blijft het daar tenzij je de overdracht schriftelijk regelt. Spreek ook af dat de code in een omgeving staat waar jij bij kunt. Zet de accounts van het koppelplatform en de hosting op naam van je eigen bedrijf, en vraag bij oplevering om documentatie. Bij een kant-en-klare koppeling ben je geen eigenaar maar gebruiker. Daar telt vooral wie hem onderhoudt en wat er gebeurt als de aanbieder ermee stopt.

Hoe deel ik API-sleutels veilig met een specialist?

Het liefst deel je ze helemaal niet. Geef de specialist een eigen gebruiker in je systemen of je koppelplatform, zodat hij de sleutel zelf in jouw omgeving aanmaakt en jij die later kunt intrekken. Moet een sleutel toch over, gebruik dan de deelfunctie van een wachtwoordmanager en niet de mail of een chat. Geef een sleutel alleen de rechten die de koppeling nodig heeft, en vervang hem als de samenwerking stopt. Kan iemand met een gelekte sleutel bij klantgegevens, dan kan dat een datalek zijn. Kunnen er gevolgen zijn voor de mensen om wie het gaat, dan meld je het binnen 72 uur na ontdekking bij de Autoriteit Persoonsgegevens.

Een API koppeling laten maken wordt zelden duur door de techniek. Het wordt duur door een vage vraag en door wat er niet is afgesproken. Denk aan wie de sleutels heeft, op wiens naam het account staat en wie de koppeling bijwerkt als een leverancier zijn API verandert. Kijk eerst of er een kant-en-klare koppeling bestaat, schrijf de zes punten uit dit artikel op, en vraag een urenraming per onderdeel. Wil je een specialist inhuren voor je koppeling of automatisering? Plaats je opdracht op aiworktalent en ontvang voorstellen van specialisten, zodat je de aanpakken naast elkaar kunt leggen voordat je kiest.

Dit artikel geeft een algemeen overzicht van het laten maken van een koppeling; wat bij jouw situatie past, hangt af van je systemen, je volume en je risico's. Het uurtarief komt uit het Knab Zzp Uurtarievenboekje 2026 en is zelfrapportage door zzp'ers, geen CBS-statistiek; de rekenvoorbeelden gebruiken verzonnen uren. De beschrijvingen van AFAS en Shopify komen uit hun eigen documentatie, stand 2 november 2026, en die documentatie verandert regelmatig. De privacypassages zijn de hoofdlijn van 2 november 2026; raadpleeg bij twijfel een jurist. Dit is geen aanbeveling van een specifiek product en geen juridisch advies.