API integratie laten maken: prijs, traject en stappen

Een API-integratie laten maken kost vanaf 5.000 euro als data één kant op stroomt, en 7.500 tot 15.000 euro zodra beide systemen elkaar bijwerken met transformatie onderweg. Een standaardkoppeling staat in twee tot vier weken live.

Wat dat bedrag bepaalt is niet het merk van je pakket, maar de richting van de data en de kwaliteit van de documentatie aan de andere kant.

Dit artikel gaat over het traject van zo'n systeemintegratie in het MKB: wat de prijs opdrijft, hoe je een koppeling inbouwt in systemen die al draaien, en wat er in een offerte hoort te staan.

Wil je eerst weten wát een API is en welke soorten er bestaan, begin dan bij wat is een API. Het bredere plaatje van bouwen versus kopen staat in onze complete gids over maatwerk software.

Wat dat waard is, hangt af van hoeveel overtypwerk er nu ligt.

In de integratietrajecten die wij begeleiden zetten medewerkers 15 tot 25 uur per week data over tussen webshop, CRM, boekhouding en marketingtool. Als rekenvoorbeeld: bij een uurloon van 45 euro en 47 werkbare weken is dat 31.000 tot 53.000 euro per jaar aan capaciteit.

Wat kost het om een API-integratie te laten maken?#

De prijs volgt de richting van de data, niet het merk van het pakket. Dit zijn de bandbreedtes die wij hanteren, met een vaste prijs na scoping.

Drie dingen duwen een offerte omhoog, en geen ervan staat in de featurelijst van je software.

• Documentatie aan de andere kant. Een moderne REST-API met voorbeelden koppel je in dagen, een SOAP-interface met een strikt XML-schema kost weken.
• Logica onderweg. Zodra btw-codes, grootboekrekeningen of klantnummers vertaald moeten worden, verschuift het werk van koppelen naar mappen.
• Volume. Boven een paar duizend transacties per dag heb je een queue en retry-mechanisme nodig, geen scriptje.

Die laatste regel in de tabel is geen sluitpost. API's veranderen buiten jouw invloed om, en een koppeling zonder beheer stopt vroeg of laat met werken op een moment dat jij het niet ziet.

De volledige tarieven per systeem staan op onze dienstpagina API-koppeling laten maken.

Hoe integreer je een API in je bestaande systemen?#

Het lastigste aan een koppeling is zelden de API. Het is dat er al gewerkt wordt in de systemen die je aan elkaar hangt.

Bij maatwerksoftware naast een bestaand ERP-systeem is dat extra voelbaar: het ERP blijft leidend voor stamdata, artikelen en voorraad, de maatwerkapplicatie doet het proces eromheen. Dat patroon zie je terug in groothandel software en in de zorg, en de eerste vraag is er steeds dezelfde — welk systeem wint als beide hetzelfde veld wijzigen?

Zes stappen, in de volgorde waarin wij ze doorlopen.

1. Bepaal de richting per veldgroep, niet per systeem. "Exact koppelen aan de webshop" is geen scope.

"Orders en relaties naar Exact, betaalstatus terug" wel — en dat verschil is meteen het verschil tussen 5.000 en 15.000 euro.

2. Lees de documentatie voordat er een offerte ligt. Goede docs bevatten endpoints, authenticatie, voorbeeldverzoeken en foutcodes, en wij beoordelen ze voordat we een prijs noemen.

Bosman ICT Services rekent documentatie en overdraagbaarheid niet voor niets tot de selectiecriteria voor een ontwikkelaar.

Een leverancier die "open API" adverteert zonder publieke documentatie is een risico dat je vooraf wilt kennen.

3. Regel authenticatie zoals de leverancier het bedoeld heeft. Exact Online, Google en Microsoft werken met OAuth 2.0 en tijdelijke tokens die automatisch worden ververst.

De fout die wij het vaakst tegenkomen: sleutels hardcoded in broncode in plaats van in omgevingsvariabelen. Inspark waarschuwt dat API's vaak niet goed beveiligd zijn en dat bedrijven een API-beveiligingsarchitectuur missen.

4. Maak de datamapping expliciet — daar zit het echte werk. Welk veld in systeem A wordt welk veld in systeem B?

Wat gebeurt er met een btw-code die aan de andere kant niet bestaat, en wie is leidend als beide systemen een adres hebben gewijzigd?

Deze vragen beantwoord je op papier, niet in code.

5. Kies per datastroom synchroon of asynchroon. Synchroon betekent wachten op antwoord: een iDEAL-betaling moet bevestigd zijn voordat de order doorgaat.

Asynchroon betekent doorwerken en later bijwerken, want of een boeking drie seconden of drie minuten later in je boekhouding staat maakt niemand uit.

Synchroon koppelen waar het niet hoeft, maakt je webshop afhankelijk van andermans uptime.

6. Bouw retry, logging en monitoring vóór livegang. Elke serieuze API beperkt het aantal verzoeken per tijdseenheid, en zelden met één vast getal: Mollie berekent limieten dynamisch per merchant en per endpoint, met aparte limieten voor lezen en schrijven.

