Geen API in je pakket? Zo koppel je KING ERP en andere gesloten software toch

"Niet van buitenaf te benaderen, dus geen koppeling mogelijk." Zo staat het, bijna woordelijk, in de kennisbank van meer dan één koppelpartij over KING ERP. Dat klopt ook, alleen niet zoals je het leest. Het gaat over hún route naar jouw pakket, niet over jouw pakket.

Op de server die bij jou in de meterkast of bij je hoster staat, liggen namelijk bijna altijd drie of vier deuren open. Ze zitten alleen niet aan de kant waar een koppelplatform aanklopt. Deze gids is voor de ondernemer, controller of IT-verantwoordelijke met software die "geen API heeft": een on-premise ERP, een branchepakket, een oud voorraadsysteem, een gehoste desktopapplicatie waar het hele bedrijf op draait. Na deze gids weet je welke van de vier routes bij jouw situatie past, wat die ongeveer kost, waar hij breekt, en welke afspraak je met je leverancier maakt vóórdat je iets bouwt.

Wat "niet van buitenaf te benaderen" eigenlijk betekent

Een gesloten pakket is software zonder een door de leverancier ondersteunde ingang die je vanaf het internet kunt aanroepen: geen publieke REST-API, geen webhooks, geen marktplaats met kant-en-klare apps. Dat is een uitspraak over de buitenkant van het gebouw. Het zegt niets over wat er binnen je eigen netwerk kan, en daar gaat deze gids over.

KING ERP is het scherpste voorbeeld, omdat beide beweringen tegelijk waar zijn. Een koppelplatform als Inserve schrijft in zijn documentatie dat KING ERP en KING ERP Online niet te benaderen zijn van buitenaf en dat er daardoor geen koppeling mogelijk is (kennisbankartikel zonder datum, geraadpleegd augustus 2026); dat platform werkt met KING Finance en KING Accountancy, de producten die wél in de cloud draaien. Ondertussen levert de leverancier zelf, sinds 2024 handelend onder de naam Bjorn Lunden, een component genaamd King Webservices. Dat draait in IIS op jouw eigen server, praat JSON over gewone HTTP POST-verzoeken, en vereist King 5.54 client/server of hoger, .NET Framework 4.5.2 en IIS 7.0. De deur bestaat dus. Hij zit alleen aan de binnenkant, en jij moet hem zelf openzetten.

Dat openzetten is letterlijk: de webservices staan standaard uit tot je in King 5 per webservice een toegangscode vastlegt, die je daarna als ACCESS-TOKEN-header meestuurt. De handleiding telt 121 pagina’s met webservices voor debiteuren, crediteuren, journaalposten, verkooporders, inkoopfacturen, artikelen, abonnementen, projecten en productieorders.

Let op wat die lijst wél en niet is: het zijn vrijwel allemaal toevoeg- en wijzigdiensten. Schrijven dus. Lezen doe je bij King via een ODBC-verbinding op de administratiedatabase, en daarvoor heb je de module DataDigger nodig; die verbinding werkt alleen bij een client-server-installatie, niet bij de standalone versie. Precies die tweedeling zie je terug bij partijen die het in productie draaien: Zenvoices zet twee componenten op de King-databaseserver van de klant neer en schrijft via King Webservices terwijl het via ODBC leest, met een vast WAN-IP of een stabiele hostnaam en één doorgezette poort (handleiding juni 2026).

Onthoud die tweedeling, want hij bepaalt je hele ontwerp en geldt ver buiten King: schrijven doe je door een ondersteunde voordeur, lezen mag door een zijdeur. Zo ziet een pakket eruit dat het netjes doet: AFAS levert GetConnectors om data op te halen en UpdateConnectors om te muteren, met JSON, XML of CSV als uitvoer en een token per AppConnector waarin je vastlegt welke connectoren die token mag gebruiken. Heeft jouw pakket zoiets, dan is deze gids niet voor jou en kies je gewoon tussen een kant-en-klare app, een integratieplatform of een eigen koppeling op de API.

Wat je op tafel legt voordat je kiest

De route kiezen kost een middag. Of die middag iets waard is, hangt af van zeven dingen die je van tevoren scherp hebt. De helft ervan gaat niet over techniek.

