Integratie-advies voor AFAS: eerst het ontwerp, dan de koppeling
Tussen 2018 en 2024 toetste en certificeerde Christian Lankman integraties van AFAS-partners. Zes jaar lang aan de andere kant van de tafel: beoordelen of andermans koppeling deugde. Die blik nemen we mee naar elk integratievraagstuk dat we oppakken.
Want een koppeling bouwen is zelden het moeilijkste deel. Het moeilijke deel is vooraf zien waar het misgaat: welk proces er precies achter hangt, hoeveel data er doorheen gaat, wie het merkt als de verbinding een uur ligt, en of iemand daar op tijd op reageert.
- Zes jaar AFAS-partnerintegraties getoetst en gecertificeerd, 2018–2024
- Advies en toetsing van het ontwerp, niet alleen realisatie
- Risico's benoemd voordat er een regel code staat
Zo loopt een integratietraject bij ons
De aanpak volgt dezelfde lijn als onze bredere werkwijze: eerst begrijpen, dan bouwen. Vier fasen, waarbij de eerste twee bepalen hoe duur de laatste twee worden.
Intake
Passen wij bij dit vraagstuk?
Vraagstuk en risicovlakken in kaart
Welk proces loopt hierover, en waar gaat het stuk?
Opdelen in blokken met eigen deliverables
Wat levert dit blok op, en klopt het nog?
Integratietesten, livegang en nazorg
Werkt het ook als het echt draait?
Stap 01: Intake: past dit bij elkaar?
Het eerste gesprek gaat twee kanten op. Wij willen weten wat er speelt; jij wilt weten of wij de juiste partij zijn. We toetsen ook of het traject past bij onze beschikbaarheid: liever vooraf eerlijk dan halverwege vastlopen op een agenda.
Stap 02: Vraagstuk en risicovlakken in kaart
We beginnen bij het proces, niet bij de API. Welke systemen praten met elkaar, welke gegevens gaan waarheen, om hoeveel data gaat het en in welk tempo? Daarna benoemen we expliciet waar het fout kán gaan: foutafhandeling, dubbele of ontbrekende records, autorisaties, en wat er gebeurt als een systeem een paar uur uit de lucht is.
Niet elk risico hoeft afgedekt. Een nachtelijke synchronisatie van personeelsmutaties vraagt iets anders dan een realtime koppeling onder een primair proces. We maken onderscheid tussen wat nu moet, wat later kan en welk risico je bewust accepteert, met de reden erbij, zodat de keuze later navolgbaar is.
- Welk proces loopt er werkelijk over deze koppeling?
- Om hoeveel data gaat het en komt die gelijkmatig binnen of in pieken?
- Wie werkt er straks mee, en wat heeft die persoon nodig?
- Wie merkt het als het misgaat, en reageert die persoon op tijd?
Stap 03: Opdelen in blokken met eigen deliverables
We schetsen het traject en de verwachte doorlooptijd, en knippen het ontwerp op in blokken die elk iets opleveren. Na elk blok testen we of de doorloop is wat we verwachtten. Zo niet, dan sturen we bij. Omdat we in contact blijven over budget, gebeurt dat bijsturen op een moment dat het nog kan.
Stap 04: Integratietesten, livegang en nazorg
Aparte integratietestsessies vóór livegang, waarin de keten als geheel wordt beproefd. Daarna ronden we pas af ná de livegang. Sommige problemen zie je nu eenmaal alleen in productie, en dan wil je dat degene die het ontwerp heeft gemaakt nog aan tafel zit.
Wat je van ons kunt verwachten
- Een eerlijk oordeel over het ontwerp, ook als dat "niet doen" is
- Risico's benoemd in gewone taal, niet weggestopt in een technisch document
- Onafhankelijk meedenken, ook als een andere partij de bouw doet
- Overdracht en kennisdeling als vast onderdeel
Wat we niet doen
- Een koppeling bouwen zonder het proces erachter te kennen
- Alles maximaal beveiligen omdat het kan
- Afhankelijkheid creëren zonder plan voor borging
Integratievlakken waar we de meeste ervaring in hebben
Een koppeling is zelden alleen een technisch vraagstuk. De moeilijkheid zit bijna altijd in het proces eronder: hoe diep het datamodel is, wie er op welk moment de leiding heeft, en wat er gebeurt als twee systemen het oneens zijn. Dit zijn de vlakken waar we het vaakst worden gevraagd.
HR en payroll
Salaris-, pensioen- en verzuimstromen raken direct aan mensen, en fouten vallen daar altijd op. Het datamodel van AFAS is op dit vlak diep: hoe een medewerker in dienst treedt, wat er aan een mutatie hangt, welke standaardfunctionaliteit er al is. Dat staat niet in de API-documentatie.
Een voorbeeld uit de praktijk: de overgang van salarisverwerking in SAP naar AFAS. De bron leverde gegevens aan in een structuur die niets met AFAS te maken had, dus moest de middleware ertussen die vertaling maken. Daar zit het echte werk. Niet in het versturen van de gegevens, maar in de vraag wat een veld aan de ene kant betekent en waar dat aan de andere kant thuishoort. Ook een pensioenintegratie richting ABP loopt op dit vlak.
ERP: productieorders, samenstellingen, serienummers en locaties
Het meest complexe vlak dat we tegenkomen. Een productieorder met samenstellingen, serienummers en voorraadlocaties raakt in AFAS aan meerdere lagen tegelijk, en een koppeling die één van die lagen negeert werkt maandenlang schijnbaar goed. Tot iemand een serienummer terug moet zoeken.
Kritische workflows tussen twee organisaties
Voor een security-workflow ontwierpen en bouwden we de koppeling tussen het ticketsysteem van een extern securityteam en dat van de interne ICT-afdeling die de meldingen oppakt. Twee systemen, twee organisaties, geen webhooks aan beide kanten, en afwisselend het ene en dan weer het andere systeem in de lead.
De inhoudelijke eis was niet "de data moet over" maar "de meldende partij moet snel weten dát er iemand mee bezig is". Zonder die bevestiging blijft een melding in de lucht hangen en wordt er geëscaleerd terwijl er allang aan gewerkt wordt. De koppeling legt daarom de communicatie aan beide kanten vast en maakt reactietijden meetbaar. Zodra twee systemen elkaar beide mogen bijwerken, verschuift de vraag van "hoe krijgen we de data over" naar "wie wint bij een conflict, en hoe weten we dat we niets zijn kwijtgeraakt". Dat is een ontwerpvraag, geen bouwvraag, en die beantwoord je vóór de eerste regel code.
Koppelingen met externe platformen en API's
Shopify, Pipedrive, Exact Online, Microsoft Graph, GitHub, TomTom, Google Maps: platformen met een eigen API, eigen tempo en eigen opvattingen over hoe data hoort te bewegen. Wij verkennen zo'n API, bepalen wat er wél en niet betrouwbaar uit te halen valt, en vertalen dat naar een ontwerp dat aansluit op AFAS in plaats van op een ideaalbeeld.
Recent ook koppelingen met AI-diensten (OpenAI, Anthropic en OpenRouter), waar bovenop de gewone integratievragen nog een laag bijkomt: welke gegevens mogen dit systeem eigenlijk verlaten.
AFAS naar AFAS
Validatie- en synchronisatiekoppelingen tussen AFAS-omgevingen onderling. Klinkt eenvoudig omdat beide kanten hetzelfde systeem zijn, maar juist daar wordt aannames maken makkelijk gemaakt: dat identificatie hetzelfde werkt, dat de inrichting gelijk is, dat wat aan de ene kant valide is dat aan de andere kant ook is.
Staat jouw vraagstuk er niet tussen? Het onderliggende patroon is vaak hetzelfde: gegevens die tussen systemen bewegen, een proces dat daarvan afhangt, en een organisatie die moet weten wat er gebeurt als het misgaat.
Goed om te weten voordat je belt
Wie je krijgt
Covio is een team van vier. Christian Lankman is medeoprichter en inhoudelijk verantwoordelijk voor integratietrajecten. Vier mensen is klein, en dat heeft twee kanten: je praat met degene die het werk ook daadwerkelijk doet, en we moeten eerlijk zijn over wat we aankunnen. Daarom staat beschikbaarheid al in de intake en niet pas in week drie. Wat we wél borgen: ontwerpkeuzes, afwegingen en afspraken leggen we vast, zodat een traject niet in één hoofd zit.
Wij bouwen zelf ook, en dat zeggen we erbij
Als je ons vraagt een ontwerp te toetsen, hebben wij er commercieel belang bij dat daar werk uit voortkomt. Dat is een reëel spanningsveld, dus scheiden we het: een toets of adviestraject is een afgeronde opdracht met een eigen prijs, en de uitkomst hangt niet af van de vraag wie het uitvoert. Is de beste oplossing dat je huidige partij het bouwt, of dat je het voorlopig niet bouwt, dan staat dat in het advies.
Persoonsgegevens
Veel van deze koppelingen raken aan HR-, salaris- en pensioengegevens. Afspraken over de verwerking daarvan maken we standaard onderdeel van de overeenkomst.
Leg je integratievraagstuk aan ons voor
Het begint met een intake. Daarin bepalen we samen of je vraag om een kort advies vraagt, om een toets op een bestaand ontwerp, of om begeleiding van een heel traject, en of wij daar de juiste partij voor zijn. Dat gesprek kost je een uur en levert in ieder geval een scherper beeld op van wat er speelt.