Blogs

Integratie is gelaagd, als een ui

Bouwlagen van applicatie-integratie

Steeds meer bedrijfsprocessen zijn ingebed in specifieke (cloud)applicaties die ontworpen zijn voor één of enkele taken. De gebruiker van deze applicaties is vaak de enige die informatie uit verschillende systemen synchroniseert, interpreteert en integreert. Applicatie-integratie zorgt voor optimalisatie van bedrijfsprocessen met als doel tijdsbesparing, verkleining van de foutmarge en/of kostenbesparing.

Applicatie-integratie lijkt een kwestie van het verbinden van applicatie-eindpunten. In de praktijk is dit eigenlijk een van de laatste stappen en de meest technisch georiënteerde. Er zijn nogal wat stappen die genomen moeten worden voordat je aan de daadwerkelijke koppeling van endpoints toekomt. Onlangs hebben we alle stappen doorlopen in een Exact gerelateerd project en op basis van dit voorbeeld delen we graag onze visie op hoe je tot de kern van de integratie komt. Laten we samen de ui afpellen.

De ui samengevat

Checklist integratie

In deze checklist nemen we je mee door de praktische stappen van het integratieproces.

Elke stap uit dit artikel wordt vertaald in 13 stappen naar succesvolle integratie.

De 1e laag

Wat is het gewenste eindresultaat?

In dit geval wil ProductFlow een integratie “bouwen” met Exact Online.

ProductFlow ontwikkelt software die kan worden samengevat als een combinatie van een PIM (Product Information Management) met een OMS (Order Management System) dat naadloos integreert met populaire marktplaatsen. ProductFlow zorgt voor het vastleggen van de juiste productinhoud, de distributie ervan naar marktplaatsen en de synchronisatie van de order met bijbehorende statussen.

Exact Online is een zeer uitgebreid financieel en logistiek systeem (en meer) waarin het gehele logistieke en financiële proces wordt ondersteund. Exact Online heeft een uitgebreide set API’s die volledige integratie ondersteunen.

Het gewenste eindresultaat is;

De 2e laag

Is er een API beschikbaar?

Een eenvoudige Google-zoekopdracht zal je waarschijnlijk vertellen of de te integreren applicaties een API hebben. Als dat antwoord niet meteen duidelijk is, zoek dan de leverancier en zoek daar het antwoord. Als er geen API beschikbaar is, kijken we vaak naar een (verouderde?) on premise applicatie. Het is een grotere uitdaging om met dat soort applicaties te integreren. Als noodoplossing kun je overwegen of batchuitwisseling via (s)FTP een nuttig alternatief kan zijn.
De 3e laag

Is er API-documentatie beschikbaar?

Een API zonder goede documentatie voelt aan als een puzzel van 3000 stukjes zonder een beeld van het eindresultaat. Kijk in de documentatie niet alleen naar de mogelijkheden, maar ook naar eventuele beperkingen. Let extra goed op de API limieten, want die kunnen je later beperken als er grote hoeveelheden data of hoge frequenties zijn die de API niet toestaat. Die documentatie is dus essentieel!

De 4e laag

Verzamel de referenties

Je krijgt (over het algemeen) niet zomaar toegang tot een API. Soms heb je alleen een API-sleutel nodig, soms worden er complexere stappen gevraagd om toegang te krijgen tot de API (bijvoorbeeld Amazon Seller API). Om teleurstellingen later in het proces te voorkomen, moet je altijd testen of je toegang kunt krijgen tot de API’s van de te integreren applicaties met de credentials.

De 5e laag

Welke functionele gebieden zijn geïntegreerd?

De combinatie van deze applicaties wordt in dit geval gebruikt door bedrijven die actief zijn op een of meer marktplaatsen voor B2C-verkoop. Om het proces te ondersteunen, zijn de volgende functionele gebieden geïdentificeerd;

De 6e laag

De functionaliteit van de applicaties

