Zum Inhalt springen
PynPyn

ADP Workforce Now

Die Integration mit ADP Workforce Now liest Worker über ADPs Workers API und hält das Directory aktuell: Namen, geschäftliche und private E-Mail, Einstellungs- und Senioritätsdatum, Abteilung, Geschäftsbereich, Jobklasse, Standort, Führungskraft und Austrittsdatum. Pyn liest nur; nichts wird nach ADP zurückgeschrieben.

  • Du bist Admin oder Owner in Pyn, und ADP ist für deinen Workspace aktiviert; nur dann erscheint die Kachel unter Available.
  • Ein ADP-Administrator kann in ADP API Central ein Projekt erstellen und den Scope /hr/workerInformationManagement/workerManagement/workerProfileManagement/worker.read hinzufügen. Ohne ihn authentifiziert sich die Verbindung, liefert aber keine Worker.
  • Du hast Client ID und Client Secret des Projekts sowie das SSL-Zertifikat und den privaten Schlüssel dafür. Pyns Team erzeugt das Zertifikatspaar mit dir, und du lädst das Zertifikat ins ADP-Projekt hoch; wende dich an support@pynhq.com, um damit zu starten.
  • Das Geburtsdatum ist in ADP standardmäßig maskiert. Um Geburtstage zu synchronisieren, gibt ein ADP-Administrator das Feld im Anwendungsprofil des Datenkonnektors frei.
The Connect to ADP dialog with its four credential fields.
Connect to ADP asks for the Client ID, Client Secret, SSL Certificate and Private Key.
  1. Öffne in Pyn Settings in der linken Navigation, dann Available unter Integrations.

  2. Wähle die Kachel ADP. Der Dialog Connect to ADP öffnet sich.

  3. Gib Client ID und Client Secret aus API Central ein.

  4. Füge SSL Certificate und Private Key ein.

  5. Wähle Connect. Der Dialog zeigt „Validating those credentials…“, während Pyn die Zugangsdaten bei ADP testet, was einen Moment dauern kann. Gespeichert wird nichts, bis ADP sie akzeptiert.

  6. Bei Erfolg lautet die Meldung „Your ADP Workforce Now integration has successfully been added to Pyn. It will take a minute or two for the employee data to be pulled from ADP.“

Meldet der Dialog einen Fehler, ordne ihn der Ursache zu: „Could not verify the credentials. The Client ID or Client Secret appear to be invalid.“ / „The SSL certificate appears to be invalid. Please check the certificate and try again.“ / „ADP is returning an error. Please try again later.“ / „An unexpected error occurred. Please check the details and try again. If the error persists, contact support.“ Der Dialog behält deine Eingaben, korrigiere sie also und wähle erneut Connect.

Pyn aktualisiert etwa einmal pro Stunde aus ADP und protokolliert jeden Lauf unter History. Feld für Feld:

Pyn-Eigenschaft Aus ADP
Anzeigename, Rufname, rechtlicher Name Rufname, wenn gesetzt, sonst der rechtliche Name
Geschäftliche E-Mail, private E-Mail Geschäftliche und private E-Mail-Adressen
Startdatum Ursprüngliches Einstellungsdatum
Betriebszugehörigkeitsdatum Senioritätsdatum
Austrittsdatum Austrittsdatum
Status Worker-Statuscode: A aktiv, L beurlaubt, T ausgeschieden
Abteilung, Geschäftsbereich, Jobklasse, Jobtitel, Standort Die primäre Arbeitszuweisung
Führungskraft Der Reports-to-Worker der Zuweisung
Geburtstag, Zeitzone Geburtsdatum, wenn nicht maskiert; Zeitzone aus Land und Postleitzahl der rechtlichen (privaten) Adresse, ersatzweise aus dem Land des Arbeitsstandorts
Externe ID Worker ID und Associate OID

Worker ohne geschäftliche und ohne private E-Mail erscheinen erst im Directory, wenn eine E-Mail-Adresse eintrifft. Der Worker-Typ wird standardmäßig nicht abgebildet; der Pyn-Support kann ihn aus der primären Arbeitszuweisung als eigenes Feld abbilden. Siehe HRIS-Felder für die vollständige Matrix und Synchronisierungsrhythmus und Abgleich dafür, wie Mitarbeitende abgeglichen werden.

Öffne die Kachel ADP unter Installed, öffne das Menü … und wähle Test Connection. „Successfully tested the connection to ADP Workforce Now.“ bestätigt es. „An error occurred connecting to ADP Workforce Now. Please check your credentials or contact support if the issue persists.“ heißt, die Zugangsdaten funktionieren nicht mehr; verbinde neu. Öffne dann Employees und prüfe Namen, Einstellungsdatum und Berichtslinien.

  • Reconnect (im Menü …) öffnet Reconnect to ADP mit denselben vier Feldern; gib die neuen Zugangsdaten ein und wähle Connect. „Your ADP Workforce Now integration has successfully been updated.“ bestätigt es. Pyn testet die neuen Zugangsdaten zuerst bei ADP; meldet der Dialog einen Fehler, behält die Integration ihre bisherigen Zugangsdaten.
  • Deactivate stoppt die Synchronisierung, ohne die Zugangsdaten zu entfernen; Activate setzt sie fort.
Was du siehst Was es bedeutet
Kachel unter Needs Attention 🚨 und ein History-Eintrag „Error: Authentication failed, please reconnect“ ADP hat die Zugangsdaten abgelehnt, meist nach einer Rotation. Verbinde mit den neuen Werten neu.
Ein History-Eintrag „ADP appears to have a temporary outage“ mit einem Warnpunkt ADP hat einen Serverfehler zurückgegeben oder war nicht erreichbar (die Verbindung hat das Zeitlimit überschritten oder ist abgebrochen). Die Integration bleibt aktiv, und die nächste geplante Aktualisierung versucht es erneut; es gibt also nichts zu tun, es sei denn, das passiert immer wieder.
Verbindung funktioniert, aber keine Mitarbeitenden erscheinen Dem API-Projekt fehlt der Scope worker.read. Füge ihn in API Central hinzu und aktualisiere.
Geburtstage fehlen Das Feld ist in ADP maskiert. Gib es im Anwendungsprofil frei.
Manche Personen fehlen Worker ohne geschäftliche und ohne private E-Mail erscheinen nicht im Directory.