Een API-koppeling laten maken

"Kan iemand dit even koppelen?" is meestal het moment waarop iemand na een jaar doorheeft dat een deel van het werk elke week hetzelfde is. Bestellingen overtypen, voorraad bijwerken in twee systemen, een export uit het ene pakket die in het andere geïmporteerd moet worden. Dit stuk gaat over de vraag daarna: laat je dat bouwen, wat kost dat, en waar let je op.

Wanneer maatwerk wél de goedkoopste route is

Standaardsoftware is bijna altijd het verstandige antwoord. Ze is goedkoper, sneller in gebruik en iemand anders onderhoudt haar. Wij raden het geregeld aan en verdienen er niets aan.

Maatwerk wordt pas de goedkoopste route in drie situaties.

Je proces wijkt af op precies het punt dat geld kost. Standaardsoftware dekt het gemiddelde geval. Zit jouw marge in iets specifieks, zoals een eigen inkoopprijsstructuur, staffelkortingen per klant of een assortiment met varianten die het pakket niet kent, dan valt dat buiten de tachtig procent die de tool dekt. Die overige twintig procent blijft handwerk, en handwerk schaalt niet.

Je betaalt voor drie tools die elkaar half overlappen. Dat patroon zien we vaak: een tool voor de marketplacekoppeling, een tool voor de voorraad, een tool voor de rapportage, en daartussen een spreadsheet die iemand elke maandag bijwerkt. Bij elkaar honderden euro's per maand plus de uren van die maandag.

Er is geen kant-en-klare koppeling. Een ERP dat niemand ondersteunt, een leverancier die alleen een csv op een ftp-server zet, een groothandel met een eigen bedachte API. Dan is er geen tool om te kopen.

Herken je niets van deze drie, dan is de eerlijke conclusie dat je een abonnement moet nemen en niet iemand moet laten bouwen.

Wat de prijs bepaalt

Het contra-intuïtieve deel: hoe ingewikkeld jouw bedrijfsproces is, maakt voor de prijs verrassend weinig uit. Bedrijfsregels zijn te schrijven zodra ze helder zijn, en het uitzoeken ervan doe je toch al.

Wat de prijs wél bepaalt:

De kwaliteit van de API aan de andere kant. Een goed gedocumenteerde API met een testomgeving, zoals bij bol, Shopify en Exact, is voorspelbaar werk. Een systeem met verouderde documentatie, of zonder testomgeving, betekent dat elke aanname in productie getest moet worden. Dat verdubbelt de tijd zonder dat er iets ingewikkelders gebeurt.

Of het één kant op gaat of twee. Data ophalen en ergens neerzetten is overzichtelijk. Twee systemen die allebei mogen wijzigen is een ander probleem: dan moet je bepalen wie wint als ze het oneens zijn, en wat er gebeurt als er één even offline was. Dat is niet moeilijker om te bouwen, maar wel veel meer om over na te denken en te testen.

Hoeveel het mag kosten als het misgaat. Een koppeling die een rapportage bijwerkt mag een uur stilstaan. Een koppeling die voorraad bijwerkt mag dat niet: daar hangt een order aan die je niet kunt leveren. Hoe duurder een fout, hoe meer er aan controles, herhaalpogingen en meldingen gebouwd wordt, en dat deel is een fors stuk van het werk.

Vergelijk je offertes, kijk dan niet naar het bedrag maar naar wat er in zit. Ligt de een ver onder de ander, vraag dan wat er níet in zit. Meestal is dat de foutafhandeling, en dat is precies het deel dat je later mist.

Hoe zo'n traject bij ons loopt

Vier fases, en de eerste is de belangrijkste.

Fase één: in kaart brengen. We lopen het proces door zoals het nu gaat, en rekenen uit wat het per maand kost aan uren en aan tools. Daar komt uit welke stappen zich lenen voor automatisering en wat dat oplevert. Je krijgt in deze fase al een dashboard met je KPI's, binnen enkele werkdagen. Levert de rekensom niets op, dan houdt het hier op en heb je een helder antwoord.

Fase twee: bouwen, wekelijks. Elke week één proces opgeleverd, niet één grote oplevering over drie maanden die het net niet doet. Per opgeleverd proces kost het je team ongeveer een half uur om het samen door te lopen.

Fase drie: bewaken. Elke koppeling krijgt een controle die aanslaat als er niets meer doorkomt. Dit is het onderdeel dat het vaakst wordt overgeslagen en het duurst is om te missen.

Fase vier: overdragen. Documentatie, een onderhoudsplan, en de code op jouw naam. Dat is geen bijzaak: het is de reden dat je later zelf kunt kiezen.

Vijf vragen om te stellen voordat je tekent

Ongeacht bij wie je het laat bouwen.