Zonder queue verlies je bij overschrijding data. Zonder alert hoor je het van je klant.

Wat je zelf aanlevert bepaalt de doorlooptijd meer dan de techniek: een testomgeving met echte data, iemand die de bedrijfsregels kent, en een beslisser die knopen doorhakt over uitzonderingen. Ontbreekt die derde, dan wordt twee tot vier weken al snel acht.

Hoe ziet zo'n traject er in de praktijk uit?#

Neem de meest voorkomende vraag in het Nederlandse MKB: een bestelling in WooCommerce die automatisch een factuur wordt in Exact Online.

Volgens Browsable ondersteunen de meeste van die oplossingen automatische synchronisatie van bestellingen, klanten, producten en voorraadniveaus. De installatiehandleiding van Combidesk laat zien hoe ver dat aan de boekhoudkant gaat: facturen, btw-code, grootboekrekening, dagboek en debiteuren.

De dataflow is eenvoudig: WooCommerce stuurt de ordergegevens naar de Exact Online API, Exact maakt de factuur aan en geeft het factuurnummer terug, WooCommerce slaat dat nummer op zodat het op de bevestigingsmail staat.

Het werk zit in de randen. Wat gebeurt er bij een creditnota, een klant die zowel particulier als zakelijk bestelt, of een btw-tarief dat in je webshop anders heet dan in je grootboek?

Een kant-en-klare connector dekt de standaardgevallen tegen een vast maandbedrag. Zodra jouw randgevallen niet standaard zijn, betaal je maandelijks voor een oplossing die je alsnog handmatig repareert — het moment waarop een Exact Online-koppeling op maat goedkoper uitpakt.

API of webhook: wie stuurt de data?#

Deze keuze maak je per stroom, en hij heeft gevolgen voor wat je laat bouwen.

Een API is pull-gebaseerd: jouw systeem vraagt actief om data, op schema of op verzoek. Een webhook is push-gebaseerd: de bron stuurt een bericht zodra er iets verandert.

De consequentie voor je offerte: bij een webhook moet je bouwer rekening houden met dubbele leveringen. Betaalproviders sturen hetzelfde bericht soms twee keer, en zonder idempotentiecontrole boek je de betaling ook twee keer.

Dat is een halve dag werk vooraf en een pijnlijke reconciliatie achteraf.

Onze koppelingen zetten daarom standaard beide in: een webhook voor snelheid, en een periodieke controleronde via de API die ophaalt wat gemist is.

Wat gaat er mis in integratieprojecten?#

Drie aannames kosten in de praktijk het meeste geld.

"Een API-integratie is eenmalig." PostNL wijzigt endpoints, Exact Online vernieuwt authenticatieprotocollen, Mollie past limieten aan. Zonder onderhoud stopt een koppeling vroeg of laat met werken, meestal op een moment dat jij het niet ziet.

Koop het af in een beheercontract, of zet er structureel tijd voor opzij.

"Zapier of Make is altijd goed genoeg." Voor twee systemen met laag volume klopt dat, en dan zeggen we het ook. Maar je betaalt per taak: bij duizenden transacties per dag loopt dat op, en je data loopt via een derde partij — voor zorg of finance een compliance-vraag die je vooraf wilt beantwoorden.

"Werkt het bij tien orders, dan werkt het bij duizend." Rate limits, time-outs en queuing manifesteren zich pas onder belasting. HelpDisk rekent "uitzonderingen niet meenemen" en "testen als sluitstuk zien" tot de zeven meestgemaakte fouten bij systeemintegraties.

Waar let je op bij de leverancier?#

Vier punten die je vastlegt voordat je tekent, omdat ze achteraf onderhandelen niet meer kan.

• Eigendom van de code. Draait de koppeling op jouw infrastructuur en is de broncode van jou, of huur je toegang tot iets van de leverancier?
• Beheer van de sleutels. Wie bezit de API-credentials, en wat gebeurt er als jullie uit elkaar gaan?
• Wat valt onder beheer. Een API-versie-upgrade die de leverancier van je boekhoudpakket afdwingt: onderhoud of meerwerk? Dat onderscheid is waar de rekening ontstaat.
• Monitoring en melding. Krijg jij een alert als de koppeling stilvalt, of hoor je het van de klant die zijn factuur mist?

Van offerte naar werkende koppeling#

Een API-integratie laten maken is geen technisch project maar een afsprakenproject. De techniek is in dagen geregeld; de richting van de data, de uitzonderingen en de vraag wie leidend is bij tegenstrijdige wijzigingen bepalen zowel de prijs als de kans dat het over twee jaar nog werkt.

Concreet: schrijf per veldgroep op welke kant de data op moet, lees de documentatie van beide systemen voordat je offertes vergelijkt, en vraag naar de beheerpost in plaats van alleen naar de bouwsom. Wat dat in totaalkosten betekent voor een groter traject, staat in kosten maatwerk software.

Wil je weten welke koppeling voor jouw bedrijf het meeste oplevert? Bereken je besparingspotentieel in twee minuten, of neem contact op voor een scoping van één concrete koppeling.