• Je stromen, per richting benoemd. Niet "webshop aan ERP", maar "orders van webshop naar ERP" en "voorraad van ERP naar webshop". Elke richting is een eigen besluit met een eigen route.
• Je versie én je installatievorm. Client-server of standalone, lokaal of bij een hoster. Dit is geen detail: bij King valt de hele ODBC-route weg zodra je standalone draait.
• De modules in je licentie. Vrijwel elk gesloten pakket verkoopt de koppelbaarheid apart: een datamodule, een taakplanner, een webservice-component. Zoek in je licentieoverzicht voordat je iets koopt, want soms heb je het al.
• Een stabiele sleutel per record. Ordernummer, debiteurnummer, artikelcode. Een naam of e-mailadres is geen sleutel.
• Een wijzigingsmarkering. Een veld waarop je kunt filteren om alleen op te halen wat sinds de vorige ronde veranderde. Ontbreekt dat, dan zit je vast aan volledige exports en wordt frequentie een kostenpost.
• Een testadministratie met 20 tot 50 echte records. Op je productieadministratie oefenen is geen optie bij een pakket dat je niet in één klik kunt terugdraaien.
• Een naam achter het beheer. Wie kijkt over een jaar naar de foutmeldingen, en binnen hoeveel uur. Zonder die naam koop je een bouwproject, geen koppeling.

De vier routes, en wat ze kosten

De volgorde hieronder is geen smaakkwestie. Route 1 en 2 gebruiken wat je pakket zelf al kan, route 3 lost het transport op, en route 4 doet alsof er een mens achter het scherm zit. Hoe verder je in die lijst zakt, hoe meer je bouwt op iets dat de leverancier nooit als koppelvlak bedoeld heeft.

Route 1: geplande export-import

Je pakket levert bestanden en leest bestanden, aangestuurd door een taakplanner. Bij King is dat King Task Centre, dat geplande taken draait met XML-orderimport, exports, Crystal Reports en e-mail, en dat in licenties van twee of tien taken wordt verkocht, telkens met twee of tien uit te breiden. Heeft jouw pakket geen eigen planner, dan doet de Windows Taakplanner het gratis, of je laat een integratieplatform de klok slaan: n8n Cloud begint bij 20 euro per maand bij jaarbetaling voor 2.500 uitvoeringen en de zelf gehoste community-editie kost niets (prijzen augustus 2026).

Wat het kost. De modulelicentie plus twee tot vijf dagen inrichten van de veldkoppeling. Vraag de moduleprijs op, want die publiceert vrijwel geen enkele leverancier van dit type pakket.

Waar hij breekt. Bij een update die het exportformaat verandert, bij een run die stilletjes faalt, en bij een bestand dat half geschreven is als de andere kant het al oppakt.

De afspraak vooraf. Laat vastleggen welk exportformaat ondersteund is en of formaatwijzigingen bij een versie-upgrade worden aangekondigd. Bij King staat er zwart op wit dat het controleren en aanpassen van je taken bij een update niet in de prijs van de optie zit. Reken daar dus op.

Route 2: een leesbare database- of rapportagelaag

Je legt een alleen-lezen verbinding op de database van het pakket, of je kopieert die elke nacht naar een eigen rapportagedatabase. Bij King activeer je dat per administratie via Algemeen, Administratie, Administratie wijzigen, waar je onder Externe gebruiker een account aanmaakt en de knop "Activeren ODBC-koppeling voor deze machine" indrukt.

Dit is de snelste route naar antwoorden en de verraderlijkste om op te bouwen. Je leunt op een schema dat niet van jou is: de leverancier mag het bij elke release wijzigen, en jij hoort dat pas als je rapport leeg blijft. De integratiepatronen van Hohpe en Woolf noemen het delen van één database als integratiestijl al decennia riskant, omdat een schema bedenken dat meerdere applicaties tegelijk bedient een bijzonder lastige oefening is. Bij een pakket van derden heb je in die oefening niet eens een stem.

Wat het kost. De datamodule plus één tot drie dagen om de tabellen te ontrafelen. De rapportagedatabase zelf mag een kleine self-hosted Postgres zijn.

Waar hij breekt. Bij elke update. En bij de verleiding om ook te gaan schrijven.

