"Onze systemen praten niet met elkaar" is een van de meest gehoorde klachten bij bedrijven die met meerdere softwarepakketten werken. In dit artikel leg ik uit hoe ik koppelingen (API-integraties) tussen bestaande systemen aanpak, en waar het vaak misgaat.
Herkenbaar? Deze signalen wijzen op een ontbrekende koppeling
- Medewerkers typen dezelfde gegevens meerdere keren over in verschillende systemen.
- Voorraad, orders of klantgegevens lopen na verloop van tijd uit elkaar tussen systemen.
- Rapportages worden handmatig samengesteld uit exports van losse pakketten.
- Er is een vast 'synchronisatiemoment' (bijvoorbeeld elke ochtend) in plaats van dat gegevens direct actueel zijn.
Wat is een API-koppeling eigenlijk?
Een API (application programming interface) is de manier waarop twee softwaresystemen gestructureerd met elkaar kunnen communiceren — zonder dat een mens gegevens hoeft over te typen. Meer achtergrond hierover lees je in mijn algemene artikel over API's. De meeste moderne pakketten (webshops, boekhoudpakketten, CRM's, ERP's) bieden een API aan, al verschilt de kwaliteit en documentatie daarvan sterk per leverancier.
Stap 1: in kaart brengen wat er daadwerkelijk moet gebeuren
Voordat ik ook maar naar API-documentatie kijk, breng ik eerst het proces in kaart: welke gegevens moeten van systeem A naar systeem B, hoe vaak, en wat moet er gebeuren als iets misgaat? Een koppeling die technisch werkt maar het verkeerde proces automatiseert, lost niets op.
Stap 2: beoordelen wat de systemen daadwerkelijk aankunnen
Niet elke API is even geschikt voor elke koppeling. Sommige systemen bieden alleen een beperkte, verouderde API aan; andere hebben duidelijke limieten op het aantal aanvragen per minuut. Dit bepaalt of een koppeling in realtime kan werken, of dat een periodieke synchronisatie realistischer is — relevant bijvoorbeeld wanneer je maatwerk-ERP koppelt aan een webshop.
Stap 3: bepalen wie 'de waarheid' is
Bij elke koppeling tussen twee systemen moet helder zijn welk systeem leidend is voor welk gegeven. Zonder die afspraak ontstaan tegenstrijdige updates — bijvoorbeeld wanneer een klantadres in twee systemen tegelijk wordt aangepast.
Stap 4: bouwen met foutafhandeling als uitgangspunt
Een koppeling die alleen werkt als alles goed gaat, is in de praktijk een tijdbom. Ik bouw koppelingen altijd met expliciete foutafhandeling: wat gebeurt er als een systeem tijdelijk niet bereikbaar is, als gegevens ontbreken, of als een aanvraag mislukt? Dat soort situaties komen in de praktijk vaker voor dan je zou verwachten.
Stap 5: monitoren na livegang
Een koppeling is nooit 'klaar en vergeten'. Externe systemen wijzigen hun API soms zonder aankondiging, waardoor een koppeling ineens kan haperen. Ik zet daarom monitoring op die tijdig signaleert wanneer een koppeling niet meer werkt zoals verwacht, zodat dit wordt opgemerkt voordat het tot dataverlies of klachten leidt — dit is ook een vast onderdeel van mijn dienst Applicatiebeheer en doorontwikkeling.
Twee systemen die niet met elkaar praten hoeft geen blijvend probleem te zijn
Zelfs tussen systemen die niet voor elkaar gebouwd zijn, is vrijwel altijd een werkbare koppeling te realiseren — soms via een officieel aangeboden API, soms via een tussenlaag die twee systemen verbindt. Het begint met goed in kaart brengen wat je systemen daadwerkelijk kunnen en wat het proces nodig heeft. Benieuwd wat dit voor jouw systemen kan betekenen? Bekijk mijn dienst API integraties.