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.


1. Was kann die Integration eigentlich?

2. Was benötige ich für die Integration?

3. Welches Abonnement soll es sein?

4. Einstellungen in Personio

5. Einstellungen in Staffomatic

6. Abwesenheitskategorien in Staffomatic erstellen

7. FAQ

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 mehrere Schritte möglich.
Hierfür muss die Einstellung Enable background sync, welche bei den Einstellungen zur API zu finden ist (siehe unten) beim derzeitigen verantwortlichen Admin deaktiviert und bei dem neuen verantwortlichen Admin aktiviert werden. 

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.
Bitte klicke hierfür in Personio auf "Neue Zugriffsdaten generieren" und fülle die Felder aus.


Insgesamt 11 Lesbare Mitarbeiterattribute > Erforderliche Attribute müssen hier aktiv sein, ansonsten kann es zu Fehlern in der Schnittstelle kommen:


- Abteilung
- Anstelldatum
- E-Mail
- Gesellschaft
- Letzter Arbeitstag
- Nachname
- Standort
- Team
- Urlaubstage
- Vorname
- Wochenstunden



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!

  • 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.
Nutze hierzu einfach den folgenden Link:

https://meetings.staffomatic.com/meetings/pawel/personio

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.


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

Die Mitarbeiter-Stammdaten 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 beim nächsten Sync sichtbar.

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.

Bei den Punkten zwei und drei handelt es sich um eine bidirektionale Synchronisations-Einstellung. Hier muss somit ein System ausgewählt werden.

Klicke bitte nun auf Speichern und warte einen kleinen Augenblick.

Das System fragt die Mitarbeiter-Stammdaten ü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)

Wenn ein User-Profil nachträglich angelegt und synchronisiert werden soll, muss unter Punkt "3. Config user sync" die Datensynchronisation immer aktiviert werden d.h. der neue User muss auf "Yes" gestellt werden. 

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 gesperrt 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 und 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

Wie starte ich die Integration in Staffomatic?

Um die Schnittstelle starten zu können müssen nach jedem Logout aus dem ganzen Account die folgenden Schritte durchgeführt werden um die Schnittstelle neu zu installieren:

1) Klicke auf den Reiter "Integration"
2) Klicke bei der Personio-Schnittstelle auf den Button "Mehr Optionen" > "Integration entfernen"
Nun springt die API etwas nach unten. Scroll einfach bitte etwas runter.
3) Klicke dann bitte nochmal auf den Button "Mehr Optionen" > "Integration installieren" > "Installieren"
4) Zum Schluss muss dann nur noch mal auf den Blauen Button " Staffomatic <> Personio Sync" geklickt werden.


Werden alle Timer zum 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.

Werden nachträgliche Änderungen synchronisiert?

Grundsätzlich gilt: Ja Änderungen werden gepushed. 
Wird ein Datensatz (Abwesenheit oder Zeiterfassung) geändert, wird dieser als neuer Datensatz erkannt und beim nächsten Sync erneut gepushed.

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.
Grund hierfür ist die Verknüpfung mit Personio. Durch jeden Sync wird eine Server-Verbindung zu Personio herstellt, die dazu beiträgt, dass die Datenlage bei Personio unterbricht. Dementsprechend sind wir von Peronio angehalten worden den Sync nur auf 2x täglich zu beschränken.


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.

Werden im Protokoll der API alle Timer und Abwesenheiten angezeigt?

Im Protokoll zu den Timern und Abwesenheiten der API von Staffomatic werden nur die letzten zwei Monate angezeigt.

Wird eine Abwesenheit inkl. Status (bestätigt/unbestätigt) synchronisiert? 

Wird eine Abwesenheit von Personio zu Staffomatic synchronisiert, so muss diese nachträglich manuell in Staffomatic bestätigt werden.