Wie funktioniert die API Integration zwischen Staffomatic und Personio?

Das Einrichten der Schnittstelle zu Personio ist schnell gemacht, allerdings müssen in beiden Systemen Einstellungen vorgenommen werden. Hierfür benötigst Du Admin-Rechte in Personio und Staffomatic.

Was kann die Integration eigentlich?

Die Integration kann grob gesagt folgende Syncs durchführen:

  • User erstellen (Personio zu Staffomatic)
  • Abwesenheiten (in beide Richtungen)
  • Zeiterfassungen (Staffomatic zu Personio)
  • User sperren (Personio zu Staffomatic)

Näheres dazu erfährst Du bei den einzelnen Schritten der Einrichtung.

Was benötige ich für die Integration?

Natürlich benötigst Du ein Abonnement bei Personio, aber auch bei Staffomatic.

Versuche die Einrichtung möglichst innerhalb der Testphase bei Staffomatic durchzuführen.

Welches Abonnement soll es denn sein?

Wenn du Abwesenheiten synchronisieren willst, benötigst Du Basic + Abwesenheiten

Wenn du Zeiterfassungen synchronisieren willst, benötigst Du Basic + Zeiterfassung

Wenn du beides synchronisieren willst, benötigst Du Professional

Neben einem Abonnement passend zu den Daten, die Du synchronisieren möchtest, muss noch entschieden werden, wie die Integration gemanagt werden soll.

Nur ein einziger User kann die Integration in Staffomatic betreuen!

Es könnte also Sinn machen einen User in Staffomatic zu haben, den sich, sofern es mehrere Bearbeiter geben soll, diese Bearbeiter teilen können. Zum Beispiel admin@deineFirma.de.

Sollte der Hauptbearbeiter nämlich gewechselt werden müssen, ist dies nur über ein Support Ticket und ggf. mit einigen Tagen Wartezeit möglich.

Einstellungen in Personio:

1. Zunächst muss in Personio ein Credential erstellt werden. Das sind Informationen, die unsere Schnittstelle benötigt, um zu wissen, welche Accounts miteinander verbunden werden sollen.

Hier gibt es einmal die Möglichkeit, sich die beiden Informationen zu notieren und später manuell in Staffomatic einzutragen oder Du erstellst Dir eine Credentials-Datei, die später einfach in Staffomatic hochgeladen werden kann.

Bitte gehe hierfür in Personio auf Einstellungen > API -Zugriffsdaten

 

2. Der zweite Schritt ist die Definition, auf welche Informationen Zugriff über die Schnittstelle gewehrt wird. Hierfür müssen so genannte Attribute ausgewählt werden.

Folgenden Lesbare Mitarbeiterattribute müssen hier aktiv sein, ansonsten kann es zu Fehlern in der Schnittstelle kommen:

- Vorname

- Nachname

- E-Mail

- Wochenstunden

- Anstelldatum

- Urlaubstage

- letzter Arbeitstag



3. Der dritte Schritt: Kopiere deine API-Zugriffsdaten und Füge dies in der Integration bei Staffomatic ein 



WICHTIG:
Bevor Du Staffomatic mit Personio einrichtest, überarbeite Deinen Testaccount bei Staffomatic.Vorbereitung in Staffomatic:

  • Lösche alle Test-User, da diese von Personio in Staffomatic gepusht werden und hier sonst doppelte Mitarbeiter angezeigt werden können. Das System kann ggf. nicht erkennen, ob es sich um ein und dieselbe Person handelt, wenn hier etwa Email-Adressen fehlen oder eine Andere hinterlegt ist.
  • User, die unbedingt bleiben sollen (weil sie schon verplant sind), müssen die gleiche Mailadresse hinterlegt haben, wie bei Personio. Nur dann kann ein Matching stattfinden.
  • Lösche alle Abwesenheiten, die Du in Deiner Testphase erstellt hast, da sonst auch hier Abwesenheiten doppelt angelegt werden könnten. (Ausnahme: Du willst die Abwesenheiten in Staffomatic pflegen und zu Personio pushen)
  • Lösche alle Test-Timer, die Du in Deiner Testphase bei Staffomatic erstellt hast. Dadurch vermeidest Du, dass fehlerhafte Testdaten zu Personio gepusht werden.

Bitte buche Dir für die Implementierung der Schnittstelle einen Termin mit uns. Mach' es nicht alleine!

Einstellungen in Staffomatic:


1. Gehe in Staffomatic auf den Reiter Integrationen und wähle die Personio-Integration aus. Folge den Installationshinweisen.


 

2. Klicke bitte nun in die installierte Integration und starte das Setup. Das Setup besteht aus nur vier kleinen Schritten. Im ersten Schritt hast Du hier die Möglichkeit, die Credentials-Informationen einzutragen oder als Datei hochzuladen. (1. Update Personio Credentials)

3. Nun kommen wir zur Definition der Informationsquellen. (2. Select sync sources)

