GetConnectors zijn de eerste keuze voor elk data-vraagstuk op AFAS: dashboards in Power BI of Tableau, koppelingen met een externe app, of regelmatige exports voor accountant of auditor. UpdateConnectors zijn de tegenpoot voor schrijven: medewerkers aanmaken vanuit een wervings-tool, declaraties importeren vanuit een rittenregistratie, of orders binnenhalen vanuit een webshop. Een ervaren consultant kiest de juiste connector, regelt de autorisatie en zorgt dat tokens niet stiekem aflopen.
Wat is een GetConnector precies?
Een GetConnector is een door u gedefinieerde uitvoer-view op AFAS-data. U kiest velden, filters, sorteer-volgorde en doorlooprichting (parent-child relaties). De connector levert XML of JSON op een token-geautoriseerd endpoint. AFAS Online levert standaard al een lijst van veelgebruikte connectoren maar in de praktijk bouwt u er per organisatie tien tot vijftig op maat voor specifieke rapportage- en integratie-doeleinden.
De kunst zit in de balans tussen herbruikbaarheid en performance. Een te smalle GetConnector verplicht u tien queries op te volgen om één Power BI dataset te bouwen. Een te brede connector wordt onhandelbaar traag en duurt minuten per ophaal. Een consultant met integratie-praktijk ontwerpt connector-portfolios op niveau: een handvol brede master-connectoren voor stamdata, smalle transactie-connectoren met incremental-load voor mutaties.
UpdateConnectors: de andere kant
Voor data naar AFAS toe gebruikt u UpdateConnectors. AFAS levert standaard UpdateConnectors voor de meeste schrijf-acties (KnEmployee, FiEntries, KnSalesOrder), die u via XML aanroept. Validatie gebeurt op AFAS-kant tegen de business-rules van uw inrichting, wat een tweesnijdend zwaard is: vangnetten zitten erin, maar fouten komen pas naar boven nadat de XML al is aangeleverd.
Voor complexere integraties bouwt een AFAS-consultant testmechanismen aan de aanleverende kant zodat geüploade berichten niet eerst tegen AFAS-validatie aanlopen. Voorbeeld: voor een koppeling met een rittenregistratie die declaraties pusht, willen wij in de tussenliggende middleware checken op CAO-categorie, kostenplaats en datum-overlap voordat we de UpdateConnector aanroepen.
Wanneer past een freelance AFAS integratie-consultant?
Bij een groene-veld koppeling waar uw AFAS-inrichting of de externe app nog niet vast staat. De consultant kan beide kanten ontwerpen en voorkomt dat u later vastloopt op een keuze die niet meer terug te draaien is.
Bij bestaande koppelingen die regelmatig falen. Vaak ligt de oorzaak in: tokens die niet roteren, GetConnectors die ad-hoc zijn aangepast zonder de afnemende systemen mee te nemen, of AFAS-releases die een veld hernoemen waarop een nabij-systeem afhankelijk is.
Bij audit-vraagstukken waar u moet aantonen welke data AFAS verlaat en wie daar toegang toe heeft. De consultant brengt de connector-portfolio in kaart en koppelt aan autorisatie-rollen.
Onze aanpak voor AFAS integraties
De eerste stap is altijd inventarisatie. We brengen alle bestaande GetConnectors en UpdateConnectors in kaart, koppelen aan de afnemende of aanleverende systemen, en noteren tokens, owners en laatste wijziging. Een verrassend deel van de connector-portfolio bij organisaties die langer met AFAS werken, is verlaten of niet meer in gebruik.
Daarna ontwerpen we de target-portfolio. Master-connectoren voor stamdata (medewerkers, kostenplaatsen, organisatie-eenheden) leveren we breed met SCD-style velden voor versie-historie. Transactie-connectoren maken we smal met incremental-load via Laatst Gewijzigd-veld. UpdateConnectors documenteren we per business-event, niet per technisch endpoint.
Daarna komt het bouwwerk. AFAS-connectoren zelf kunnen functioneel beheerders ook bouwen, maar het ontwerp van filters, performance-test en owner-overdracht hoort bij een consultant. Tokens leggen wij vast in een password-manager of secret-store en koppelen we aan een rotatie-cyclus van twaalf maanden.
Daarna komt de integratie zelf. Voor Power BI bouwen wij de dataset in Power BI Service met scheduled refresh, niet in lokaal pbix waar tokens snel verlopen. Voor koppelingen met Mollie, Outlook, Rabobank of nationale verzekeraars werken wij vaak met een middleware-laag (Azure Logic Apps, Power Automate of een eigen IPaaS-laag) zodat AFAS niet rechtstreeks aan de buitenwereld hangt.
Valkuilen die wij regelmatig zien
Token-expiratie is de meest voorkomende oorzaak van koppeling-storingen. AFAS-tokens vervallen niet automatisch, maar veel organisaties roteren ze nooit. Daardoor ligt een verlaten token jaren lang ergens in een script of in iemands laptop. Een ervaren consultant zet daar een rotatie-cyclus en een centrale registratie omheen.
Velden die wijzigen tussen AFAS-releases zonder dat u het merkt. AFAS publiceert update-notes per release, maar releases volgen elkaar twee keer per jaar op en kleine veld-aanpassingen verdwijnen onder grotere wijzigingen. De consultant zet een release-acceptatie-cyclus op waarin de connectoren mee worden getest.
Performance-issues bij grote organisaties. Een GetConnector die om twee uur 's nachts twee uur draait om medewerkers en historie binnen te halen, kan in productie acceptabel zijn, maar zal in een datawarehouse-context te traag zijn. We splitsen brede connectoren in master plus transactie, met incremental-load op transactie-kant.
Documentatie die ontbreekt. Connectoren worden vaak gebouwd voor één integratie en niet beschreven. Bij de volgende koppeling weet niemand of de bestaande connector hergebruikt kan worden. We leggen connectoren vast in een register met owner, doel, afnemers en token-eigenaar.
Wat onderscheidt een goede AFAS integratie-consultant?
AFAS Open-praktijk in meerdere projecten. Iemand die alleen GetConnectors heeft gebouwd voor één Power BI-dataset, mist de patronen voor middleware-integraties en error-handling. Wij vragen door op de drie meest complexe integraties die iemand heeft gebouwd voordat we voorstellen.
Begrip van middleware-stacks (Azure Logic Apps, Power Automate, Mendix, eigen IPaaS) plus AFAS. De combinatie maakt de consultant geschikt voor moderne integratie-architectuur waar AFAS één bron is naast Salesforce, een webshop of een tijdregistratie.
Documentatie-discipline. AFAS-integraties die de overdracht tussen freelancers en interne teams overleven, hebben een consultant achter zich die structureel vastlegt wat is gebouwd en waarom.
Hoe wij u koppelen
Stuur ons uw integratie-vraag (welke systemen, hoeveel records, real-time of batch) en de huidige stand van uw AFAS Open-inrichting. Wij reageren binnen één werkdag met een korte intake en dragen één freelance AFAS-consultant voor met integratie-praktijk in uw stack. Plan via het formulier hieronder voor concrete bespreking.
Verwant: ZZP AFAS consultant, AFAS Power BI dashboards