> For the complete documentation index, see [llms.txt](https://hub.equipme.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.equipme.io/pro/dokumentation/operations/hr-sync.md).

# HR-Sync

HR-Sync aus Provider-Sicht: Status der HR-Synchronisierungen aller Kunden prüfen, Spalten und Status verstehen und wissen, wo die Integration eingerichtet wird.

**Pfad:** „Operations“ → „HR-Sync“

Mit dem **HR-Sync** übernehmen deine Kunden ihre Mitarbeiterdaten automatisch aus ihrem HR-System nach equipme. Neue Mitarbeiter, Austritte und Änderungen kommen so ohne manuelle Pflege an. Das ist die Grundlage für automatisches On- und Offboarding.

In Pro siehst du auf einen Blick, bei welchen Kunden eine HR-Synchronisierung läuft und ob sie funktioniert: „Hier kannst du die HR-Synchronisierungen deiner Kunden einsehen und deren Status kontrollieren. Die Daten werden standardmäßig alle 3 Stunden synchronisiert.“

## Die Übersicht

| Spalte                        | Inhalt                                                          |
| ----------------------------- | --------------------------------------------------------------- |
| „Kunde“                       | Der Kunde, dem die Integration gehört                           |
| „Integration“                 | Das angebundene HR-System des Kunden                            |
| „Status“                      | Zustand der Integration (siehe unten)                           |
| „Erstellt“                    | Wann die Integration eingerichtet wurde                         |
| „Letzte Synchronisierung“     | Zeitpunkt des letzten Abgleichs                                 |
| „Synchronisierte Mitarbeiter“ | Anzahl der Mitarbeiter, die aus dem HR-System übernommen werden |

Gibt es noch keine Integration, steht dort „Bisher wurde keine Integration eingerichtet.“

### Status

| Status             | Bedeutung                                        | Was zu tun ist                        |
| ------------------ | ------------------------------------------------ | ------------------------------------- |
| „Aktiv“            | Die Integration synchronisiert regelmäßig.       | Nichts                                |
| „Synchronisierend“ | Ein Abgleich läuft gerade.                       | Abwarten                              |
| „Inaktiv“          | Die Integration ist eingerichtet, aber pausiert. | Im Kundenportal aktivieren            |
| „Invalid“          | Zugangsdaten fehlen oder sind fehlerhaft.        | Zugangsdaten im Kundenportal erneuern |

{% hint style="warning" %}
Beim Erneuern der Zugangsdaten muss derselbe Tenant des HR-Systems verbunden werden wie zuvor. Soll ein anderer Tenant angebunden werden, wird die Integration gelöscht und neu angelegt.
{% endhint %}

## HR-Sync für einen Kunden einrichten

Die Seite in Pro ist eine reine Übersicht. Eingerichtet und verwaltet wird die Integration im Kundenportal des jeweiligen Kunden:

1. In den [Kundendetails](/pro/dokumentation/customers/customer-details.md) unter „Premium Features (lizenzpflichtig)“ die Option „HR-Sync freischalten“ aktivieren.
2. In das Kundenportal des Kunden wechseln und dort in den Integrationseinstellungen die HR-Integration hinzufügen, Filter und Einstellungen festlegen und aktivieren.

Pro Kunde ist genau eine HR-Integration möglich. Die Schritte im Kundenportal (Integration hinzufügen, Filter, Feldzuordnung, Aktivieren, Synchronisieren, Löschen) beschreibt das Kundenhandbuch unter „HR-Sync“.

## Berechtigung

Die Seite sehen nur Benutzer mit der Rolle „Administrator“.

## Häufige Fragen

**Wie oft werden die Daten abgeglichen?**

Standardmäßig alle 3 Stunden. Einen sofortigen Abgleich startest du im Kundenportal.

**Ein Kunde meldet fehlende Mitarbeiter. Wo fange ich an?**

Prüfe hier „Status“ und „Letzte Synchronisierung“. Ist die Integration „Invalid“ oder liegt die letzte Synchronisierung lange zurück, müssen die Zugangsdaten im Kundenportal erneuert werden. Ist sie „Aktiv“, prüfe die Filter der Integration im Kundenportal.

**Kann ich den HR-Sync direkt in Pro einrichten?**

Nein. Pro zeigt nur den Status. Einrichten, ändern und löschen erfolgt im Kundenportal des Kunden.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://hub.equipme.io/pro/dokumentation/operations/hr-sync.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
