AFAS API koppelen aan je website.

AFAS is Nederlandse bedrijfssoftware uit Leusden, in gebruik bij ruim veertienduizend organisaties. Het is geen wervingssysteem met er wat omheen, maar één pakket waarin HR, salarisadministratie, financiën, projecten en werving in dezelfde gegevens zitten. Voert je organisatie de financiële administratie in Twinfield, dan bouwen we daarvoor een koppeling met Twinfield.

Voor werving betekent dat iets praktisch: een aangenomen sollicitant is geen record dat je overzet naar een ander systeem, maar wordt medewerker in hetzelfde pakket. Dat is precies de reden dat organisaties die AFAS al gebruiken hun vacatures er ook in willen zetten, en niet in een los ATS ernaast.

AFAS werkt met connectoren. Een GetConnector levert gegevens uit Profit, een UpdateConnector schrijft ze weg. Welke er zijn en wat erin zit, richt je in je eigen omgeving in; ze worden daarna vrijgegeven via een app connector, die het token voor de koppeling oplevert. Daarmee is de API niet beperkt tot vacatures: met andere connectoren kan dezelfde opbouw ook een klantportaal op je administratie voeden.

Dat token gaat base64-gecodeerd mee in de Authorization-header. Bij ons staat het op de server en nooit in de paginabron, want wie het heeft kan alles wat de app connector mag.

De REST-service draait op het adres van je eigen omgeving, met je omgevingsnummer erin. Een koppeling die bij het ene bedrijf werkt wijst dus niet vanzelf naar het andere: dat adres en dat token horen in een instelling en niet in de code.

Het ophalen gaat met een GetConnector op de vacatures, met de filters en de sortering in de aanroep zelf: filterfieldids met filtervalues en een operator, en orderbyfieldids voor de volgorde. Wij bewaren het resultaat aan onze kant en verversen op een vast ritme, zodat een bezoeker niet op AFAS staat te wachten.

De sollicitatie loopt terug via de UpdateConnector HrCreateApplicant. Daarmee gaan naam en gegevens mee, plus het cv als document en desgewenst een foto en je eigen vrije velden. Gebruik je OutSite en wil je dat de sollicitant een portaalgebruiker wordt, dan zijn het privé-e-mailadres en de site verplicht; AFAS maakt die gebruiker op dat adres aan.

1. In Profit komt een GetConnector op de vacatures, met precies de velden die op de site moeten staan. Die richt elke organisatie zelf in, dus we beginnen met een lijst van wat we nodig hebben.
2. Er komt een eigen app connector voor de website. AFAS raadt aan om voor elke externe toepassing een aparte te gebruiken, zodat je er één kunt intrekken zonder de rest te raken. Met Automatisch token genereren maakt Profit de gebruikersgroep, de gebruiker en het token in één keer aan.
3. Aan die app connector koppel je de GetConnector en de UpdateConnector voor sollicitaties, en desgewenst een IP-restrictie op het adres van onze server.
4. We bouwen en testen tegen een test- of acceptatieomgeving. AFAS herkent het soort omgeving aan de beginletter: O voor productie, T voor test en A voor acceptatie. Met de metainfo van een GetConnector zien we vooraf welke velden en veldtypes erin zitten.
5. Bij de livegang zetten we het adres en het token om naar de productieomgeving. Dat staat in een instelling, zodat er aan de code niets verandert.

AFAS levert met OutSite zelf een portaal waarin je een werken-bij site kunt bouwen, gekoppeld aan InSite voor de afhandeling erachter. Dat werkt, en voor organisaties die alles binnen AFAS willen houden is het de kortste route.

Het verschil zit in wat je eromheen kunt zetten. Een vacature op je eigen site staat tussen je eigen verhaal, in je eigen ontwerp, met de rest van je site één klik weg. Dat doet bij werving meer dan bij welk onderwerp ook: wie overweegt te solliciteren gaat kijken wat voor bedrijf je bent.

Wij bouwen daarom de pagina’s op je eigen domein en gebruiken AFAS als de bron erachter. Hoe we dat voor werving aanpakken staat op de pagina over recruitment. Wil je OutSite houden voor het deel na de sollicitatie, dan kan dat gewoon naast elkaar.

Het eerste is de tijd. Een aanroep naar AFAS Online stopt na 15 minuten. Voor een vacaturelijst is dat ruim, maar een integratie die ook sollicitanten of medewerkers in één keer ophaalt, loopt ertegenaan. Met skip en take verdeel je dat over kleinere aanroepen.

Het tweede is het token. Sinds Profit 7 moet het altijd base64-gecodeerd in de header mee; een token dat als platte tekst meegaat geeft een foutmelding. Een token geldt bovendien voor één combinatie van omgeving, app connector, gebruiker en apparaat, dus een token uit de testomgeving werkt niet op productie.

Het derde is de agenda. Bestaande klassieke tokens krijgen per 15 februari 2027 een einddatum, nieuwe klassieke tokens kunnen nog tot uiterlijk 31 augustus 2027 lopen, en daarna is OAuth de route. Een app connector die 6 maanden of langer niet is gebruikt, wordt daarnaast geblokkeerd.

Op WordPress wordt elke vacature een bericht van een eigen type, met de velden uit de GetConnector als eigenschappen. Filteren op locatie, afdeling of uren werkt dan zoals de rest van de site, en de synchronisatie haalt vacatures weg die in AFAS zijn gesloten. Het sollicitatieformulier stuurt de gegevens naar de server, en die zet ze via HrCreateApplicant door naar AFAS.

Op maatwerk in Next.js bouwen we elke vacature als een vooraf gegenereerde pagina met gestructureerde data voor Google for Jobs, die op een vast ritme ververst. Dat past bij organisaties met veel vacatures en meerdere merken of vestigingen op één site.

Werk je naast AFAS met een los wervingssysteem, dan loopt de koppeling vaak via dat systeem; zie bijvoorbeeld OTYS. De bouw van de werken-bij site zelf valt onder Design & Development.