API-koppeling: wat het kost en wat er stukgaat

In het kort

Een API-koppeling is geen datatransport, maar een afspraak over wat er gebeurt als het transport misgaat. De kosten zitten in de uitzonderingen: een record dat twee keer binnenkomt, een veld dat in het ene systeem leeg mag zijn en in het andere verplicht is, een token dat zondagnacht om 03:00 verloopt. Reken op ongeveer een derde van het werk voor het gelukkige pad en twee derde voor de rest. Vraag in elke offerte expliciet wat er bij een fout gebeurt.

Van bericht tot factuur

Waar een koppeling op staat of valt

Data verplaatsen is het makkelijke deel. Dit zijn de vijf plekken waar het werk echt zit.

Verbinden
Twee systemen, één waarheid
Een koppeling verplaatst geen data maar afspraken: welk systeem gelijk heeft als de twee verschillen.
E-factuur
De factuur werd een dataformaat
Sinds 2026 is de e-factuur in de regio de norm aan het worden. Wie nu koppelt, bouwt daarvoor.
De offerte
Wat de prijs bepaalt
Niet het bericht maar de uitzonderingen: deelontvangsten, correcties en wat er gebeurt bij storing.
Limieten
Waar het echt tegenaan loopt
Rate limits, batchvensters en time-outs bepalen het ontwerp meer dan het gewenste berichtje per seconde.
Wanneer niet
Soms volstaat een export
Bij laag volume en weinig wijzigingen is een dagelijkse export goedkoper en robuuster dan een koppeling.

Wat het is

Wat een koppeling moet doen behalve data verplaatsen

Een werkende koppeling beantwoordt vier vragen die in een demo nooit aan bod komen. Staat dat niet in het voorstel, dan is het gelukkige derde deel geoffreerd.

Idempotentie. Als hetzelfde bericht twee keer binnenkomt, ontstaat er dan een dubbele order, of wordt het herkend en genegeerd? Herhaalpogingen zijn normaal, dus dubbelingen zijn zonder dit gegarandeerd.
Veldmapping bij onenigheid. Het ene systeem staat een lege klantreferentie toe, het andere eist hem. De mapping moet kiezen, en iemand moet die keuze bezitten.
Zichtbaarheid van fouten. Als een bericht om 02:00 faalt, wie hoort dat dan, en hoe? Een koppeling waar niemand naar kijkt, is een koppeling die al gestopt is.
Opnieuw versturen. Kunt u na een storing de laatste vier uur veilig opnieuw aanbieden? Zo niet, dan is het herstel handwerk en kost de storing een dag.

Wat er veranderde

Wat er in 2026 veranderde: de factuur werd een dataformaat

Tot voor kort mocht een Nederlands bedrijf koppelen als een efficiencyvraag behandelen. In de loop van 2026 werd het een handelsvoorwaarde, en die verandering kwam uit Brussel en niet uit Den Haag.

Sinds 1 januari 2026 wisselen Belgische btw-plichtige ondernemingen onderling gestructureerde elektronische facturen uit, via het Peppol-netwerk in Peppol BIS-formaat, tenzij beide partijen een alternatief afspreken dat nog steeds aan de EN 16931-norm voldoet. Een pdf in de bijlage van een e-mail volstaat niet meer, papier evenmin. Er geldt een korte lijst uitzonderingen, vooral ondernemingen die uitsluitend btw-vrijgestelde handelingen verrichten. Dat is de eigen uitleg van de Belgische overheid over wie eronder valt, niet de lezing van een softwareleverancier.

Drie details bepalen wat dat voor een Nederlandse leverancier betekent, en de eerste twee gaan in vrijwel elk artikel hierover mis.

U valt er waarschijnlijk niet onder. Een onderneming die niet in België is gevestigd en er geen vaste inrichting heeft, valt buiten de verplichting, ook als zij een Belgisch btw-nummer heeft. Die uitzondering geldt voor het verzenden én het ontvangen.
Maar u moet het zelf melden. Omdat de toets op vaste inrichting ingewikkeld is, leggen de Belgische regels de plicht bij de buitenlandse leverancier om zijn medecontractanten te laten weten dat hij daar geen vaste inrichting heeft. Zegt u niets, dan leest de financiële administratie van uw klant dat als niet-naleving en niet als vrijstelling.
Registreren op Peppol is op zichzelf instemming. Voor transacties buiten de verplichte B2B-scope geldt aanwezigheid op het Peppol-netwerk als akkoord om elektronische facturen te ontvangen. Het is geen neutrale technische stap, dus neem hem bewust.