Applicatiekennis is essentieel, enerzijds om de processtappen uit laag 2 te begrijpen, anderzijds om de onzichtbare bedrijfsregels (de 7e laag) te begrijpen. Het doorlopen van het volledige bijbehorende proces in de applicatie draagt bij aan een succesvolle integratie omdat resultaten beter gevalideerd kunnen worden en er een beter begrip is van waar rekening mee gehouden moet worden. Deze oefening zal ook andere problemen aan het licht brengen, zoals technische documentatie die niet up-to-date is, gegevens die zichtbaar zijn in de interface maar niet beschreven zijn in de API, of dat de relatie tussen veldnamen in de interface moeilijk of onmogelijk te traceren is naar de kenmerken in de resultaatoutput van de API.

Bij het invoeren van een order in Exact Online kent Exact een order-, aflever- en factuurdebiteur. De debiteur, contactpersoon en afleveradres moeten bestaan of worden aangemaakt tijdens de invoer.

Bij het indienen van die gegevens via API, moet u eerst controleren of de debiteur uit de ProductFlow order al bestaat, bijvoorbeeld door de aanwezigheid van het e-mailadres te controleren. Als het bestaat, kunt u de unieke identifier (GUID) van de debiteur ophalen en opslaan voor later in het proces. Je moet hetzelfde doen voor de contactpersonen. Voor de adressen is het echter verstandig om het huidige afleveradres dat op marktplaats staat als nieuw adres aan te maken en te koppelen in de bestelling.

Als bepaalde informatie niet beschikbaar is bij het integreren van een order, zult u deze eerst moeten aanmaken, de debiteur staat bijvoorbeeld nog niet in Exact Online. Hier zie je al een conceptualisatie van het proces in verschillende integraties, in Dovetail noemen we dit een flow. Inzicht in hoe informatie binnen de applicaties stroomt en welke informatie op elk moment beschikbaar moet zijn, is een voorwaarde voor een succesvolle integratie.

De 7e laag

Ken de bedrijfsregels

Het bovenstaande voorbeeld over het maken van een debiteur, contactpersoon en adres via API gaat over bedrijfsregels die gekoppeld zijn aan de applicatie en die je moet weten om te voorkomen dat een oud afleveradres wordt gebruikt voor de huidige bestelling.

Een ander voorbeeld zijn prijsberekeningen waarbij je onderscheid moet maken tussen prijsstamgegevens en een prijs die in de transactie wordt bepaald op basis van kortingen, staffels of mix/match-regels. Een prijs die is bepaald in een transactie is alleen beschikbaar in een berekening in combinatie met andere artikelen en andere variabelen.

De 8e laag

Gegevens in kaart brengen

Niet alle krokodillen zijn krokodillen!

Elke toepassing heeft dus zijn eigen naamgevingsconventie voor velden, zowel op de interface, in de database als binnen de API. Geschiedenis, voortschrijdend inzicht en (non)consistentie betekenen dat logica niet altijd logisch is. De kans dat het artikelnummer in beide applicaties ItemID heet, is dus niet zo groot… Daarom moeten we ervoor zorgen dat beide kanten van de integratie dezelfde taal spreken door middel van mapping.

De 9e laag

De integratiestromen configureren

Als alle voorbereidingen gedaan zijn, kunt u beginnen met het configureren van de integratiestroom. Binnen Fluxygen heb je geen programmeerkennis nodig, je hoeft niet te kunnen coderen.
De Fluxygen gereedschapskist is goed gevuld met alles wat je nodig hebt om de integratie te bouwen.

Het is gebruikelijk om een aparte flow te bouwen voor de authenticatie en om variabelen vast te leggen die je “geldig” kunt houden en later in het proces kunt blijven gebruiken.

Je bouwt de stromen stap voor stap op totdat volledige integratie tussen de systemen is bereikt.

De 10e laag

Foutafhandeling

Net zo belangrijk is de afhandeling van fouten. De gelukkige stroom configureren is niet zo moeilijk, maar wat doen we als iets niet gaat zoals verwacht? En weten we eigenlijk wel wat er mis kan gaan? Het probleem is dat we niet weten wat we niet weten. En het probleem daarbij is dat we een economische afweging moeten maken in de hoeveelheid tijd die we besteden aan het zoeken naar problemen. Dus maken we pragmatische afwegingen en controleren we de foutafhandeling voor alles wat we redelijkerwijs kunnen voorzien;