De afspraak vooraf. Een account met alleen leesrechten, schriftelijke toestemming, en de vraag of je bij een schemawijziging bericht krijgt. Schrijf nooit rechtstreeks in de tabellen van je leverancier: je omzeilt dan alle validatie, nummerreeksen en boekhoudkundige consistentie die het pakket zelf bewaakt, en je bent je support kwijt op het moment dat je hem het hardst nodig hebt.

Route 3: bestandsuitwisseling via een gedeelde map of SFTP

Dezelfde bestanden als in route 1, maar nu staat de tegenpartij buiten je netwerk: een webshop bij een hoster, een leverancier, een logistiek dienstverlener. Je hebt een postbus nodig. Dat kan een SFTP-map bij je eigen hoster zijn, een kleine server met één SFTP-gebruiker, of opslag bij een cloudleverancier. Microsoft schrijft over die laatste variant dat het aanzetten van SFTP een uurtarief kost en adviseert het alleen aan te zetten terwijl je daadwerkelijk data overzet, boven op de gewone opslag- en verkeerskosten (Microsoft-documentatie, bijgewerkt juni 2026).

Vier conventies bepalen of deze route jaren meegaat. Schrijf naar een tijdelijke naam en hernoem hem pas als het bestand compleet is, zodat de ander nooit een half bestand oppakt. Geef elk bestand een uniek volgnummer met tijdstempel. Verplaats verwerkte bestanden naar een archiefmap en mislukte naar een foutmap. En houd per bestand bij dat het verwerkt is, zodat een tweede aanbieding niets dubbel doet.

Reken op vertaalwerk, want dat is de kern van deze stijl: het is zeldzaam dat de uitvoer van de ene applicatie precies is wat de andere nodig heeft, dus er zit altijd een omzetstap tussen.

Wat het kost. Van niets, als je hoster al SFTP levert, tot een paar euro per maand voor een kleine server, plus de omzetstap.

Waar hij breekt. Op een bestand dat op slot staat, een volle schijf, een gewijzigde tekencodering en een decimaalteken dat ineens een komma is.

De afspraak vooraf. Wie is eigenaar van de map, hoe lang blijven bestanden staan, en wie krijgt het alarm als er een dag niets binnenkomt.

Route 4: de schermrobot, als alle deuren dicht zitten

Blijft er echt niets over, dan laat je software het scherm bedienen: klikken en typen zoals een mens. Dat werkt bij elk pakket, want elk pakket heeft een scherm. Het is ook het fragielste dat je kunt bouwen, want elk knopje dat verschuift is een storing, en de robot draait met iemands inloggegevens.

Behandel dit als laatste redmiddel, niet als eerste besparing. Hoe je zo’n scherm- of browsertaak zonder code opzet, met een goedkeuringspoort en een noodstop, staat apart uitgewerkt: het is een eigen vak met een eigen risicoprofiel. Voor deze gids telt vooral wanneer je eraan begint, en dat antwoord is: pas als route 1, 2 en 3 alle drie aantoonbaar dicht zitten.

De vier routes naast elkaar

Prijzen en versies augustus 2026. De modulelicenties staan er bewust als "vraag op": leveranciers van dit type pakket publiceren die tarieven niet, en dat is op zichzelf informatie over hoe de onderhandeling gaat lopen.

Het beslis-kader: vijf vragen die de route kiezen

Loop ze in deze volgorde af. De eerste vraag kan de andere vier in één klap overbodig maken.

