THAR
Wissenscenter/Integrationen/AFAS

Leitfaden zur AFAS-Integration

Erfahren Sie, wie Sie Mitarbeitenden- und Organisationsdaten zwischen AFAS und THAR verbinden.

Zuletzt aktualisiert: 15. Aug. 2026Lesezeit: 6 Min.

Überblick

AFAS ist eine in den Niederlanden weit verbreitete HR- und Lohnabrechnungsplattform. Mit der Integration von THAR und AFAS synchronisieren Organisationen Mitarbeitendendaten, Abteilungen und Organisationsstrukturen automatisch zwischen beiden Systemen.

Dieser Leitfaden zeigt, wie Sie die Integration einrichten, die wichtigsten Felder zuordnen, die Synchronisierungshäufigkeit konfigurieren und häufige Konfigurationsprobleme beheben – für einen reibungslosen täglichen Betrieb.

Was diese Integration leistet

  • • Automatischer Mitarbeitenden-Import: Überträgt aktive Personaldaten direkt aus AFAS in die THAR-Datenbank.
  • • Abgestimmte Organisationsstruktur: Übernimmt Abteilungen und Teams, damit Lernpfade genau zu Ihrer Organisation passen.
  • • Synchronisierung über den gesamten Lebenszyklus: Erkennt neue Profile, Austritte und Positionswechsel automatisch.
  • • Fehlervermeidung: Standardisiert die Dateneingabe und verhindert Tippfehler oder fehlende Zertifizierungsfelder.
  • • Flexible Auslöser: Läuft automatisch nach Zeitplan oder sofort über die manuelle Admin-Schaltfläche "Jetzt synchronisieren".

Voraussetzungen

Stellen Sie vor der Einrichtung sicher, dass alle Netzwerkverbindungen und Authentifizierungsdaten wie unten aufgeführt bereitstehen.

Checkliste der Voraussetzungen

  • • Eine aktive AFAS-Umgebung mit aktiviertem App-Connector-/API-Zugriff
  • • Ein THAR-Administratorkonto mit Berechtigungen für Integrationen
  • • Ihre AFAS-Token-XML mit dem generierten API-Token
  • • Eine Netzwerkverbindung zwischen Ihrer AFAS-Umgebung und den API-Endpunkten von THAR

Anleitung zur Einrichtung

1

API-Token in AFAS generieren

Melden Sie sich mit Administratorrechten in Ihrer AFAS-Profit-Umgebung an. Navigieren Sie zu Allgemein > Profit-Verwaltung > Token generieren. Achten Sie darauf, dass die passenden Berechtigungen für Benutzerprofile aktiviert sind. Kopieren Sie das generierte XML-Token – Sie benötigen es in Schritt 3.

2

Integrationseinstellungen in THAR öffnen

Öffnen Sie Ihr THAR-Portal als Administrator. Navigieren Sie im Seitenmenü zu Einstellungen > Integrationen > AFAS. Wählen Sie 'Integration konfigurieren'.

3

AFAS-Zugangsdaten eingeben

Fügen Sie Ihr AFAS-API-Token in das Token-Feld ein. Geben Sie die URL Ihrer verifizierten AFAS-Umgebung ein. Klicken Sie auf 'Verbindung testen', um die Verbindung zu prüfen.

4

Datenzuordnung konfigurieren

Ordnen Sie die relevanten Mitarbeitendendaten zu. Prüfen Sie die empfohlene Standardzuordnung und passen Sie optionale Felder wie Vertragsart, Funktion und Telefondaten an.

5

Synchronisierungsplan festlegen

Legen Sie fest, wie oft Daten aktualisiert werden: stündlich, alle vier Stunden, einmal täglich oder nur manuell bei Bedarf.

6

Integration aktivieren

Prüfen Sie alle Eingaben, gehen Sie Ihre Checkliste durch und klicken Sie auf 'Integration aktivieren'. Nach der Bestätigung startet sofort eine erste vollständige Synchronisierung.

Konfiguration

Feldzuordnungen

AFAS-Feld

THAR-Feld

Status

Medewerker naam

Name der Person

Aktiv

E-mailadres

E-Mail

Aktiv

Afdeling

Abteilung

Aktiv

Functie

Rolle / Funktion

Aktiv

Startdatum

Eintrittsdatum

Aktiv

Contracttype

Vertragsart

Optional

Empfohlene Synchronisierungshäufigkeit

Häufigkeit

Empfohlen für

Stündlich

Sehr dynamische Organisationen mit stündlich wechselnden Schichten externer Arbeitskräfte.

Alle 4 Stunden

Standardeinstellung. Erfasst Schichtwechsel am Vormittag und Nachmittag bei minimaler API-Last.

Täglich

Stabile Organisationen mit wenigen neuen Mitarbeitenden pro Woche.

Fehlerbehebung

Problem 01

Problem: Fehlermeldung 'Verbindung fehlgeschlagen' beim Testen der Verbindung.

Lösung: Prüfen Sie die Schreibweise Ihres Endpunkts und ob Ihr AFAS-App-Connector-Token widerrufen wurde. Stellen Sie außerdem sicher, dass externe Firewalls eingehenden Datenverkehr von den Produktions-IPs von THAR zulassen.

Problem 02

Problem: Mitarbeitendendaten werden nicht in die THAR-Datenbank synchronisiert.

Lösung: Prüfen Sie, ob der aktive Vertrag der Person in AFAS den Kriterien des Filterprofils entspricht. Deaktivierte, Entwurfs- oder noch nicht wirksame Verträge sind standardmäßig von der täglichen Synchronisierung ausgeschlossen.

Problem 03

Problem: Die Abteilungsstruktur stimmt nicht überein.

Lösung: Abteilungscodes müssen exakt übereinstimmen. Weicht die Struktur ab, legen Sie manuelle Zuordnungen im Advanced Fields Editor von THAR fest.

Brauchen Sie Hilfe bei der Einrichtung dieser Integration?

Sie finden keine Antwort oder haben Probleme bei der Konfiguration? Nehmen Sie Kontakt mit dem THAR-Team auf. Unsere Fachleute helfen Ihnen gern weiter.

Support kontaktieren