Binnen Fluxygen heeft elke flow een zogenaamde foutroute. Als er iets fout gaat in de flow, dan val je terug op deze foutroute waarin je eerder hebt bepaald wat er moet gebeuren.

We zeggen ook: integratie is iteratie, elke volgende versie is beter!

De 11e Laag

Optimalisatie

Het kan altijd beter! Ongetwijfeld weten we nu een aantal dingen die we eerst niet wisten. En we hebben waarschijnlijk een aantal fouten hersteld, waardoor de kans op nieuwe fouten afneemt. Zoals gezegd, integratie is iteratie.

Wat dagelijks veel gebruikt wordt, kan altijd verbeterd worden. Je realiseren dat een gebruiker fouten misschien niet meldt, maar “gewoon” zelf oplost. Zich niet realiseren dat niet alleen hij (of zij) dit voor zichzelf oplost, maar dat collega’s dat waarschijnlijk ook doen. Dat was natuurlijk niet de bedoeling van integratie! Loop rond, vraag hoe het gaat en of de collega’s hun proces kunnen doorlopen zonder handmatige aanpassingen.

De 12e Laag

Beheer

Onzichtbaar, maar elke cloudapplicatie wordt onderhouden op het gebied van infrastructuur, updates en upgrades van besturingssystemen, updates en upgrades van onderliggende frameworks, hot-fixes en updates van de applicatie(s). Alles bij elkaar is dat werk voor een team van DevOps, back- en front-end ontwikkelaars, productmanagers, consultancy- en supportspecialisten.

Het is echter belangrijk om in de gaten te houden welke impact het heeft op je integratiestromen. Als een effect van een update is dat een veldnaam is veranderd in applicatie A die deel uitmaakt van een integratie, dan kan dat effect hebben op alle stappen in de flow.

Zorg ervoor dat je het tempo van de updates van de applicaties bijhoudt. Uitzonderingsbeheer helpt je om een stabiele integratie te behouden.

De 13e laag

Beheer van veranderingen

Omdat er altijd ruimte is voor verbetering, volgens ons of volgens de gebruiker, omdat het landschap van de gebruiker verandert, omdat er nieuwe functionaliteit nodig is.
Elke verandering vereist dat onze mensen de bestaande situatie lezen en analyseren.

Veranderingsverzoeken worden afgehandeld door middel van een RfC, een Request for Change waarin onze consultant de mogelijkheden, de gevolgen in functionaliteit, tijd en geld beoordeelt.

De moraal van het verhaal

Applicaties integreren is meer dan het ontwikkelen van een technische integratie. Er gaan heel wat stappen aan vooraf en er volgen er nog een paar. Daarom zeggen we “Integratie is complex, maar niet moeilijk”.

Bij het pellen van de ui is de kans groot dat je een traantje moet wegpinken… Dat proberen we te voorkomen door het hele verhaal te vertellen en zo de verwachtingen te verhelderen.

Dat noemen we Integratie gemakkelijk gemaakt

Relevante bronnen

Een API-koppeling is nog geen applicatie-integratie

Een API-koppeling alleen maakt nog geen goede a...

Afl. 6: Het slim afhandelen van fouten – Integratie TMS met Visibility platform

In de laatste aflevering van Integreren met Flu...

Exact Online InvoiceSalesOrders API wijzigt: wat moet je vóór oktober 2026 doen?

Exact Online wijzigt de InvoiceSalesOrders API....

Hoe koppel je Exact Online aan Hyarchis Compliance Manager?

Ontdek hoe Fluxygen Exact Online en Hyarchis Co...

Deze website gebruikt cookies

Wij gebruiken cookies om inhoud te personaliseren, functies voor sociale media te bieden en ons verkeer te analyseren. Wij delen ook informatie over uw gebruik van onze site met onze analysepartners. U kunt uw voorkeuren op elk moment wijzigen. Raadpleeg voor meer informatie ons Privacybeleid en Cookiebeleid.