---
title: "ADP Workforce Now"
description: "Synchronisiere Mitarbeitende aus ADP Workforce Now mit zertifikatsbasierten API-Zugangsdaten, teste die Verbindung und verbinde neu, wenn ADP sie rotiert."
sidebar:
  label: Übersicht
  order: 0
area: integrations
feature: adp
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-10"
audience: admin
related:
  - integrations
  - integrations/hris-fields
  - integrations/sync-and-matching
  - directory/employees
intercom:
  - id: "16055385"
    title: Connecting to ADP Workforce Now (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16055385-connecting-to-adp-workforce-now-pyn-2
    note: replaces
  - id: "6116909"
    title: Connecting Pyn to ADP (Pyn 1)
    url: https://intercom.help/pyn/en/articles/6116909-connecting-pyn-to-adp-pyn-1
    note: "Pyn 1 article, kept for reference"
translation:
  source: integrations/adp/index.mdx
  sourceSha: 1538dda1545788323f5959b4a659d7da70e131ee
---

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.

## Bevor du beginnst

- 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.

![Connect to ADP asks for the Client ID, Client Secret, SSL Certificate and Private Key.](https://support.pyn.ai/media/integrations/adp/integrations-adp-connect.png)

## Verbinden

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**.

## Was synchronisiert wird

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](https://support.pyn.ai/de/integrations/hris-fields/) für die vollständige Matrix und [Synchronisierungsrhythmus und Abgleich](https://support.pyn.ai/de/integrations/sync-and-matching/) dafür, wie Mitarbeitende abgeglichen werden.

## Testen

Ö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](https://support.pyn.ai/de/directory/employees/) und prüfe Namen, Einstellungsdatum und Berichtslinien.

## Neu verbinden oder trennen

- **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.

## Fehlerbehebung

| 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. |

## Verwandte Seiten

- [Integrations](https://support.pyn.ai/de/integrations/) für den Katalog.
- [HRIS-Felder](https://support.pyn.ai/de/integrations/hris-fields/) für die Feldmatrix.
- [Synchronisierungsrhythmus und Abgleich](https://support.pyn.ai/de/integrations/sync-and-matching/) für Zeitpläne und Abgleich.
- [Employees](https://support.pyn.ai/de/directory/employees/), um die synchronisierten Datensätze zu prüfen.
