---
title: "ADP Workforce Now"
description: "Synchroniseer medewerkers uit ADP Workforce Now met API-inloggegevens op basis van een certificaat, test de verbinding, en koppel opnieuw wanneer ADP ze vernieuwt."
sidebar:
  label: Overzicht
  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
---

De integratie met ADP Workforce Now leest werknemers via de Workers API van ADP en houdt de Directory actueel: namen, zakelijk en persoonlijk e-mailadres, datum in dienst en anciënniteitsdatum, afdeling, bedrijfsonderdeel, functieklasse, locatie, manager en datum uit dienst. Pyn leest alleen; er wordt niets naar ADP teruggeschreven.

## Voordat je begint

- Je bent admin of owner in Pyn, en ADP is ingeschakeld voor je workspace; alleen dan verschijnt de tegel onder **Available**.
- Een ADP-beheerder kan een project aanmaken in **ADP API Central** en de scope `/hr/workerInformationManagement/workerManagement/workerProfileManagement/worker.read` toevoegen. Zonder die scope authenticeert de verbinding wel, maar levert ze geen werknemers op.
- Je hebt de **Client ID** en **Client Secret** van het project, en het SSL-certificaat en de privésleutel voor het project. Het team van Pyn genereert het certificaatpaar samen met je en jij uploadt het certificaat naar het ADP-project; mail support@pynhq.com om dat te starten.
- De geboortedatum is in ADP standaard gemaskeerd. Om verjaardagen te synchroniseren maakt een ADP-beheerder het veld zichtbaar op het applicatieprofiel van de dataconnector.

![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)

## Koppelen

1. Open in Pyn **Settings** in de linkernavigatie, en dan **Available** onder **Integrations**.

2. Selecteer de tegel **ADP**. Het dialoogvenster **Connect to ADP** opent.

3. Voer de **Client ID** en **Client Secret** uit API Central in.

4. Plak het **SSL Certificate** en de **Private Key**.

5. Selecteer **Connect**. Het dialoogvenster toont "Validating those credentials..." terwijl Pyn de inloggegevens bij ADP test, wat even kan duren. Er wordt niets opgeslagen totdat ADP ze accepteert.

6. Bij succes leest een melding "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."

Meldt het dialoogvenster een fout, zoek dan de oorzaak erbij: "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." Het dialoogvenster bewaart wat je hebt ingevoerd, dus verbeter het en selecteer opnieuw **Connect**.

## Wat er wordt gesynchroniseerd

Pyn ververst ongeveer één keer per uur vanuit ADP en legt elke run vast onder **History**. Veld voor veld:

| Eigenschap in Pyn | Uit ADP |
| --- | --- |
| Weergavenaam, roepnaam, officiële naam | De voorkeursnaam wanneer die is ingesteld, anders de officiële naam |
| Zakelijk e-mailadres, persoonlijk e-mailadres | Zakelijke en persoonlijke e-mailadressen |
| Startdatum | Oorspronkelijke datum in dienst |
| Diensttijddatum | Anciënniteitsdatum |
| Datum uit dienst | Datum uit dienst |
| Status | Statuscode van de werknemer: A actief, L met verlof, T uit dienst |
| Afdeling, bedrijfsonderdeel, functieklasse, functietitel, locatie | De primaire werktoewijzing |
| Manager | De werknemer aan wie de toewijzing rapporteert |
| Verjaardag, tijdzone | Geboortedatum wanneer niet gemaskeerd; tijdzone uit land en postcode van het officiële (huis)adres, met het land van de werklocatie als terugval |
| Extern id | Worker ID en associate OID |

Werknemers zonder zakelijk én zonder persoonlijk e-mailadres verschijnen pas in de Directory zodra er een e-mailadres is. Het type werknemer wordt standaard niet overgenomen; Pyn-support kan het als aangepast veld uit de primaire werktoewijzing overnemen. Zie [HRIS-velden](https://support.pyn.ai/nl/integrations/hris-fields/) voor de volledige matrix en [Synchronisatiefrequentie en matching](https://support.pyn.ai/nl/integrations/sync-and-matching/) voor hoe medewerkers worden gematcht.

## Testen

Open de tegel ADP onder **Installed**, open het menu **...** en selecteer **Test Connection**. "Successfully tested the connection to ADP Workforce Now." bevestigt het. "An error occurred connecting to ADP Workforce Now. Please check your credentials or contact support if the issue persists." betekent dat de inloggegevens niet meer werken; koppel opnieuw. Open daarna [Employees](https://support.pyn.ai/nl/directory/employees/) en controleer namen, datums in dienst en rapportagelijnen.

## Opnieuw koppelen of ontkoppelen

- **Reconnect** (het menu **...**) opent **Reconnect to ADP** met dezelfde vier velden; voer de nieuwe inloggegevens in en selecteer **Connect**. "Your ADP Workforce Now integration has successfully been updated." bevestigt het. Pyn test de nieuwe inloggegevens eerst bij ADP; meldt het dialoogvenster een fout, dan behoudt de integratie de inloggegevens die ze had.
- **Deactivate** stopt het synchroniseren zonder de inloggegevens te verwijderen; **Activate** hervat het.

## Problemen oplossen

| Wat je ziet | Wat het betekent |
| --- | --- |
| Tegel onder **Needs Attention 🚨** en een History-regel "Error: Authentication failed, please reconnect" | ADP heeft de inloggegevens geweigerd, meestal nadat ze zijn vernieuwd. Koppel opnieuw met de nieuwe waarden. |
| Een History-regel "ADP appears to have a temporary outage" met een waarschuwingsstip | ADP gaf een serverfout of was niet bereikbaar (de verbinding liep tegen een time-out aan of viel weg). De integratie blijft actief en de volgende geplande verversing probeert het opnieuw, dus je hoeft niets te doen tenzij het blijft gebeuren. |
| De verbinding werkt, maar er verschijnen geen medewerkers | Het API-project mist de scope `worker.read`. Voeg die toe in API Central en ververs. |
| Verjaardagen ontbreken | Het veld is gemaskeerd in ADP. Maak het zichtbaar op het applicatieprofiel. |
| Sommige mensen ontbreken | Werknemers zonder zakelijk én zonder persoonlijk e-mailadres verschijnen niet in de Directory. |

## Gerelateerd

- [Integrations](https://support.pyn.ai/nl/integrations/) voor de catalogus.
- [HRIS-velden](https://support.pyn.ai/nl/integrations/hris-fields/) voor de veldenmatrix.
- [Synchronisatiefrequentie en matching](https://support.pyn.ai/nl/integrations/sync-and-matching/) voor schema's en matching.
- [Employees](https://support.pyn.ai/nl/directory/employees/) om de gesynchroniseerde records te controleren.
