THAR
Kenniscentrum/Integraties/AFAS

Handleiding AFAS-integratie

Lees hoe je medewerker- en organisatiegegevens koppelt tussen AFAS en THAR.

Laatst bijgewerkt: 15 aug 2026Leestijd: 6 min

Overzicht

AFAS is een veelgebruikt HR- en salarisplatform in Nederland. Met de koppeling tussen THAR en AFAS synchroniseren organisaties automatisch medewerkergegevens, afdelingen en de organisatiestructuur tussen beide systemen.

In deze handleiding lees je hoe je de koppeling instelt, de belangrijkste velden koppelt, de synchronisatiefrequentie configureert en veelvoorkomende configuratieproblemen oplost, zodat alles dagelijks soepel verloopt.

Wat deze integratie doet

  • • Automatische import van medewerkers: Haalt actieve personeelsgegevens rechtstreeks uit AFAS naar de THAR-database.
  • • Organisatiestructuur gelijk: Neemt afdelingen en teams over, zodat leerpaden precies aansluiten op je organisatie.
  • • Synchronisatie door de hele levenscyclus: Signaleert automatisch nieuwe profielen, vertrekkers en functiewijzigingen.
  • • Minder fouten: Standaardiseert de invoer van gegevens en voorkomt typefouten of ontbrekende certificeringsvelden.
  • • Flexibel starten: Draait automatisch volgens schema of direct via de handmatige knop "Nu synchroniseren" voor beheerders.

Vereisten

Zorg er vóór de installatie voor dat alle netwerkverbindingen en authenticatiegegevens zijn geregeld zoals hieronder beschreven.

Checklist vooraf

  • • Een actieve AFAS-omgeving met App Connector / API-toegang ingeschakeld
  • • Een THAR-beheerdersaccount met rechten voor integraties
  • • Je AFAS-token-XML met het gegenereerde API-token
  • • Een netwerkverbinding tussen je AFAS-omgeving en de API-endpoints van THAR

Installatie-instructies

1

Genereer een API-token in AFAS

Log in op je AFAS Profit-omgeving met beheerdersrechten. Ga naar Algemeen > Beheer Profit > Token genereren. Zorg dat de juiste rechten voor gebruikersprofielen zijn aangevinkt. Kopieer het gegenereerde XML-token — je hebt het nodig in stap 3.

2

Open de integratie-instellingen in THAR

Open je THAR-portaal als beheerder. Ga in het zijmenu naar Instellingen > Integraties > AFAS. Kies 'Integratie configureren'.

3

Vul je AFAS-gegevens in

Plak je AFAS API-token in het tokenveld. Vul de URL van je geverifieerde AFAS-omgeving in. Klik op 'Verbinding testen' om de verbinding te controleren.

4

Stel de veldkoppeling in

Koppel de relevante medewerkergegevens. Bekijk de aanbevolen standaardkoppeling en pas optionele velden aan, zoals contracttype, functie en telefoongegevens.

5

Stel het synchronisatieschema in

Bepaal hoe vaak gegevens worden bijgewerkt: elk uur, elke vier uur, eenmaal per dag of alleen handmatig op verzoek.

6

Activeer de integratie

Controleer alle invoer, loop je checklist na en klik op 'Integratie activeren'. Na bevestiging start direct een eerste volledige synchronisatie.

Configuratie

Veldkoppelingen

AFAS-veld

THAR-veld

Status

Medewerker naam

Naam medewerker

Actief

E-mailadres

E-mail

Actief

Afdeling

Afdeling

Actief

Functie

Rol / functie

Actief

Startdatum

Startdatum

Actief

Contracttype

Contracttype

Optioneel

Aanbevolen synchronisatiefrequentie

Frequentie

Aanbevolen voor

Elk uur

Zeer dynamische organisaties met elk uur meerdere wisselende diensten van inhuurkrachten.

Elke 4 uur

Standaardinstelling. Vangt roosterwijzigingen in de ochtend en middag op met minimale API-belasting.

Dagelijks

Stabiele organisaties waar per week weinig nieuwe medewerkers instromen.

Problemen oplossen

Probleem 01

Probleem: foutmelding 'Verbinding mislukt' bij het testen van de verbinding.

Oplossing: Controleer de schrijfwijze van je endpoint en of je AFAS App Connector-token niet is ingetrokken. Controleer ook of externe firewalls inkomend verkeer van de productie-IP's van THAR toestaan.

Probleem 02

Probleem: medewerkergegevens worden niet gesynchroniseerd naar de THAR-database.

Oplossing: Controleer of het actieve contract van de medewerker in AFAS voldoet aan de criteria van het filterprofiel. Gedeactiveerde, concept- of nog niet ingegane contracten worden standaard niet meegenomen in de dagelijkse synchronisatie.

Probleem 03

Probleem: afdelingsindeling komt niet overeen.

Oplossing: Afdelingscodes moeten exact overeenkomen. Wijkt de structuur af, leg dan handmatige vertalingen vast in de Advanced Fields Editor van THAR.

Hulp nodig bij het instellen van deze integratie?

Vind je het antwoord niet of loop je tegen configuratieproblemen aan? Neem contact op met het THAR-team. Onze specialisten helpen je graag verder.

Neem contact op