ADP Workforce Now
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
Section titled “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.readtoevoegen. 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.

Koppelen
Section titled “Koppelen”-
Open in Pyn Settings in de linkernavigatie, en dan Available onder Integrations.
-
Selecteer de tegel ADP. Het dialoogvenster Connect to ADP opent.
-
Voer de Client ID en Client Secret uit API Central in.
-
Plak het SSL Certificate en de Private Key.
-
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.
-
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
Section titled “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 voor de volledige matrix en Synchronisatiefrequentie en matching voor hoe medewerkers worden gematcht.
Testen
Section titled “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 en controleer namen, datums in dienst en rapportagelijnen.
Opnieuw koppelen of ontkoppelen
Section titled “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
Section titled “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
Section titled “Gerelateerd”- Integrations voor de catalogus.
- HRIS-velden voor de veldenmatrix.
- Synchronisatiefrequentie en matching voor schema’s en matching.
- Employees om de gesynchroniseerde records te controleren.