De integratie-ui: 12 lagen voor integraties die businessprocessen verbeteren en beheersbaar blijven
Applicaties koppelen is niet hetzelfde als processen integreren.
Een API-verbinding kan technisch prima werken en toch moeten medewerkers voortdurend gegevens corrigeren, informatie dubbel invoeren of fouten handmatig oplossen.
Een goede applicatie-integratie begint daarom niet bij de API. Je begint met de vraag: welk bedrijfsproces willen we verbeteren en welke zakelijke waarde moet de integratie opleveren?
Denk dan bijvoorbeeld aan:
- minder handmatige invoer en correcties;
- minder kans op fouten;
- sneller verwerken van klantgegevens, orders of mutaties;
- consistente data in verschillende applicaties;
- minder inzet van medewerkers voor repetitief werk;
- betere communicatie met klanten, leveranciers en andere stakeholders;
- meer grip op processen en uitzonderingen.
Daarna volgt de techniek planmatig.
In deze blog bekijken we applicatie-integratie als een ui die we laag voor laag afpellen. Zo komen we tot 12 bouwlagen, van doelstelling en procesanalyse tot API’s, datamapping, foutafhandeling, monitoring en beheer.
Wat is applicatie-integratie?
Applicatie-integratie is het proces waarbij verschillende, los van elkaar ontworpen, systemen en applicaties met elkaar worden verbonden, zodat data en functionaliteiten automatisch uitgewisseld kunnen worden met als doel:
Efficiënt en als één geheel samenwerken binnen het unieke businessproces van de organisatie.
Een webshopplatform kan een nieuwe bestelling bijvoorbeeld automatisch doorgeven aan het ERP-systeem. Daar worden de order en voorraad verwerkt en kan de facturatie plaatsvinden. De relevante order- en leverinformatie stroomt vervolgens automatisch door naar het WMS voor de logistieke afhandeling. Zodra de bestelling is verzonden, kan het WMS de Track & Trace-informatie terugkoppelen naar het ERP, de webshop en eventuele andere systemen.
De orderverwerker hoeft gegevens daardoor niet langer handmatig van systeem A naar systeem B en C over te nemen. Dat bespaart tijd, verkleint de kans op fouten en zorgt ervoor dat betrokken systemen over actuele en consistente informatie beschikken.
Een deugdelijke integratie houdt echter niet op bij een technisch ABC’tje, maar ondersteunt een compleet bedrijfsproces van A tot Z.
Dat is precies het uitgangspunt van het integratieplatform van Fluxygen. Niet losse point-to-pointkoppelingen staan centraal, maar de samenhang tussen applicaties, data- en workflows. Wij houden rekening met business rules, afhankelijkheden en uitzonderingen: welke data is leidend, wanneer moet een volgende processtap starten en wat moet er gebeuren als iets niet volgens verwachting verloopt?
Zo ontstaat niet alleen een technisch verbonden applicatielandschap, maar een geïntegreerd bedrijfsproces waarin systemen samenwerken, data automatisch op de juiste momenten wordt geüpdatet en jij en je medewerkers in control zijn.
Waarom is een API alleen niet genoeg?
Een API vertelt welke gegevens een applicatie technisch kan ontvangen of beschikbaar kan stellen. Een API vertelt niet automatisch:
- welke applicatie leidend moet zijn;
- wanneer gegevens moeten worden uitgewisseld;
- welke bedrijfsregels van toepassing zijn;
- hoe velden uit verschillende systemen bij elkaar horen;
- wat er gebeurt als informatie ontbreekt;
- hoe dubbele records worden voorkomen;
- wat er moet gebeuren wanneer een systeem tijdelijk niet bereikbaar is;
- wie actie moet ondernemen wanneer een proces vastloopt.
Daarom bouwen wij met de iPaaS van Fluxygen een integratie laag voor laag op.
Laag 1 — Bepaal het gewenste bedrijfsresultaat
Begin niet met: Welke API’s kunnen we koppelen?
Begin met:
Wat moet er na de integratie aantoonbaar beter gaan?
Denk dan bijvoorbeeld aan:
- orders sneller verwerken;
- klanten sneller onboarden;
- dubbele invoer elimineren;
- minder handmatige correcties;
- voorraad betrouwbaarder synchroniseren;
- informatie sneller beschikbaar maken;
- medewerkers meer tijd geven voor zinvolle taken in plaats van repetitief werk.
Met deze stap voorkom je dat er een technisch interessante koppeling wordt gebouwd zonder dat er vooraf een duidelijk bedrijfsdoel is vastgesteld.
Praktische tussenvraag 🤔
Kun je vóór de bouw beknopt uitleggen welke procesverbetering de integratie moet opleveren?
Als het antwoord nee is, dan is het waarschijnlijk nog te vroeg om te gaan bouwen.
Laag 2 — Onderzoek de beschikbare integratiemogelijkheden
In deze fase gaan we onderzoeken hoe de applicaties technisch bereikbaar zijn.
Een API ligt voor de hand, maar is niet de enige optie. Afhankelijk van de applicatie kunnen ook bijvoorbeeld webhooks, bestanden of batchuitwisseling via SFTP een rol spelen.
Bij oudere legacysystemen of specifieke on-premisesystemen zijn soms alternatieve integratiestappen nodig.
De technische route volgt dus uit het IT-landschap en de eisen van het proces. Niet andersom!
Laag 3 — Bestudeer de API-documentatie
Een API zonder goede documentatie is als een puzzel zonder voorbeeld op de doos.
Kijk dus niet alleen naar wat een API kan, maar bovenal naar de randvoorwaarden, zoals:
- beschikbare endpoints;
- authenticatiemethoden;
- verplichte en optionele velden;
- datatypes;
- paginering;
- rate limits;
- foutcodes;
- webhooks;
- versiebeheer;
- beperkingen bij grote datavolumes.
Een integratie kan tijdens een test met tien records bijvoorbeeld uitstekend functioneren en bij duizenden transacties tegen API-limieten aanlopen.
Dergelijke beperkingen wil je uiteraard vóór implementatie in kaart brengen.
Laag 4 — Regel en test credentials
API-toegang vereist authenticatie.
Dat kan relatief eenvoudig zijn met een API-sleutel, maar ook complexer worden met tokens, OAuth of aanvullende autorisatieprocessen.
Test toegang daarom vroeg in het traject.
Controleer niet alleen of inloggen lukt, maar ook of de gebruikte credentials daadwerkelijk toegang geven tot de benodigde data en functies.
Zo voorkom je dat een integratieontwerp later vastloopt op ontbrekende rechten.
Laag 5 — Breng processen en functionele gebieden in kaart
We verleggen nu de focus van techniek naar het bedrijfsproces.
Welke gegevens en processtappen moeten daadwerkelijk tussen de applicaties bewegen?
Bij een e-commerce-integratie kunnen dat bijvoorbeeld zijn:
Artikelgegevens
Productinformatie wordt vanuit het bronsysteem beschikbaar gemaakt voor andere applicaties.
Voorraad en prijzen
Actuele voorraad en prijzen worden automatisch gesynchroniseerd.
Verkooporders
Bestellingen worden vanuit een webshop, marketplace of OMS doorgegeven aan ERP of logistieke systemen.
Leveringen
Leverstatussen worden teruggekoppeld.
Track & Trace
Vervoerder en trackingcode worden automatisch beschikbaar gemaakt voor andere systemen en de klant.
Je kunt hieruit afleiden dat één “koppeling” in de praktijk vaak uit meerdere afzonderlijke gegevensstromen bestaat.
Laag 6 — Begrijp hoe de applicaties functioneren
API-documentatie alleen is onvoldoende.
Doorloop daarom het daadwerkelijke proces in beide applicaties.
- Welke velden ziet de gebruiker?
- Welke gegevens zijn verplicht?
- Wanneer ontstaat een ordernummer?
- Wanneer wordt een klantrecord aangemaakt?
- Welke statussen veranderen gedurende het proces?
Dit helpt om verschillen tussen de gebruikersinterface, het datamodel en de API te herkennen.
Maak tijdens deze analyse waar nodig schermafbeeldingen en leg vast welke velden functioneel met elkaar corresponderen.
Dat vormt een praktische voorbereiding op de datamapping.
Laag 7 — Leg business rules en uitzonderingen vast
Dit is in de praktijk een van de meest onderschatte onderdelen van applicatie-integratie.
Stel dat een order vanuit een OMS naar een ERP-systeem moet.
Dan kunnen vragen ontstaan zoals:
- Bestaat de klant al?
- Op basis waarvan bepalen we dat?
- Wat doen we wanneer dezelfde klant verschillende e-mailadressen gebruikt?
- Welk afleveradres is leidend?
- Maken we een nieuw adres aan of wijzigen we het bestaande adres?
- Wat gebeurt er bij een gedeeltelijke levering?
- Welke prijs is leidend bij kortingen?
- Wat gebeurt er wanneer essentiële informatie ontbreekt?
Technologie en AI kunnen deze beslissingen ondersteunen of automatiseren, maar de organisatie moet de business rules vaststellen en blijft verantwoordelijk voor de uitkomsten.
Business rules bepalen hoe de integratie zich in de werkelijkheid moet gedragen.
Laag 8 — Maak de datamapping
Er zijn meer hondjes die Fikkie heten.
Realiseer je dus dat hetzelfde gegeven in twee applicaties totaal anders wordt genoemd, opgeslagen of geïnterpreteerd.
Een artikelnummer kan in het ene systeem ItemCode heten en elders SKU, ProductID of iets geheel anders.
Datamapping bepaalt daarom:
- welk bronveld bij welk doelveld hoort;
- welke transformaties nodig zijn;
- welke waarden verplicht zijn;
- welke identifiers uniek zijn;
- hoe formaten worden geconverteerd;
- welk systeem eigenaar is van welke data.
Goede mapping voorkomt dat technisch correcte data functioneel verkeerde informatie oplevert.
Laag 9 — Bouw de integratieflows
Nu pas komen we bij het daadwerkelijk configureren en bouwen van de integratie.
In een Low-Code iPaaS zoals Fluxygen worden afzonderlijke stappen als flows opgebouwd.
Denk bijvoorbeeld aan:
- authenticeren;
- nieuwe orders ophalen;
- controleren of een klant bestaat;
- ontbrekende gegevens aanmaken;
- data transformeren;
- orderregels mappen;
- de order naar het ERP sturen;
- het resultaat controleren;
- statusinformatie teruggeven.
Door processen modulair op te bouwen worden onderdelen beter beheersbaar en waar mogelijk herbruikbaar.
Laag 10 — Ontwerp foutafhandeling, logging en herstel
Een integratie is niet goed ontworpen wanneer alleen de happy flow werkt.
Wat gebeurt er wanneer:
- een API tijdelijk niet bereikbaar is;
- authenticatie verloopt;
- een rate limit wordt bereikt;
- verplichte data ontbreekt;
- een record wordt geweigerd;
- een proces halverwege stopt;
- dezelfde transactie opnieuw wordt aangeboden?
Foutafhandeling moet daarom altijd onderdeel zijn van het ontwerp.
Afhankelijk van het proces kan een integratie bijvoorbeeld opnieuw proberen, een transactie apart zetten, een melding genereren of gecontroleerd stoppen.
Logging en monitoring maken vervolgens zichtbaar wat er is gebeurd en waar actie nodig is.
Dat is het verschil tussen een koppeling die alleen werkt zolang alles goed gaat en een integratie waarop een bedrijfsproces daadwerkelijk kan vertrouwen.
Laag 11 — Meet en optimaliseer
Na livegang begint een nieuwe fase.
De ervaring leert dat niet alle gebruikers melden wanneer er een inefficiëntie of bug in het proces zit. Soms lossen ze problemen zelf op met Excel, handmatige correcties of eigen workarounds.
Technisch lijkt de integratie dan in orde, terwijl in het proces ongemerkt nieuwe handelingen zijn ontstaan.
Kijk daarom periodiek naar vragen als:
- Waar grijpen medewerkers nog handmatig in?
- Welke fouten komen regelmatig terug?
- Welke flows duren langer dan verwacht?
- Waar ontstaan uitzonderingen?
- Welke data wordt alsnog gecorrigeerd?
- Welke processtappen kunnen verder worden geautomatiseerd?
Integratie is geen eenmalig project, maar een proces van meten, weten, leren en verbeteren.
Laag 12 — Organiseer beheer en verandering
Cloudapplicaties staan nooit stil.
API’s wijzigen, softwareleveranciers brengen nieuwe versies uit, bedrijfsprocessen veranderen en organisaties voegen nieuwe systemen, klanten of verkoopkanalen toe.
Daarom hoort beheer vanaf het begin bij de integratiearchitectuur.
Denk aan:
- monitoring;
- logging;
- versiebeheer;
- wijzigingen in API’s;
- security en autorisaties;
- performance;
- capaciteit;
- incidentafhandeling;
- documentatie;
- gecontroleerde wijzigingen.
Een stabiele integratie is dus niet alleen goed gebouwd, maar moet ook goed beheerd en doorontwikkeld worden.
Praktijkvoorbeeld: Exact Online koppelen met Hyarchis
Een concreet voorbeeld is de integratie tussen Exact Online en Hyarchis Compliance Manager, die bij Lunenburg Administratie- en Advieskantoor in productie is genomen.
Wanneer relatiegegevens in Exact Online wijzigen, zorgt de integratie ervoor dat de relevante informatie automatisch wordt verwerkt in Hyarchis. Daarbij gaat het niet alleen om het doorgeven van data, maar ook om het ophalen van de juiste gegevens, het herkennen van bestaande relaties en het controleren of de verwerking succesvol is afgerond.
Het resultaat: minder handmatige invoer, actuelere klantgegevens en meer tijd voor werkzaamheden die daadwerkelijk waarde toevoegen.
Paul Lunenburg verwoordt die waarde als volgt:
“Door processen slim en efficiënt in te richten geeft het systeem ons rust en overzicht.”
Dat is precies waar goede applicatie-integratie om draait: niet de koppeling zelf, maar wat die koppeling mogelijk maakt voor de organisatie en haar medewerkers.
Lees de volledige praktijkcase:
Hoe koppel je Exact Online aan Hyarchis Compliance Manager?
Wat levert een goed ontworpen applicatie-integratie op?
Wanneer processen, systemen en data goed op elkaar aansluiten, ontstaat zakelijke waarde op meerdere niveaus:
- handmatige overdrachten kunnen verdwijnen;
- fouten hoeven minder vaak te worden gecorrigeerd;
- informatie komt sneller beschikbaar;
- medewerkers hoeven minder tussen applicaties te schakelen.
Daarnaast ontstaat een fundament waarop processen verder kunnen worden geautomatiseerd.
Het doel is dus niet zoveel mogelijk systemen met elkaar te verbinden.
Het doel is om jouw unieke businessproces slimmer te laten verlopen, terwijl je organisatie grip houdt op data, uitzonderingen en veranderingen.
Integratie is complex, maar hoeft niet moeilijk te zijn
De oorspronkelijke metafoor blijft toepasselijk: applicatie-integratie lijkt op het afpellen van een ui.
Onder iedere technische laag blijkt weer een proces-, data- of businessvraagstuk te liggen. Wie direct bij de API begint, ontdekt belangrijke vraagstukken vaak pas tijdens de bouw — wanneer aanpassingen meer tijd, geld en ontwikkelcapaciteit kosten.
Wie eerst het gewenste resultaat, het proces, de data en de uitzonderingen begrijpt, kan veel gerichter bouwen.
Fluxygen helpt organisaties daarbij van analyse tot stabiele integratieflows in de cloud. Met een Low-Code-aanpak kunnen processen en applicaties worden geïntegreerd en geautomatiseerd, terwijl de organisatie zelf regie houdt over de verdere ontwikkeling.
Benieuwd waar in jouw processen handmatig werk, dubbele invoer of onnodige systeemovergangen kunnen verdwijnen?
Breng één concreet proces met ons in kaart. Dan wordt meestal snel duidelijk waar integratie daadwerkelijk waarde kan opleveren… zonder tranen bij het afpellen van de ui.