Wat eraan komt

Gaat Nederland dezelfde kant op?

Ja, maar langzaam, en juist dat gat is uw planningsruimte. Op dit moment bestaat er geen Nederlandse B2B-verplichting. Op 10 maart 2026 stuurde de staatssecretaris van Financiën de Tweede Kamer een onderzoek van EY, uitgevoerd in opdracht van de ministeries van Financiën, Economische Zaken en Binnenlandse Zaken samen. EY adviseert Peppol als verplichte uitwisselingsinfrastructuur, met binnenlandse B2B-e-facturatie vanaf ongeveer 1 januari 2030 en binnenlandse digitale rapportage twee jaar later, in 2032.

Let goed op het onderscheid, want de meeste samenvattingen laten het weg. Dat zijn de aanbevelingen van EY, geen kabinetsbeleid. De begeleidende Kamerbrief noemt Peppol niet en wijst de European Business Wallet aan als mogelijk alternatief. Waar het kabinet zich wél aan heeft verbonden, is een internetconsultatie over een conceptwetsvoorstel in het vierde kwartaal van 2026. Een definitief kabinetsstandpunt werd in de zomer van 2026 verwacht en was nog niet gepubliceerd toen wij deze pagina op 1 september 2026 controleerden.

Het praktische gevolg is geen haast maar vorm. Een koppeling die u in 2026 laat bouwen, draait in 2030 nog. Vraag nu of de factuurgegevens die uw systeem verlaten echt gestructureerd zijn volgens EN 16931 en Peppol BIS Billing 3.0, of dat het een pdf is met een database erachter. Het eerste is later een formaatwijziging, het tweede een herbouw.

Kosten

Wat de prijs bepaalt, en wat er in een echte offerte staat

Offertes voor dezelfde twee systemen verschillen een factor vijf, en dat komt vrijwel nooit door het uurtarief. Het komt door eerlijkheid over scope.

Drie dingen bewegen het bedrag het meest: hoeveel soorten records de grens over gaan, of het verkeer één of twee kanten op loopt, en of er aan beide kanten een testomgeving is waar u echt op kunt testen. Tweerichtingssynchronisatie kost meer dan het dubbele van één richting, want nu kunnen beide systemen het oneens zijn over de waarheid en moet iets dat beslechten.

Een offerte die het tekenen waard is, benoemt de recordsoorten, de richting, het foutpad en wie er gebeld wordt als het misgaat. Staat er alleen "koppeling tussen systeem A en B", dan is het gelukkige pad geoffreerd.

Limieten

De limieten waar uw koppeling echt tegenaan loopt

De meeste koppelingen stranden op een getal dat niemand heeft opgezocht. Neem het systeem waar een Nederlandse mkb'er het vaakst aan koppelt. De gepubliceerde API-limieten van Exact Online staan een app 60 aanroepen per administratie per minuut en 5.000 aanroepen per administratie per dag toe, met een hoger dagplafond bij premiumlicenties. Een nieuw access token mag hoogstens eens per tien minuten worden opgevraagd, en meer dan tien fouten per sleutel, per gebruiker, per administratie, per endpoint, per uur levert een blokkade van een uur op die oploopt als de fouten aanhouden.

Reken dat door en de ontwerpeisen volgen vanzelf. Draait u voluit op het minuutplafond, dan is het dagbudget na ongeveer 83 minuten op. Elk patroon dat records één voor één ophaalt, verbruikt het budget al bij een middelgroot klantenbestand. Daarom is het antwoord: gepagineerde batches en incrementeel synchroniseren op een gewijzigd-sinds-tijdstempel, niet elke nacht alles opnieuw. Het foutenplafond weegt zwaarder dan het lijkt: een herhaallus zonder wachttijd veroorzaakt de blokkade zelf, en dan ligt de koppeling stil door eigen toedoen.

