Wie verbinde ich meinen Personio Account?

Voraussetzungen

Bevor du beginnst, lies bitte die folgenden Hinweise sorgfältig durch, um sicherzustellen, dass alle Voraussetzungen erfüllt sind, damit die Integration aufgesetzt werden kann:

Du hast die API-Integration bereits mit deinem Customer Success bzw. Sales Manager besprochen und lizensiert.
Du hast einen „Magik-Link“ für die Einrichtung der Schnittstelle durch deinen become.1 Ansprechpartner erhalten und hast diesen geöffnet.
Du hast „Administrator„-Berechtigungen in deiner Personio-Instanz oder ein Administrator hat seinen Zugang für dich freigegeben. Dies ist notwendig, um die API-Zugangsdaten abzurufen, wie später in diesem Leitfaden erläutert.

Einrichten der Integration

Melde dich bei eurem Personio-Konto an.
Wenn du das Zahnrad „Einstellungen“ in der unteren linken Ecke nicht sehen kannst, bedeutet dies, dass dein Konto keine Administratorrechte hat.
- - Finde heraus, wer der Administrator eures Personio-Kontos ist und bitte diesen, den Einrichtungsprozess zu übernehmen oder deinem Konto „Administrator“-Rechte zu geben.
Finden eure API-Domain
Eure API-Domäne ist dieselbe Domain, die für die Anmeldung bei Personio verwendet wird.

Öffne die Personio-Anmeldeseite, du solltest eure Domain hier sehen können.

Generiere deine API-Anmeldeinformationen

Melde dich bei deinem Personio-Konto an.
Öffne die Marktplatzseite. Du kannst dem Link in der Integrationsanleitung folgen oder den folgenden Link mit deiner eigenen Subdomain verwenden:
https://<deine subdomain>.personio.de/configuration/marketplace/connected

Gehe auf die Marktplatzseite und klicke auf „Create custom integration„.

Gib einen Namen wie bspw. „become.1″ für eure neue Verbindung ein und klicke auf „Next„.

Prüfe die benötigten Rechte im Integrations-Flow (das angezeigt Bild und der enthaltene Scope dient als Beispiel):

Bestätige die benötigten Leseberechtigungen in der Personio-Schnittstelle, darunter Arbeitnehmer, Anwesenheiten,Abwesenheiten, Org Units und rechtliche Gesellschaften:

Bestätige nun die benötigten Leserechte bezogen auf die Arbeitnehmer Attribute.

Diese Attribute sollten immer angeklickt werden:

Deutsche Bezeichnung	Englische Bezeichnung
Vorname	Firstname
Nachname	Lastname
Gesellschaft	Subcompany
Personalnummer	Personal Number
Abrechnungsrelevante Personalnummer (z.B. DATEV Personalnummer)	Payroll-relevant personnel number (e.g. DATEV personal number)
E-Mail	Email
Kostenstelle	Cost center
Status	Status
Anstellungsart	Employment type
Occupation type (bspw. Permanent employee, Working Student, Intern)	Occupation type (eg. Permanent employee, Working Student, Intern)
Employee ID	Employee ID
Arbeitszeiten	Weekly hours
Erstellt am	Created at
Anstelldatum	Hire date
Letzter Arbeitstag	Last day of work
Austrittsdatum	Termination date
Zuletzt geändert	Last modified
Position	Position
Abteilung	Department
Standort	Office
Team	Team
Füge alle relevanten benutzerderfinierten Felder hinzu	Add all your custom fields which are relevant

Klicke auf „Create Integration„.

Nun siehst du deine erstellen API-Credentials:

Kopiere die „Client ID“ und den „Client Secret“ in den Integrationsflow und klicke auf „Set up Integration“.

Wichtig: Nach dem Einrichten der Integration wird nach kurzem Laden aller Mitarbeitenden-Daten ein Filter angezeigt, mit dem ermöglicht wird nur Teile der in Personio enthaltenen Mitarbeiter zu synchronisierten, z.B. von bestimmten Entitäten oder Arbeitnehmer mit einem bestimmten Status – mehr dazu im folgenden Artikel:

https://support.become1.de/wie-nutze-ich-die-hris-integration-filter-funktion/

Dieser Filter muss bestätigt werden, damit die automatisierte Synchronisierung funktioniert. Soll der Filter nicht genutzt werden, kann er einfach ohne zusätzliche Selektionen bestätigt werden.

Geschafft – Du hast Personio erfolgreich mit become.1 verknüpft! Ab jetzt werden alle Stammdaten täglich automatisiert zwischen Personio und become.1 synchronisiert