1. Van wie is de code straks? Vraag om de repository op jouw naam. Krijg je een ontwijkend antwoord, dan is dat het antwoord.
2. Wat gebeurt er als de koppeling stilvalt? Wie krijgt een melding, hoe snel, en waar staat dat vastgelegd? "Dan bellen we even" is geen antwoord.
3. Waar draait het? Een script op de laptop van de bouwer is geen oplevering. Het hoort op een omgeving te draaien die van jou is en die iemand anders kan overnemen.
4. Hoe gaan we om met versiewijzigingen aan de andere kant? Platformen veranderen. Zit dat in het onderhoud of komt daar een factuur voor?
5. Wat kost het onderhoud per jaar, en wat zit daarin? Vraag door tot je weet of het meekijken bij versiewijzigingen erin zit. Nul euro onderhoud is geen koopje maar een waarschuwing: het betekent meestal dat niemand kijkt of het nog werkt.

Wat wij typisch koppelen

Wat wij doen, in één zin: maatwerkkoppelingen tussen webshop, marketplaces, ERP en WMS, gebouwd in Python op de officiële API's, en overgedragen met documentatie en de code op jouw naam.

Geschikt voor: bedrijven waarvan het proces afwijkt van het gemiddelde, die voor drie tools betalen die elkaar half overlappen, of die een systeem draaien waarvoor geen kant-en-klare koppeling bestaat.

Voor e-commercebedrijven komt het meestal op deze combinaties neer: een webshop (Shopify of WooCommerce) aan één of meer marketplaces via de bol Retailer API, de Amazon SP-API of de Kaufland-API; die kanalen aan een ERP of WMS; en daaroverheen een laag die de marge per kanaal berekent met de echte fees erin in plaats van een geschat percentage.

Weet je nog niet of het bij jou iets oplevert, doe dan eerst de scan hieronder. Die rekent op basis van je eigen antwoorden uit hoeveel uren en euro's er per maand weglekken. Dat is een concreter startpunt dan een offerte.

Veelgestelde vragen

Wat kost een API-koppeling?

Daar staat op deze site bewust geen bedrag bij, omdat het volledig afhangt van het aantal koppelingen en van de kwaliteit van de systemen aan de andere kant. Wat wij wel doen: in de eerste fase zetten we de prijs op papier voordat er iets gebouwd wordt, naast wat je nu per maand kwijt bent aan het handwerk dat de koppeling vervangt. Zo vergelijk je twee getallen in plaats van een offerte met een gevoel. Komt de terugverdientijd niet binnen een jaar uit, dan zeggen we dat in het gesprek.

Hoe lang duurt het voordat ik iets zie?

Het dashboard met je KPI's krijg je in de eerste fase, dus binnen enkele werkdagen. Daarna leveren we elke week één proces op, zodat je nooit maanden op één grote oplevering zit te wachten. Wat de doorlooptijd in de praktijk bepaalt is zelden het bouwen maar het regelen van toegang: wachten op API-gegevens van een leverancier kost geregeld meer tijd dan het werk zelf.

Word ik afhankelijk van de partij die het bouwt?

Dat hoeft niet, en je moet het vooraf afspreken. Vraag om de broncode in jouw eigen repository, documentatie in gewone taal, en dat het draait op een omgeving die op jouw naam staat. Wij dragen elk systeem zo over. Blijf je daarna klant, dan is dat omdat je dat wilt en niet omdat je vastzit.

Is maatwerk niet duurder dan een kant-en-klare tool?

Op de aanschaf wel, op de rekening over drie jaar meestal niet. Een tool kost elke maand geld en dekt je proces gedeeltelijk; het restant blijft handwerk. Maatwerk kost één keer geld en daarna alleen onderhoud. De vraag is niet welke goedkoper is, maar of jouw proces afwijkt van het gemiddelde. Wijkt het niet af, neem dan de tool. Dat zeggen wij ook gewoon.

Wanneer is maatwerk software goedkoper dan een SaaS-abonnement?

Op de aanschaf nooit, op de rekening over drie jaar vaak wel. Een abonnement kost elke maand geld en groeit meestal mee met je omzet; maatwerk kost één keer geld en daarna alleen hosting en onderhoud. Het omslagpunt hangt niet af van je omzet maar van hoeveel handwerk er ná je pakket overblijft. Blijft dat onder twee uur per week, houd dan het abonnement. Loopt het naar een dag per week, dan verdient maatwerk zich binnen enkele maanden terug.

Hoe kies ik een partij die een marketplace-integratie voor me bouwt?

Stel vijf vragen en let vooral op het ontwijkende antwoord. Van wie is de code straks, en staat de repository op jouw naam? Wat gebeurt er als de koppeling stilvalt, wie krijgt dan een melding en hoe snel? Waar draait het, en kan iemand anders dat overnemen? Zit meekijken bij versiewijzigingen in het onderhoud? En wat kost dat onderhoud per jaar? Nul euro onderhoud is geen koopje maar een waarschuwing: het betekent dat niemand kijkt of het nog werkt.

Wat als de API van de leverancier verandert?

Dat gebeurt, en het is de belangrijkste reden om onderhoud vooraf af te spreken in plaats van een koppeling als afgerond project te beschouwen. Platformen als bol versiebeheren tegenwoordig per resource, dus er verandert vaker iets en kleiner tegelijk. Een koppeling met bewaking merkt zo'n wijziging binnen een uur; een koppeling zonder bewaking merkt het als een klant belt.