• Bestaat er al een kant-en-klare connector voor precies jouw combinatie? Voordat je een route bouwt: kijk of iemand hem al verkoopt. Precies de partijen die je in stap 1 als gratis intel-bron gebruikt, verkopen namelijk ook eindproducten. Zenvoices levert een kant-en-klare koppeling op King-lokaal voor factuurverwerking, Speedbooks doet dat voor rapportage via ODBC, Infine voor de directe koppeling vanuit zijn eigen pakket, en King heeft er een eigen app store voor, met kant-en-klare koppelingen van derden voor webshops, orderverwerking, urenregistratie en veldwerk. Kopen wint als het om één standaardstroom gaat (facturen erin, orders erin, uren eruit), de tegenpartij een gangbare partij is waar de aanbieder al klanten op draait, en het abonnement onder je bouwkosten blijft: Zenvoices begint bij 29 euro per maand voor het Basis-abonnement, plus gebruik naar rato van gebruikers, administraties en verwerkte facturen (prijzen augustus 2026). Zet daar twee tot vijf dagen bouwen naast en de som is snel gemaakt. Maatwerk wint als je velden afwijken van wat de connector aanbiedt, als je meerdere stromen hebt die op elkaar moeten wachten (order in, voorraad uit, factuur terug), of als er simpelweg geen aanbieder is voor jouw combinatie van pakketversie, installatievorm en tegenpartij. Controleer bij een kant-en-klare connector altijd eerst of hij jouw versie én installatievorm ondersteunt: bij King valt de helft van de aanbieders af zodra je standalone draait.
• Lezen of schrijven? Lezen kan langs elke route, schrijven maar langs één: een ingang die de leverancier ondersteunt. Is die er niet, dan is schrijven een ander project dan lezen, en meestal een duurder.
• Staat de tegenpartij binnen of buiten je netwerk? Binnen, dan is route 1 of 2 genoeg. Buiten, dan komt route 3 er sowieso bij, ook als route 1 het echte werk doet.
• Hoe vers moet het zijn? Moet het binnen seconden, dan heb je bij een gesloten pakket geen route en verschuift de vraag naar het andere systeem. Minuten tot uren is realistisch. Eén keer per nacht is voor artikelen, prijzen en klantgegevens vrijwel altijd genoeg. Welk ritme bij welke stroom hoort, hangt af van het patroon dat je kiest: event-driven voor orders en betalingen, delta-batch voor stamgegevens.
• Wie beheert dit over een jaar, en wat kost een dag stilte? Dit bepaalt of je überhaupt mag bouwen. Een koppeling zonder eigenaar is uitgesteld handwerk.

De drempels die ik hanteer. Onder de vijf handelingen per dag is overtypen goedkoper dan elke route hierboven. Tussen de vijf en vijftig verdient route 1 of 3 zich binnen een jaar terug. Boven de vijftig wordt de vraag niet óf je koppelt, maar hoe snel je een fout merkt. En mogen twee systemen allebei hetzelfde veld wijzigen, dan koppel je nog even niet: eerst per veld een eigenaar aanwijzen.

In zes stappen van gesloten pakket naar werkende koppeling

Na deze zes stappen draait er één werkende koppeling op een gesloten pakket: door een ingang die je leverancier schriftelijk toestaat, getest op een testadministratie, herhaalbaar zonder dubbele records, en bewaakt met een hartslag die alarm slaat zodra een ronde uitblijft. Reken op twee tot vier weken doorlooptijd.

De zes stappen, in deze volgorde:

1. Zoek de deuren die je nog niet kende

Open je pakket en noteer letterlijk wat er in de menu’s staat onder import, export, taken, webservices en externe gebruikers. Zoek daarna de kennisbank van drie partijen die jouw pakket wél koppelen en lees hun installatiehandleiding: die vertelt gratis welke ingang zij gebruiken. Noteer er meteen bij of een van die partijen jouw stroom ook als eindproduct verkoopt, want dat is de eerste vraag van het beslis-kader. Bij King leidt dat binnen een half uur tot de vondst dat schrijven via webservices gaat en lezen via ODBC. Je eindigt met een lijstje van twee tot vier kandidaat-ingangen.

2. Leg vier vragen bij je leverancier neer, met antwoord op schrift

Doe dit vóór je bouwt, niet erna. Vier vragen volstaan: mag ik deze ingang gebruiken en onder welke voorwaarden, wat doet dit met mijn support, krijg ik bericht bij een wijziging van exportformaat of databaseschema, en wat krijg ik aan eigen data mee als ik vertrek. Noem de ingang daarbij bij naam en vraag de moduleprijs erbij. De sectie over de leveranciersafspraak hieronder werkt die vier vragen woord voor woord uit, inclusief de formulering die je antwoorden bruikbaar maakt.

3. Kies één stroom, één richting, één ritme