Die Mitarbeiterstammdaten können nur von Personio zu Staffomatic gesynct werden. Daher gibt es hier keine weitere Einstellmöglichkeit. Personio ist dabei das führende System. Möchtest Du später Mitarbeiterstammdaten ändern, muss die Änderung in Personio durchgeführt werden. Falls eine Änderung der Stammdaten in Staffomatic getätigt wird, ist diese nach spätestens 120 Min. hinfällig.

Bei dem zweiten Punkt kannst Du entscheiden, ob die Datensätze der Zeiterfassungen aus Staffomatic zu Personio gesynct werden sollen oder ob Du diese Funktionalität deaktivieren möchtest.

Der dritte Punkt definiert, aus welchem System die Abwesenheiten gepusht werden sollen. Hier hat man die Möglichkeit Personio, wie auch Staffomatic als führendes System einzustellen.

Klicke bitte nun auf Speichern und warte einen kleinen Augenblick.

Das System fragt die Mitarbeiterstammdaten über die Schnittstelle ab. Dies kann, abhängig von der Menge der Datensätze, einige Sekunden dauern.

Nun siehst Du alle User, die in Personio gefunden worden sind. Jetzt musst Du entscheiden, welche dieser Profile zu Staffomatic übertragen werden sollen. (3. Config users sync)

Der letzte Schritt ist die individuelle Feinabstimmung. Im Folgenden erkläre ich Dir die Einstellungen (4. Sync Options)

 

Enable background sync

Diese Funktion ist elementar und sollte auf Yes gestellt werden. Erst dann kann die Schnittstelle die Daten synchronisieren.

Enable personio hire date

Diese Funktion ist sinnvoll, wenn Du möchtest, dass User erst Zugang zu Staffomatic bekommen, sobald der erste Arbeitstag (hire date) erreicht ist.

Enable personio last working day

Ähnlich wie bei der Funktion oben geht es hier aber um den letzten Arbeitstag. Wenn ein Mitarbeiter Dein Unternehmen verlässt bzw. "last working day" erreicht ist, wird er automatisch geblockt und kann sich nicht mehr in Staffomatic einloggen. (Achtung: Er wird weiterhin berechnet)

Only approved staffomatic absences

Diese Einstellung greift nur, wenn Du bei Punkt 2 Select sync sources Staffomatic als führendes System für Abwesenheiten ausgewählt hast. Hier kannst Du entscheiden, ob alle Anträge zu Personio übertragen werden sollen oder nur die, die genehmigt oder abgelehnt worden sind.

Only verified staffomatic work timers

Diese Einstellung ermöglicht Dir entweder alle abgeschlossenen Datensätze aus der Zeiterfassung zu Personio zu übertragen oder nur die, die den Status Bestätigt haben. Du hast nämlich die Möglichkeit in der Auswertung der Zeiterfassung die Datensätze als Bestätigt zu markieren, wenn Du diese geprüft hast. Diese Funktion minimiert das Risiko fehlerhafte Datensätze zu Personio zu übertragen.

Invite Saffomatic User

Diese Einstellung verschickt beim ersten Sync Einladung an die E-Mail-Adressen aller User, die Du bei Punkt 3. Config User Sync auf Yes gestellt hast. Bitte stelle sicher, dass Deine Mitarbeiter darüber informiert sind und die Einladung auch annehmen. Solltest Du noch Zeit benötigen, kannst Du Deine Mitarbeiter auch noch später manuell einladen.

Die weiteren Einstellungen sind vorerst nicht wichtig für Dich und können übersprungen werden.

Bitte klicke abschließend auf Speichern. Die Schnittstelle ist eingerichtet.

Der erste Sync wird morgens oder abends stattfinden.

Abwesenheitskategorien in Staffomatic erstellen

Der letzte Schritt ist die manuelle Erstellung der Abwesenheitskategorien in Staffomatic. Hierbei ist es wichtig dasselbe Wording zu nutzen, wie in Personio.

Hier ein Beispiel: Heißt eine Abwesenheitskategorie in Personio Bezahlter Urlaub, so muss diese auch Bezahlter Urlaub in Staffomatic heißen. Nur dann kann das System die beiden Kategorien matchen.

 

FAQ

 

Werden alle Timer zu Zeitpunkt der Sync übertragen?

Je nach Einstellung (sollen nur bestätigte Timer gesynct werden?), sollten alle Timer, die zu Zeitpunkt der Sync minus einer Stunde (tendenzieller Beginn der Sync) abgeschlossen bzw. bestätigt wurden, gesynct werden.

 

Wie kann ich die Snyc auslösen?

Gar nicht. Je nach Serverkapazität findet die Sync einmal morgendlich und einmal abendlich zu unterschiedlichen Zeitpunkten statt.

 

Bis wie viele Tage in die Vergangenheit werden Daten gesynct?

An dem Tag, an dem eine Änderung in Staffomatic vorgenommen wurde, wird 7 Tage lang versucht diese Änderung nach Personio zu syncen. Mit anderen Worten, alle Änderungen in Staffomatic sollten entsprechend auch zu Personio synchronisiert werden.
Wenn Personio erstmalig eingerichtet wird, können die Daten nicht nachträglich berechnet werden.