Je binnendienst typt orders uit de webshop over in AFAS. De voorraad in je portaal loopt een dag achter op Business Central. Een API-koppeling lost dat op, en dan komt meteen de vraag: koop je een standaard connector of laat je er een bouwen?
Ons advies: leg de connector naast je proces en kijk wat hij mist. Een standaard connector dekt vaak 80% van een koppeling. De overige 20% is precies waar jouw proces afwijkt, en daar zit meestal ook je marge.
In het kort
- Een API-koppeling laat twee systemen automatisch gegevens uitwisselen, zoals orders van je webshop naar je ERP.
- Een standaard connector werkt zolang je proces de standaard volgt. Wijken je prijslogica, voorraad of orderstroom af, dan bouw je dat deel op maat.
- Een integratiesprint van 2 weken kost bij Solvy meestal €5.000 tot €10.000 en eindigt met een werkend proof of concept. Een volledig werkende koppeling staat er meestal na 2 tot 4 sprints.
Wat is een API-koppeling?
Een API-koppeling is een automatische verbinding tussen twee softwaresystemen via hun API: de ingang die een systeem openzet voor andere software. Loopt de koppeling tussen je ERP en een ander systeem, zoals je webshop, portaal of CRM, dan heet het een ERP-koppeling. Orders, prijzen, voorraad en facturen lopen dan vanzelf heen en weer.
Bij Huis73 verwerkt de koppeling met AFAS en betaalprovider Buckaroo bijvoorbeeld automatisch betaalstatussen en facturen. Niemand hoeft ze nog over te zetten.
Een koppeling is zelden één verbinding. Data moet vertaald en gecontroleerd worden volgens jouw bedrijfsregels voordat het andere systeem er iets mee kan. Dat werk bepaalt de doorlooptijd en het budget, veel meer dan het aansluiten van de API zelf.
Wanneer volstaat een standaard connector?
Als je proces de standaard volgt en beide pakketten veel gebruikt worden. Denk aan facturen die van je webshop naar je boekhouding gaan. Voor AFAS bestaan meer dan 75 gecertificeerde koppelingen [2], en Exact Online heeft een eigen App Store vol connectors. Past er één op je proces, dan koppelen we die gewoon mee.
Toets een connector wel voordat je tekent:
- Welke velden en objecten neemt hij mee, en welke laat hij liggen?
- Werkt hij in twee richtingen of alleen van A naar B?
- Wat gebeurt er met een order als een van beide systemen even plat ligt?
- Wie past hem aan als je proces verandert?
Elke vraag waarop het antwoord "nee" of "weet ik niet" is, wordt straks handwerk voor je binnendienst.
Waar schiet een standaard connector tekort?
Op de plek waar jouw bedrijfsregels beginnen. Een connector verplaatst data van het ene systeem naar het andere. Wat er onderweg met die data moet gebeuren, zoals een prijs per klant berekenen of voorraad over kanalen verdelen, staat in jouw proces. Dat deel, de 20%, bouw je op maat.
De signalen dat je daar zit:
- Je prijs komt uit een berekening met klantafspraken, staffels en uitzonderingen die de connector niet kan nadoen.
- Meerdere kanalen claimen dezelfde voorraad, bijvoorbeeld je portaal en je binnendienst.
- Op piekmomenten komt er meer binnen dan je ERP per minuut verwerkt.
- Iemand corrigeert elke dag orders die de koppeling half heeft doorgezet.
Natec Sunergy liep daar tegenaan. Het oude portaal liep tegen zijn grenzen aan, en een standaardpakket kon de voorraad per klant en Business Central op die schaal niet aan. We bouwden een portaal in Laravel met eigen bedrijfslogica. Op een piekdag verwerkt dat portaal de orders en verdeelt het de voorraad, zodat Business Central alleen schone data binnenkrijgt.
De bedrijfslogica doet meer. Op basis van wat de klant invult, kiest het portaal automatisch de vervoerder en berekent het de transportkosten en de recyclingbijdrage. Die gegevens staan direct op de order in Business Central. Dat scheelt de binnendienst minstens een half uur per order, en de fouten die bij handmatig verwerken ontstaan, vallen weg. Hoe die keuze voor maatwerk uitpakte, lees je in ons artikel B2B portaal: standaard, uitbreiden of maatwerk?
Soms is de beste oplossing een bewuste menselijke stap. Bij Duramotion komt elke portaalorder direct in Exact Online binnen. Een portaalorder en een verkoop via de binnendienst kunnen kort na elkaar dezelfde voorraad claimen. Daarom controleert de ordermanager de order voordat die verder gaat. Volgens de ordermanager kost een portaalorder een fractie van de tijd, met een foutmarge van nagenoeg nul.
Hangen er veel systemen aan elkaar, dan wordt een centrale laag logisch. Het platform dat we voor Amacom bouwden, koppelt via API's en EDI aan de webshop, de kassa en de marktplaatsen. Zo loopt de voorraad voor 20.000+ producten in elk kanaal gelijk.
| Route | Past als | Toets vooraf |
|---|---|---|
| Standaard connector | Je proces volgt de standaard van beide pakketten | Welke velden meegaan, één of twee richtingen, wat er bij een storing gebeurt, wie hem onderhoudt |
| Connector plus maatwerk | De connector dekt het meeste en de afwijking is af te bakenen | Waar het maatwerk draait en wie het bijwerkt bij een update |
| Maatwerk of een centrale integratielaag | Je bedrijfsregels zitten in de kern, of er hangen veel systemen aan elkaar | Architectuur, monitoring, documentatie en wie de code bezit |
Wat kost een API-koppeling laten maken?
Een vaste prijs per koppeling noemen we niet, want een koppeling is zelden één endpoint. Naast het aansluiten van de API's verwerk je data en bouw je bedrijfslogica in het systeem dat de data ontvangt. Een integratiesprint van 2 weken kost bij Solvy meestal €5.000 tot €10.000, afhankelijk van de omvang. Daarna heb je een werkend proof of concept en een onderbouwde schatting voor de rest.
Online zie je aanbiedingen vanaf een paar honderd euro. Die gaan meestal over één vaste datastroom tussen twee bekende pakketten. Voor een eenvoudige factuurkoppeling kan dat prima zijn. Voor een orderstroom met klantprijzen en voorraadregels vergelijk je dan appels met peren.
Wat de prijs bepaalt:
- Het aantal systemen en datastromen. Twee systemen is één koppeling. Komen er een PIM, WMS en CRM bij, dan bouw je een netwerk.
- De kwaliteit van de API en de documentatie. Een goed gedocumenteerde API scheelt dagen uitzoekwerk.
- De bedrijfslogica, zoals prijsberekeningen, voorraadverdeling en goedkeuringsstappen.
- De staat van je data. Dubbele klanten en vervuilde artikelcodes moet je eerst opschonen of mappen.
- Eén of twee richtingen, realtime of in batches. Een nachtelijke update is eenvoudiger dan een voorraad die op de seconde moet kloppen.
- Foutafhandeling en monitoring, zodat je merkt dat er iets misgaat voordat je klant het merkt.
Zet die kosten naast wat het handwerk je nu kost. Tel hoeveel orders je binnendienst per week overtypt of corrigeert, en hoeveel tijd daarin gaat zitten. Dat getal is je businesscase. Bij Natec Sunergy ging het om minstens een half uur per order.
Bij Multi Bier staan voorraad, prijzen en levertijden live uit de achterliggende systemen in het bestelportaal. Inmiddels komt meer dan 75% van de orders via dat portaal binnen, en verwerkt de binnendienst minder orders met de hand.
Hoe lang duurt het om een koppeling te laten bouwen?
Na één sprint van 2 weken staat er een werkend proof of concept, gebouwd rond het probleem dat we samen aan tafel hebben besproken. Een volledig werkende oplossing staat er meestal na 2 tot 4 sprints. Hoeveel het er worden, hangt af van het aantal systemen en hoe ingewikkeld je bedrijfsregels zijn.
Er past veel in één sprint. Onze developers houden de regie en werken met AI-ondersteuning. Daarna zetten we één datastroom tegelijk live: de orders lopen bijvoorbeeld al voordat de facturen meegaan. Zo heb je snel resultaat en stuur je onderweg bij.
Wat gebeurt er als een koppeling faalt?
Er raakt geen data kwijt. Elk bericht, zoals een order of een prijswijziging, gaat eerst in een wachtrij. Reageert het andere systeem niet, dan probeert de koppeling het automatisch opnieuw, met steeds iets meer tijd ertussen. Lukt het blijvend niet, dan komt het bericht in een aparte wachtrij voor mislukte berichten. Wij lossen de oorzaak op en sturen het bericht opnieuw af. Afhankelijk van het project gebruiken we daarvoor Laravel Queues, Symfony Messenger of RabbitMQ.
Dat gebeurt in de praktijk vaker dan je denkt. Business Central weigert bijvoorbeeld verzoeken boven de API-limiet met foutcode 429 [1], en ook een ERP gaat weleens even plat voor een update.
Elk bericht krijgt een vaste referentie. Sturen we het opnieuw, dan herkent het ontvangende systeem het en maakt het de order niet dubbel aan.
Elke koppeling die we bouwen heeft gelaagde monitoring: uptime, foutmeldingen, een periodieke controle door een van onze mensen en een AI-laag die helpt om problemen snel te signaleren. Een kritiek probleem lossen we binnen 1 werkdag op als de oorzaak bij ons ligt.
De API's die we openzetten, behandelen we als iets om te beschermen: versleutelde verbindingen en rechten per systeem en gebruiker. Solvy is sinds 2023 ISO 27001 gecertificeerd. Lees meer over hoe we met security omgaan.
Wat als AFAS, Exact of Microsoft de API aanpast?
Kleine wijzigingen in een API vangen we op binnen het onderhoudscontract. Bij een grote upgrade, met nieuwe endpoints of een ander datamodel, moet de datamapping opnieuw. Dat is meestal beperkt werk, omdat de bedrijfslogica al in je eigen applicatie zit.
Zit je prijslogica in een connector of een low-code flow, dan raakt een grote update ook die logica. Dat is een goede reden om je bedrijfsregels op één plek te houden die je zelf beheert.
Spreek ook af dat code en documentatie van jou zijn, zodat een ander team ermee verder kan. Meer over hoe we koppelingen bouwen lees je op onze pagina over systeemintegratie.
Bronnen
Van gesprek tot koppeling
Hoe begin je?
Vijf stappen, van het eerste gesprek tot een koppeling die we na livegang blijven bewaken.
Een uur aan tafel
Je praat een uur met onze CTO en lead developer, zonder kosten. We brengen je datastromen in kaart en leggen de connector naast je proces.
Advies en schatting
Je krijgt een eerlijk advies: welke delen een connector afdekt, wat maatwerk vraagt en wat dat kost.
Integratiesprint
In 2 weken een werkend proof of concept rond je lastigste datastroom. Meestal €5.000 tot €10.000.
Doorbouwen
Na 2 tot 4 sprints werkt de volledige koppeling. We zetten één datastroom tegelijk live.
Monitoring en onderhoud
We bewaken uptime en fouten, sturen mislukte berichten opnieuw af en vangen API-wijzigingen op binnen het onderhoudscontract.
Veelgestelde vragen over API-koppelingen
Wat kost een API-koppeling laten maken?
Een vaste prijs per koppeling noemen we niet, want een koppeling omvat naast de API ook dataverwerking en bedrijfslogica. Een integratiesprint van 2 weken kost bij Solvy meestal €5.000 tot €10.000 en levert een werkend proof of concept en een onderbouwde schatting op.
Hoe lang duurt het om een API-koppeling te laten bouwen?
Na één sprint van 2 weken staat er een werkend proof of concept. Een volledig werkende koppeling staat er meestal na 2 tot 4 sprints, afhankelijk van het aantal systemen en je bedrijfsregels.
Kan ik zelf een API-koppeling maken?
Voor eenvoudige stromen wel. Met tools als Make, Zapier of n8n verbind je standaardpakketten zonder te programmeren, en in Exact Online maak je zelf een API-koppeling aan onder Beheer > Koppelingen. Let op de foutafhandeling: wat gebeurt er met een order als de flow halverwege stopt? Hangt er omzet aan, dan wil je wachtrijen en monitoring, met een partij die ervoor verantwoordelijk is.
Wat is het verschil tussen een API-koppeling en EDI?
Via een API vraagt of stuurt een systeem rechtstreeks data op, vaak realtime. EDI is gestandaardiseerd berichtenverkeer waarmee bedrijven orders en facturen automatisch uitwisselen, vaak met grote retailers. Ze gaan prima samen: bij Amacom draaien API's en EDI naast elkaar.
Met welke ERP-systemen koppelt Solvy?
Onder meer Microsoft Dynamics NAV en Business Central, SAP Business One, AFAS Profit, Exact Online en Thinkwise, plus CRM-, PIM- en WMS-systemen. Waar een bestaande connector past, gebruiken we die.
Wat gebeurt er als AFAS, Exact of Microsoft de API aanpast?
Kleine wijzigingen vangen we op binnen het onderhoudscontract. Bij een grote upgrade met nieuwe endpoints of een ander datamodel moet de datamapping opnieuw. Dat is meestal beperkt werk, omdat de bedrijfslogica al in je eigen applicatie zit.