Niet "de webshop koppelen", maar "verkooporders van webshop naar ERP, elke tien minuten". Schrijf de veldkoppeling uit in een tabel: bronveld, doelveld, wat er gebeurt bij een lege waarde, wat er gebeurt bij een onbekende klant. Dit is het document waar je over een jaar op terugvalt.

4. Bouw op een testadministratie en loop de keten één keer helemaal door

Twintig tot vijftig records, en dan met de hand controleren wat er aan de andere kant staat. Test expliciet de lelijke gevallen: een order met een korting, een klant die nog niet bestaat, een artikel dat is vervallen, een bedrag met een decimaal. King Webservices verlangt bijvoorbeeld een punt als decimaalteken en waarschuwt dat een numerieke waarde met een voorloopnul als octaal getal wordt gelezen, waardoor 010 als 8 aankomt. Zulke details vind je alleen door het te doen.

5. Maak hem herhaalbaar voordat hij live gaat

Elke ronde moet twee keer kunnen draaien zonder schade: bewaar per verwerkt record de unieke sleutel en sla over wat je al hebt gezien. Zet een archiefmap en een foutmap neer. Log per ronde hoeveel records erin gingen en hoeveel eruit kwamen, want dat getal is straks je enige bewijs.

6. Zet bewaking erop en gá pas dan live

Een koppeling op een gesloten pakket geeft geen foutmelding, hij geeft een leegte. Spreek af dat elke geslaagde ronde een hartslag afgeeft en dat het uitblijven daarvan alarm slaat, want detectietijd is de enige factor in de schadesom die je zelf in de hand hebt. Tel daarnaast elke nacht beide kanten: het aantal orders in de webshop tegenover het aantal orders in het pakket.

De afspraak die je vóór het bouwen met je leverancier maakt

Dit is het deel dat mensen overslaan, en het is het goedkoopste deel van het hele traject. Vier vragen, per e-mail, met een antwoord op schrift.

• Mag ik deze ingang gebruiken, en onder welke voorwaarden? Noem de ingang bij naam: de webservice, de datamodule, de exportfunctie. Vraag om een account met alleen leesrechten waar dat kan.
• Wat doet dit met mijn support? Bijna elke leverancier trekt de grens bij schrijven in de database. Laat zwart op wit zetten waar die grens ligt, zodat je bij een incident niet in een discussie belandt over wie wat kapot maakte.
• Krijg ik bericht bij een wijziging? Vraag om aankondiging van wijzigingen in exportformaten en databaseschema bij een versie-upgrade, met een termijn erbij. Krijg je die niet, dan hoort er een testronde na elke update in je onderhoudsbegroting.
• Wat krijg ik mee als ik vertrek? Een volledige export van je eigen gegevens in een leesbaar formaat, binnen een afgesproken termijn. Dit is de clausule die je afhankelijkheid van één leverancier meetbaar en afbouwbaar maakt.

Reken er niet op dat de wet dit gesprek voor je wint. De Auteurswet staat decompilatie toe om interoperabiliteit te bereiken, maar onder strenge voorwaarden. Het moet onmisbaar zijn, de informatie mag niet al snel en eenvoudig langs een andere weg beschikbaar zijn, het blijft beperkt tot de noodzakelijke delen, en alleen de rechtmatige verkrijger mag het doen. Er rust op de leverancier geen verplichting om mee te werken aan het tot stand brengen van een interface, zo tekende advocaat Natascha van Duuren op. Je sterkste hefboom is dus je contract en je opzegmoment, niet artikel 45m.

Valkuilen

