---
title: "Workday"
description: "Synchroniseer medewerkers uit een Workday Report-as-a-Service-rapport: de kolommen om op te nemen, de inloggegevens die Pyn nodig heeft, en hoe je Fields in Report leest."
sidebar:
  label: Overzicht
  order: 0
area: integrations
feature: workday
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: "12005093"
    title: Connect to Workday (Pyn 2)
    url: https://intercom.help/pyn/en/articles/12005093-connect-to-workday-pyn-2
    note: replaces
  - id: "6330048"
    title: Connect to Workday (Pyn 1)
    url: https://intercom.help/pyn/en/articles/6330048-connect-to-workday-pyn-1
    note: "Pyn 1 article, kept for reference"
translation:
  source: integrations/workday/index.mdx
  sourceSha: 13613badcd0a5b4a1c787d5cd57ed82a0d1c1422
---

De Workday-integratie leest een aangepast rapport dat je Workday-beheerder als service publiceert (RaaS) en houdt de Directory actueel. Je bepaalt precies wat Pyn ziet door de kolommen van het rapport te kiezen, en het tabblad **Advanced** toont welke kolommen zijn binnengekomen.

## Voordat je begint

- Je bent admin of owner in Pyn.
- Een Workday-beheerder maakt een aangepast rapport aan, schakelt het in als webservice met JSON-uitvoer, en geeft je de **Report URL** ervan, plus de **Username** en het **Password** van een integratiesysteemgebruiker die het kan draaien.
- Het rapport bevat bij voorkeur deze kolommen, gematcht op naam waarbij spaties en underscores worden genegeerd: `Employee_ID`, `WorkEmail`, `Name` of `Preferred_Name`, `Preferred_Name_First_Name`, `Business_Title`, `Hire_Date`, `Original_Hire_Date`, `Termination_Date`, `Worker_Status` of `Active_Status`, `Department_Name`, `Division`, `Business_Unit`, `Team`, `Manager_ID`, `Work_Country`, `Time_Zone` (een IANA-naam zoals `Australia/Sydney`), `Home_Email_Address` voor pre-boarding, `Birthday` (als `YYYY-MM-DD` of `MM-DD`, schuine strepen toegestaan; 29 februari blijft behouden), `Worker_Type`, `Employee_Type`, `Employment_Type`, `Time_Type` en `Exempt`.

![Connect to Workday asks for the report Username, Password and Report URL.](https://support.pyn.ai/media/integrations/workday/integrations-workday-connect.png)

## Koppelen

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

2. Selecteer de tegel **Workday RaaS**. Het dialoogvenster **Connect to Workday** opent.

3. Voer de **Username** en het **Password** in.

4. Voer de **Report URL** in. Die moet beginnen met `https://`; "That URL is not in the correct format." betekent dat dat niet zo is.

5. Selecteer **Connect**. Het dialoogvenster toont "Validating those credentials..." terwijl Pyn het rapport draait.

6. Bij succes leest een melding "Your Workday RaaS has successfully been added to Pyn. It will take a minute or two for the employee data to be pulled from Workday."

Fouten die het dialoogvenster kan tonen: "Could not verify the credentials. The username or password appear to be invalid." / "Could not verify the credentials. The supplied URL is not in the correct format." / een opmerking dat Workday een antwoord "Down for Maintenance" teruggeeft, wacht in dat geval en probeer het opnieuw / "An unexpected error occurred. Please check the details and try again. If the error persists, contact support." als het verzoek niet is aangekomen.

## Wat er wordt gesynchroniseerd

Pyn draait het rapport ongeveer één keer per uur en legt elke run vast onder **History**. **Details** toont het **Report Type** (Employee, Candidate of Evergreen), de **Username** en de **Report URL**; **Advanced** toont **Fields in Report** met een aantal per ontvangen kolom.

| Eigenschap in Pyn | Rapportkolom |
| --- | --- |
| Extern id | `Employee_ID` en `Worker_ID`; een rapport dat beide mengt, behoudt beide |
| Weergavenaam, officiële naam, roepnaam | `Name` / `Full_Name` / `Preferred_Name`, `Preferred_Name_First_Name` |
| Zakelijk e-mailadres, tweede e-mailadres, persoonlijk e-mailadres | `Work_Email`, `CF_Additional_Work_Email`, `Email_Primary_Home` / `Home_Email_Address` / `Personal_Email` |
| Startdatum, diensttijddatum, datum uit dienst | `Hire_Date`, `Original_Hire_Date`, `Termination_Date` / `Term_Date` |
| Status | `Worker_Status` (Active, On Leave of Terminated); anders `Active_Status` (1 of 0) |
| Functietitel | `Business_Title` |
| Afdeling, divisie, bedrijfsonderdeel, team | `Department_Name`, `Division` / `Division_Name`, `Business_Unit`, `Team` |
| Land, tijdzone | `Country` / `Work_Address_Country` / `Work_Country`, `Time_Zone` |
| Manager | `Manager_ID` |
| Type dienstverband | `Employment_Type` |
| Exempt, type werknemer, type medewerker, type werktijd | `Exempt`, `Worker_Type`, `Employee_Type`, `Time_Type` |
| Aangepaste kolommen | Workspace-extensies gekoppeld aan een rapportkolom |

Kolomnamen worden gematcht zonder onderscheid in hoofdletters en met underscores en spaties verwijderd, dus `Hire_Date`, `HireDate` en `Hire Date` werken allemaal. Zie [HRIS-velden](https://support.pyn.ai/nl/integrations/hris-fields/) voor de matrix.

## Testen

Open de tegel Workday onder **Installed** en zoek in **History** naar een geslaagde run; vergelijk daarna **Fields in Report** onder **Advanced** met de kolommen die je verwachtte. Open [Employees](https://support.pyn.ai/nl/directory/employees/) en controleer namen, startdatums en managers.

## Opnieuw koppelen of ontkoppelen

- **Reconnect** opent **Reconnect to Workday** met de gebruikersnaam en URL ingevuld; voer het wachtwoord in (en elke gewijzigde waarde) en selecteer **Connect**. "Your Workday RaaS has successfully been updated." bevestigt het en wist een foutstatus.
- **Deactivate** stopt het draaien van het rapport; **Activate** hervat het.

## Problemen oplossen

| Wat je ziet | Wat het betekent |
| --- | --- |
| History: "Error: Authentication failed, please reconnect" | Het wachtwoord van de integratiegebruiker is gewijzigd of het account is uitgeschakeld. Koppel opnieuw. |
| Een kolom ontbreekt onder Fields in Report | De kolom zit niet in het rapport, of de naam komt met geen enkele naam overeen die Pyn leest. Voeg de kolom toe of hernoem die in Workday. |
| Mensen ontbreken | Ze worden niet teruggegeven door de filters van het rapport; controleer `Worker_Status` of `Active_Status` en de populatie die het rapport dekt. |
| Tijdzones kloppen niet | `Time_Zone` ontbreekt, of is geen IANA-naam of Workday-zonenaam die Pyn herkent. Pyn leest voor Workday-tijdzones niets anders, dus die medewerkers krijgen de standaard van de workspace. |

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