Erstellen Sie die Verbindungsdaten in Personio (Punkte 1-5) und tragen diese in diese dann in PACS ein (Punkt 6).
So richten Sie die Verbindung ein
1. Melden Sie sich bei Personio an.
Hinweise vorab:
- Prüfen Sie, welches Personio-Abo Sie momentan haben. Nach unserem Kenntnisstand benötigen das Abo "Core Pro", um die erforderlichen API Credentials in Personio zu erstellen (Abo "Core Plan" bietet diese Möglichkeit nicht).
- Personio hat zuletzt die Oberflächen komplett überarbeitet. Versionsbedingt können die für Sie ersichtlichen Oberflächen von den hier dargestellten abweichen.
Klicken Sie links unten auf den Button 'Settings'.
2. Scrollen Sie bis zum Block "Integrations" und klicken auf 'API Credentials'.
3. Klicken Sie dann auf den Button 'Generate new credential' (oder nutzen die existierenden Credentials).
4. Füllen Sie die Felder "Create New Credentials" aus:
Wichtig: Der von Personio erstellte Schlüssel beinhaltet alle vorgenommenen Definitionen für 'Personal Date' und für 'Employee Attributes'. Der Schlüssel steuert die Read- und Write-Rechte der Schnittstelle. Wenn nicht alle relevanten Daten für einen Schlüssel ausgewählt wurden, kann es beim Austausch von Daten zwischen den Systemen und deren Anzeige im anderen System zu Fehlern (zur Nichtanzeige) kommen.
- Name: Diesen können Sie frei definieren (Beispiel: PACS Schnittstelle).
- Personal Data:
- Read: PACS übernimmt/importiert Daten von Personio (keine Änderung von Daten in Personio).
- Write: PACS Daten werden nach Personio übertragen/exportiert (Änderung von Daten in Personio).
- Auswahl der Mitarbeiter/Employees: Es ist nur der Haken bei 'Read' notwendig. Es werden keine PACS Kontaktdaten nach Personio übertragen (keine Änderung in Personio).
- Zusätzliche Eingaben bei „Readable employee attributes“: Mehr Informationen finden Sie weiter unten.
- Attendances (PACS ANwesenheiten: Eintrag von Kommen-Gehen-Pause):
- Read: Wenn Personio das führende System ist und Daten von PACS nur übernommen/importiert werden sollen.
- Write: Wenn PACS das führende System ist und Daten an Personio übertragen/exportiert werden sollen.
- Die Auswahl „Read“ und/oder „Write“ muss korrespondieren mit der von Ihnen gewünschten Nutzung der Schnittstelle. Und muss damit auch mit der PACS System-Einstellung zum führenden System übereinstimmen. Sie legen dies unter SYSTEM-KONFIGURATION | SCHNITTSTELLEN & INTEGRATION | PERSONIO im Block "Führendes System bei der Synchronisation von ANwesenheiten" fest. Wählen Sie hier Personio oder PACS.
- Wenn keine Anwesenheiten synchronisiert werden sollen, bitte keinen Haken bei "Read" oder "Write" setzen.
- Absences (PACS ABwesenheiten: Eintrag von Urlaub, Krankheit, Mutterschutz etc.)
- Read: Wenn Personio das führende System ist und Daten von PACS nur übernommen/importiert werden sollen.
- Write: Wenn PACS das führende System ist und Daten an Personio übertragen/exportiert werden sollen.
- Die Auswahl „Read“ und/oder „Write“ muss korrespondieren mit der von Ihnen gewünschten Nutzung der Schnittstelle. Und muss damit auch mit der PACS System-Einstellung zum führenden System übereinstimmen. Sie legen dies unter SYSTEM-KONFIGURATION | SCHNITTSTELLEN & INTEGRATION | PERSONIO im Block "Führendes System bei der Synchronisation von ABwesenheiten" fest. Wählen Sie hier Personio oder PACS.
- Wenn keine Abwesenheiten synchronisiert werden sollen, bitte keinen Haken bei "Read" oder "Write" setzen.
- „Readable employee attributes“
- Es stehen Ihnen 62 verschiedene Attribute zur Verfügung (Stand: September 2023).
- Wählen Sie davon die folgenden 9 Attribute aus: Diese Felder werden beim Übertrag in die PACS Felder übernommen und eintragen. Die Attribute können aber auch als Filter für die Auswahl relevant sein.
- Klicken Sie dann auf "Generate New Credential".
5. Die neuen 'API credentials (client ID and secret)' werden angezeigt. Klicken Sie auf "Save".
- Anschließend müssen Sie bei den Felder 'Your client ID' und 'Your secret' auf den Copy-Button klicken und die Daten in PACS eintragen.
6. PACS Rich Client: Melden Sie sich als Key User an und gehen in dem Bereich Einstellungen zu SYSTEM-KONFIGURATION | SCHNITTSTELLEN & INTEGRATION | PERSONIO
Tragen Sie im angezeigten Fenster die API Credentials ein:
- API URL: https://api.personio.de/v1 - Klicken Sie hier auf den Button um die Standard URL einzutragen.
- Client_Id: Diese kommt aus Personio, siehe Beschreibung oben.
- Client_secret: Diese kommt aus Personio, siehe Beschreibung oben.
Weiter zu: Schritt 2: Personio - Mitarbeiter-Stammdaten aus Personio in PACS übernehmen