KoppelingenAFAS
AFAS koppelen aan je website.
AFAS is de Nederlandse bedrijfssoftware waarin ruim veertienduizend organisaties hun HR, salaris, financiën en projecten bijhouden. Wij halen de vacatures uit Profit naar je eigen werken-bij pagina’s en laten de sollicitatie terugkomen in AFAS, zodat je recruiters in één systeem blijven werken.
Vertrouwd door
200+ bedrijven en webshops
Wat het oplevert
Wat een koppeling met AFAS je oplevert.
Vacatures zonder overtypen. Wat in Profit openstaat staat op je site, en wat daar dichtgaat verdwijnt vanzelf.
Een eigen pagina per vacature. Op je eigen domein, geschikt voor Google for Jobs en om een advertentie naartoe te sturen.
De sollicitatie komt binnen in AFAS. Met het cv erbij, en hij start meteen de workflow die aan de vacature hangt.
Technisch
De koppeling in het kort.
- Vorm van de koppeling
- De Profit REST Services op je eigen AFAS-omgeving, met GetConnectors om gegevens op te halen en UpdateConnectors om ze weg te schrijven. JSON, en er is een oudere SOAP-variant met XML
- Authenticatie
- Een token uit een app connector in je eigen omgeving, base64 in de Authorization-header als AfasToken. Toegang is per connector te beperken, en met een IP-lijst in CIDR-notatie
- Richting
- Beide kanten op
- Verversing
- Per aanroep, met skip en take om te pagineren
- Wij bouwen het op
- WordPress, Next.js, Maatwerk
Waar het misgaat
- De app connector wordt in jouw AFAS-omgeving ingericht, niet bij ons. Daar hangt aan welke GetConnectors en UpdateConnectors hij mag gebruiken. Staat de connector die wij nodig hebben er niet bij, dan krijgt de site geen gegevens en zegt de melding daar weinig zinnigs over. Dit is de eerste plek om te kijken als er niets binnenkomt, en meteen de reden dat we bij de start om een beheerder bij jullie vragen.
- Er zit een grens aan hoeveel je in één keer ophaalt. AFAS rekent met kolommen maal records onder de 150.000; ga je daaroverheen, dan loopt de aanroep vast op een melding over stringspace. Voor een vacaturelijst is dat ruim, maar het betekent dat we pagineren met skip en take en de gegevens aan onze kant bewaren in plaats van bij elke bezoeker op te halen.
- Een sollicitatie maakt niet meteen een sollicitant aan. De UpdateConnector HrCreateApplicant start een workflow, en die workflow moet in de eigenschappen van de vacature zijn gekoppeld. Is dat niet gebeurd, dan komt de sollicitatie wel binnen en gebeurt er verder niets. Die connector kan bovendien alleen toevoegen: wijzigen en verwijderen gaan er niet mee.
- De manier van aanmelden verandert. AFAS zet OAuth neer als de standaard, kondigt mTLS-certificaten aan voor eind 2026, en geeft de klassieke tokens per 15 februari 2027 een vervaldatum. Een koppeling die nu op een token draait blijft dus werken, maar er komt een moment waarop hij moet worden omgezet. Zet dat in de agenda in plaats van het te ontdekken als de vacatures op een ochtend weg zijn.
AFAS koppelen
Wat je moet weten voor je begint.
Wat is AFAS?
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.
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.
Hoe de koppeling met je website werkt
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.
Dat token gaat base64-gecodeerd mee in de Authorization-header. Bij ons staat hij op de server en nooit in de paginabron, want wie hem 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.
Vacatures ophalen en sollicitaties terugsturen
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.
OutSite, of je eigen site
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. Wil je OutSite houden voor het deel na de sollicitatie, dan kan dat gewoon naast elkaar.
Bijgewerkt op
Specialist voor koppelingen
JosDesign & Development085 83 30 533jos@klubb.nlVeelgestelde vragen
Kan ik mijn vacatures uit AFAS op mijn eigen website zetten?
Ja. De vacatures komen via een GetConnector uit Profit en krijgen bij ons een eigen pagina op je eigen domein, met gestructureerde data zodat ze in Google for Jobs kunnen verschijnen.
Komt een sollicitatie vanaf mijn site terug in AFAS?
Ja, via de UpdateConnector HrCreateApplicant, met het cv erbij. Let op dat er een workflow aan de vacature gekoppeld moet zijn: zonder die koppeling komt de sollicitatie wel binnen, maar gebeurt er verder niets mee.
Wat moeten wij zelf in AFAS regelen?
Een app connector met de juiste GetConnectors en UpdateConnectors eraan, en het token dat daaruit komt. Dat is werk van een AFAS-beheerder in jullie eigen omgeving; wij leveren de lijst met wat we nodig hebben.
Is een AFAS-koppeling veilig?
Het token staat bij ons op de server en nooit in de paginabron. Je kunt per app connector bepalen welke connectoren hij mag gebruiken en de toegang beperken tot vaste IP-adressen. AFAS zet daarnaast OAuth neer als nieuwe standaard.
Moeten wij iets doen voor 15 februari 2027?
AFAS geeft de klassieke tokens vanaf die datum een vervaldatum. Een bestaande koppeling blijft werken, maar er komt een moment waarop hij moet worden omgezet naar de nieuwe manier van aanmelden. Wij houden dat bij voor de koppelingen die wij beheren.
Werkt een AFAS-koppeling ook op WordPress?
Ja. De vacatures slaan we op als eigen berichttype, zodat overzicht, filters en losse pagina’s werken zoals de rest van je site. De aanroepen naar AFAS lopen vanaf de server, zodat het token niet in de paginabron staat.
Let’s work together.
Vacatures op je eigen domein, sollicitaties in AFAS.