Zo kiest u een koppeling tussen uw programma's: API, webhook of overtypen
Niet alles hoeft gekoppeld te worden. Sommige dingen typt u beter gewoon over. Dit is hoe wij die afweging maken.
Wat is het verschil tussen een API, een webhook en overtypen? Met een API haalt het ene programma gegevens op bij het andere, of schrijft ze daar weg. Een webhook is een seintje dat een programma zelf stuurt zodra er iets gebeurt. Overtypen is handwerk, en bij een paar keer per week vaak de verstandigste keuze. Kies op basis van hoe vaak het gebeurt en wat een fout kost.
Door Marc Herdes, ondernemer sinds 1999 en oprichter van Cloudzicht. Laatst nagekeken op .
In gewone taal
Vier manieren om gegevens van A naar B te krijgen.
Overtypen. Iemand leest het in het ene programma en typt het in het andere. Kost niets om op te zetten en werkt altijd, zolang die iemand er is en goed oplet.
Een bestand uitwisselen. U haalt een lijst uit programma A en leest die in bij programma B. Vaak vergeten, terwijl bijna elk pakket het kan. Prima voor iets wat één keer per dag of per week moet.
Een API. Een deur in een programma waar andere software aan mag kloppen. Bijvoorbeeld: "geef mij alle bestellingen van vandaag", of "maak deze factuur aan". De software die klopt, bepaalt wanneer.
Een webhook. Het omgekeerde. Het programma belt zelf aan zodra er iets gebeurt: "er is zojuist betaald", "er is een nieuwe aanvraag". U hoeft niet steeds te gaan kijken of er iets nieuws is.
Overtypen
Wanneer is overtypen gewoon goed?
Vaker dan men denkt. Een koppeling moet worden gebouwd, getest en onderhouden. Verandert een van de twee programma's, dan moet de koppeling mee. Dat is de moeite niet waard voor iets wat drie keer per week gebeurt en een minuut kost.
Overtypen is in orde als het weinig voorkomt, als een fout snel opvalt en makkelijk te herstellen is, en als er toch iemand naar moet kijken. Een nieuwe leverancier aanmaken in de boekhouding is zo'n geval. Dat wilt u met eigen ogen zien.
Het wordt een probleem als het dagelijks is, als er bedragen of datums in zitten, of als een fout pas bij de klant boven water komt. Bij een bowling- en partycentrum waar wij meeliepen werden gegevens met de hand tussen vijf systemen gekopieerd. Daar ging geregeld een datum of een prijs mis. Dat is het punt waarop overtypen duurder is dan koppelen.
Kiezen
Webhook of API: wat past waar?
Een webhook past als iets direct moet gebeuren nadat er iets anders is gebeurd. Een klant betaalt en de bestelling mag meteen naar het magazijn. Er komt een aanvraag binnen via de website en die moet direct als dossier klaarstaan.
Een API op vaste tijden past als het niet op de minuut hoeft. Elke nacht de facturen van die dag naar de boekhouding. Elk uur de voorraad bijwerken. Dat is eenvoudiger te bouwen en makkelijker te controleren, omdat u precies weet wanneer het loopt.
In de praktijk gebruiken wij ze vaak samen. De webhook geeft het seintje, en via de API halen wij daarna de volledige gegevens op. Daar komt een nachtelijke controle bij die kijkt of er niets is gemist. Die controle wordt vaak overgeslagen, en juist die haalt de fouten eruit.
Vooraf
Vier vragen aan uw leverancier.
Voordat u iemand een koppeling laat bouwen, wilt u dit weten. U kunt het zelf navragen bij de leverancier van elk pakket:
- Heeft het pakket een API, en zit die in ons abonnement? Bij sommige pakketten is dat een duurder abonnement of een losse module.
- Is er documentatie die een bouwer mag inzien? Zonder beschrijving wordt het zoeken, en zoeken kost uren.
- Kan het pakket webhooks sturen, en voor welke gebeurtenissen?
- Zijn er grenzen? Veel pakketten staan maar een bepaald aantal verzoeken per minuut of per dag toe.
Is het antwoord op de eerste vraag nee, dan blijft een bestand uitwisselen over. Of de vraag of dit pakket nog wel bij u past.
Valkuilen
Waar koppelingen in de praktijk op stuklopen.
Niemand heeft bepaald wie de baas is. Staat het adres van een klant in twee programma's, welk van de twee heeft dan gelijk? Spreek per gegeven af waar het wordt beheerd. Het andere programma volgt.
Dubbele records. Een seintje dat twee keer binnenkomt, een klant die net anders is gespeld. Een goede koppeling herkent wat er al is en maakt geen tweede aan.
De andere kant ligt even plat. Dat gebeurt, bij elk pakket. De koppeling moet het dan later opnieuw proberen en het niet stil laten vallen.
Geen logboek. Als u niet kunt terugzien wat er wanneer is overgezet, komt u er bij een fout nooit achter waar het misging. Wij bouwen altijd een overzicht in dat een gewoon mens kan lezen.
Zo pakken wij het aan
Eerst tekenen wat er nu heen en weer gaat.
Wij beginnen met een vel papier: welke programma's heeft u, welke gegevens gaan van waar naar waar, en wie doet dat nu met de hand. Daar komt meestal uit dat één of twee stromen bijna al het werk veroorzaken. Die koppelen wij. De rest blijft overtypen, en dat is prima.
Vaak begint het bij de keten van offerte tot factuur. Zie Offertesoftware, Werkbonnensoftware en Facturatiesoftware. Zijn er te veel pakketten om nog zinvol te koppelen, lees dan waarom standaardsoftware niet altijd past.
Wilt u dat wij meekijken?
Noem ons de programma's die u gebruikt en wat er nu wordt overgetypt. Wij zoeken uit wat er te koppelen valt en zeggen het ook als het de moeite niet loont.
Plan een kennismaking Bedrijfssoftware op maat Zo werken wij samen
Veelgestelde vragen
Wat u nog wilt weten.
Wat is een API in gewone taal?
Een API is een afgesproken manier waarop het ene programma gegevens kan opvragen of wegschrijven bij het andere, zonder dat er een mens tussen zit. Vergelijk het met een loket: u mag alleen vragen wat op de lijst staat, en u krijgt het antwoord in een vaste vorm terug.
Wat kost een koppeling tussen twee programma's?
Dat hangt af van wat de twee pakketten toelaten en hoeveel soorten gegevens er over en weer gaan. U krijgt van ons een vaste prijs vooraf, na een gratis kennismaking. Op uurbasis werken wij voor € 99 tot € 125 per uur excl. btw, afhankelijk van het soort werk en de persoon.
Wat gebeurt er als een van de programma's een update krijgt?
Meestal niets, want een leverancier houdt zijn API zo veel mogelijk gelijk. Verandert er toch iets, dan moet de koppeling worden aangepast. Daarom bouwen wij een logboek en een controle in, zodat een probleem opvalt voordat u het merkt aan ontbrekende facturen.

Praat met een mens
Praat direct met Marc
Geen verkooppraatje. Vertel wat er speelt, dan zeggen wij eerlijk wat wij ervan denken.
036 52 98 447Zullen we het erover hebben?
Vertel in een paar zinnen wat er speelt. Wij zeggen eerlijk wat wij ervan denken. Het eerste gesprek kost niets.