• Schrijven in de tabellen omdat het lukt. Het lukt bijna altijd, en het gaat bijna altijd mis: je slaat validatie, nummerreeksen en boekhoudkundige samenhang over. Schrijf uitsluitend via een importfunctie of een webservice.
• De export die stilletjes stopt. Geen foutmelding, alleen een map die leeg blijft. Bewaak de afwezigheid van succes, niet de aanwezigheid van fouten.
• Het half geschreven bestand. De lezende kant pakt een bestand op dat nog aan het groeien is en verwerkt de helft ervan. Schrijf naar een tijdelijke naam en hernoem pas als je klaar bent.
• De update die je koppeling breekt. Bij een gesloten pakket is een versie-upgrade een koppelrisico, geen IT-formaliteit. Plan de testronde in, en begroot hem: bij King is het aanpassen van je geplande taken na een update expliciet niet in de prijs van de module inbegrepen.
• Twee systemen die hetzelfde veld schrijven. Dan verspreidt je koppeling netjes de verkeerde waarde. Wijs eerst per veld één bron van waarheid aan.
• De koppeling die één persoon begreep. Bij een zelfgebouwde route op een gesloten pakket is dat risico groter dan normaal, want de kennis zit in ondoorzochte tabelnamen en ongedocumenteerde exportformaten. Dat koppelingen doordraaien terwijl niemand meer weet hoe ze in elkaar zitten is precies hoe die schuld zich opbouwt.
• Onderhoud dat niemand begroot. Een route op een gesloten pakket kost jaarlijks aandacht: de update-test, de veranderde veldnaam, het verlopen certificaat. Zet er een regel voor in de begroting en leg die naast de vier soorten verborgen kosten die handmatig overtypen je nu al kost: dat is de enige eerlijke vergelijking.

Uitgewerkt voorbeeld: een groothandel op KING ERP 5

Neem een groothandel met twaalf medewerkers. KING ERP 5.70a draait client-server op een eigen server op kantoor, de webshop staat bij een hoster. Elke dag komen er ongeveer zestig orders binnen die iemand met de hand overtikt in King, en diezelfde persoon leest twee keer per week de voorraadstanden terug om de webshop bij te werken. Reken drie minuten per order en je zit op drie uur per dag, de fouten nog niet meegerekend.

De inventarisatie (stap 1). In het licentieoverzicht staat King Task Centre met twee taken. DataDigger staat er niet in. In de menu’s zit een XML-orderimport. Op de site van de leverancier staat de installatiehandleiding van King Webservices. Drie kandidaat-ingangen dus, waarvan er twee al betaald zijn.

De vier vragen (stap 2). De leverancier bevestigt dat de webservices ondersteund zijn, geeft de prijs van DataDigger, en zet erbij dat het aanpassen van Task Centre-taken na een update apart wordt gefactureerd. Dat laatste is precies de informatie die je nodig had.

De keuze (het beslis-kader). Eerst de koopvraag: er zijn kant-en-klare King-koppelingen te koop, maar die gaan over factuurverwerking en rapportage, niet over deze webshop. Voor deze combinatie verkoopt niemand een product, dus bouwen het is. Orders schrijven gaat via route 1, met de ondersteunde webservice voor het toevoegen van een order: één ingang, gevalideerd door King zelf. Voorraad en prijzen lezen zou route 2 worden, maar zonder DataDigger valt die af, dus wordt het een geplande export uit Task Centre naar een CSV. Omdat de webshop bij een hoster staat, komt route 3 erbij: de export landt in een SFTP-map die de webshop elk uur leegtrekt. Route 4 komt niet in beeld, want er zijn twee werkende deuren.

Wat er dan staat. De webshop stuurt elke nieuwe order naar een klein component op de eigen server, dat hem als JSON aan King Webservices aanbiedt met de toegangscode in de header. King antwoordt met een status en het gegenereerde ordernummer, dat de webshop bij de order bewaart, zodat een tweede aanbieding van dezelfde order niets dubbel doet. De andere kant op schrijft Task Centre elk uur een voorraadbestand naar een tijdelijke naam en hernoemt het zodra het compleet is.

De uitkomst. Drie uur overtikwerk wordt een controle van een kwartier op de foutmap. Van de vier routes zijn er twee gebruikt, en de duurste module hoefde niet gekocht te worden. Dat is de normale uitkomst van deze oefening: geen heldhaftige koppeling, maar twee saaie die elkaar aanvullen.

Tot slot

"Er is geen koppeling mogelijk" is bijna nooit een technische uitspraak. Het is een uitspraak over één route, gedaan door iemand die alleen die ene route aanbiedt. De vraag die telt is een andere: welke ingang heeft dit pakket, wie mag hem openzetten, en wat gebeurt er met die ingang bij de volgende versie.

Beantwoord die drie en je hebt binnen een week een werkende stroom, ook op software van vijftien jaar oud. Laat ze open en je bouwt iets dat het volhoudt tot de eerstvolgende dinsdagse update.