Andere systemen publiceren andere getallen, en die getallen verschuiven. Het gaat niet om deze specifieke cijfers, het gaat erom dat ze het eerste zijn om op te zoeken en het laatste waar een voorstel over rept. Staat er niet in de offerte wat er bij de limiet gebeurt, dan heeft niemand gekeken.

Wanneer niet

Wanneer u er beter geen bouwt

Wij wijzen koppelwerk in drie situaties af, en die komen vaak genoeg voor om eerst te controleren.

De leverancier levert er al een. Een ondersteunde connector die 80% van uw geval dekt, verslaat maatwerk dat 100% dekt, want u onderhoudt hem niet als de API-versie wijzigt.
Het volume rechtvaardigt het niet. Onder ongeveer twintig records per dag is een geplande export met een mens er jarenlang goedkoper, en die faalt zichtbaar in plaats van stil.
Het proces beweegt nog. Een proces automatiseren dat volgend kwartaal verandert, koopt u een herbouw. Repareer eerst het proces, koppel het daarna.

Koopgidsen

Verder vergelijken

Procesautomatisering Software op maat of een pakket Maatwerk software Softwarebedrijf kiezen AI koppelen aan Exact en AFAS

FAQ

Veelgestelde vragen

Wat kost een API-koppeling in Nederland?

Voor één richting tussen twee systemen die allebei een gedocumenteerde REST-API en een testomgeving hebben, is het een klein project. Tweerichtingsverkeer, meerdere recordsoorten of een ongedocumenteerd legacy-endpoint maken er een volwaardige bouw van. Wij offreren vast tegen een afgebakende scope: audit €2.500, proof of concept €20.000, productie vanaf €50.000.

Hoe lang duurt het?

Het bouwen is meestal het kortste deel. De doorlooptijd wordt bepaald door toegang: inloggegevens, een testomgeving en een aanspreekpunt aan beide kanten kosten routinematig meer tijd dan de code. Vraag die op dag één, niet pas bij het testen.

En als een van de systemen geen API heeft?

Dan zijn er meestal drie routes: een ondersteunde bestandsuitwisseling, direct uit de database lezen, of robotisch invoeren via het scherm. De eerste is saai en betrouwbaar, de laatste is fragiel en breekt zodra het scherm verandert. Wij verkopen u liever de saaie.

Wie is daarna eigenaar van de koppeling?

U bezit de code hoe dan ook. De vraag die vooraf beslecht moet worden, is wie hem bewaakt. Een koppeling zonder monitoring en zonder eigenaar valt binnen een jaar terug naar handwerk, en niemand merkt het voordat een klant het merkt.

Moeten wij op Peppol als we aan België leveren?

Juridisch niet, zolang u er geen vaste inrichting hebt: niet in België gevestigde ondernemingen vallen buiten de verplichting, ook met een Belgisch btw-nummer, voor verzenden en voor ontvangen. Commercieel ligt het anders, want uw Belgische klanten draaien hun facturatie nu gestructureerd en uw pdf met de hand verwerken is hun probleem geworden. Bereikbaar zijn via Peppol is meestal de goedkoopste kant van dat gesprek. Daarnaast wordt van u verwacht dat u Belgische medecontractanten zelf laat weten dat u daar geen vaste inrichting hebt.

Verandert de nieuwe cyberwet hoe wij koppelingen bouwen?

Indirect, en vooral via uw klanten. De Cyberbeveiligingswet, de Nederlandse invoering van NIS2, trad op 15 augustus 2026 in werking en geldt voor ruwweg achtduizend organisaties in achttien aangewezen sectoren. De zorgplicht ligt bij die organisaties en niet bij u, maar een van de genoemde maatregelen is het beveiligen van de toeleveringsketen, inclusief de relatie met directe leveranciers. Het bereikt u dus contractueel en niet wettelijk. Levert u aan zo'n organisatie, dan komen hun beveiligingseisen bij u binnen als vragen over uw koppeling: waar staan de inloggegevens, wie kan bij het endpoint, wat wordt gelogd en hoe lang bewaart u dat. Die vragen zijn goedkoop te beantwoorden als de koppeling er rekening mee hield, en duur om achteraf in te bouwen.

API-koppeling: wat het kost en wat er stukgaat na livegang