---
title: "Eigenschappen van medewerkers"
description: "Elk veld van een medewerker, de relaties tussen medewerkers, de externe id's die een profiel aan zijn bronnen koppelen, hoe de lifecyclefase wordt bepaald en hoe een tijdzone wordt afgeleid."
sidebar:
  order: 3
area: directory
feature: employees
appPath: /directory/home
lastVerified: 2026-11-15
version: "2026-11-03"
audience: admin
related:
  - directory/employees/fix-missing-details
  - directory/employees/upload-employees-from-a-spreadsheet
  - directory/employee-groups/reference-group-types
intercom:
  - id: "6024089"
    title: "How does Pyn determine a message recipient's time zone?"
    url: https://intercom.help/pyn/en/articles/6024089-how-does-pyn-determine-a-message-recipient-s-time-zone
    note: draws on
translation:
  source: directory/employees/reference-employee-properties.mdx
  sourceSha: 26c518f755f0f65bd8a7a9d1ee1045b6b8884d0a
---

Een medewerkersprofiel is een vaste set eigenschappen plus de aangepaste velden die je HRIS toevoegt. De sleutel in de eerste kolom is de naam die een token gebruikt; waar **Uploadkolom** Ja zegt, is het ook de kop die een Employee File-upload leest.

## Eigenschappen

| Sleutel | Label | Uploadkolom | Opmerkingen |
| --- | --- | --- | --- |
| `displayName` | Display Name | Ja | De volledige naam die overal wordt getoond. |
| `preferredName` | Preferred Name | Ja | Gebruikt door tokens zoals de voornaam in een begroeting. |
| `legalName` | Legal Name | Ja | Voor documenten. |
| `jobTitle` | Job Title | Ja | |
| `primaryEmail` | Primary Email Address | Ja, verplicht | Het werkadres waar berichten naartoe gaan. |
| `personalEmail` | Personal Email Address | Ja | Cursief getoond in lijsten wanneer er geen werkadres is. |
| `secondaryEmail` | Secondary Email Address | Ja | |
| `avatarUri` | Avatar Image | Ja | Een URL. Initialen worden getoond wanneer het leeg is. |
| `startDate` | Start Date | Ja | Meest recente of aankomende start. `yyyy-MM-dd` of `yyyy/MM/dd`. Stuurt de Onboarding- en jubileumtriggers en de weergave Upcoming aan. |
| `terminationDate` | Termination Date | Ja | `yyyy-MM-dd` of `yyyy/MM/dd`. |
| `tenureDate` | Tenure Date | Ja | Oorspronkelijke start voor anciënniteit, wanneer die afwijkt van Start Date. `yyyy-MM-dd` of `yyyy/MM/dd`. |
| `probationEndDate` | Probation End Date | Nee | Alleen getoond wanneer een bron het aanlevert. |
| `birthday` | Birthday | Ja | `MM-dd` op het profiel; een upload accepteert ook `dd/MM`, `yyyy-MM-dd` en een ISO 8601-datum-tijd. |
| `businessUnit`, `department`, `division`, `location`, `team` | Business Unit, Department, Division, Location, Team | Ja | Vrije tekst. Department, Division, Location en Country zijn vanaf het begin demografieën. |
| `employmentType` | Employment Type | Nee | Vrije tekst zoals Full-Time of Contractor, uit je HRIS. Vanaf het begin een demografie. |
| `jobClass` | Job Class | Nee | Vrije tekst uit ADP; kan een demografie worden. |
| `country` | Primary Country | Ja | ISO-code op het profiel; een upload accepteert een naam. |
| `postalCode` | Postal Code | Ja | Gebruikt om een tijdzone af te leiden voor de VS, Canada en Australië. |
| `timeZone` | Time Zone | Ja | IANA-naam. |
| `locale` | Locale | Nee | BCP 47-tag zoals `en-US`. Afgeleid uit het land wanneer het ontbreekt. |
| `active` | Active status | Ja, als `status` | **Active**, **Inactive**, **On Leave** of **Removed**. Leeg bij een upload betekent actief. |
| `stage` | Lifecycle | Nee | Bepaald door Pyn; zie hieronder. |
| `exempt` | Exempt Status | Nee | **Exempt** of **Non-Exempt** (VS). |
| `workerType`, `employeeType`, `timeType` | Worker Type, Employee Type, Time Type | Nee | **Contingent Worker** / **Employee**; **Fixed Term** / **PEO** / **Regular**; **Full-Time** / **Part-Time**. Uit Workday en Rippling. |
| `removed` | Removed | Nee | Ingesteld wanneer de persoon uit het bronsysteem is verdwenen. |
| `returningEmployee` | Returning Employee | Nee | Opnieuw in dienst na vertrek (BambooHR). |
| `missingSsn` | Missing Social Security Number | Nee | Ja/nee, uit Workday. Deze en de vier rijen hieronder verschijnen alleen op het profiel in workspaces waar Pyn ze heeft ingeschakeld. |
| `orientationDate` | Orientation Date | Nee | De oriëntatiedatum van een nieuwe collega, uit Workday. |
| `orientationEligible` | Orientation Eligible | Nee | Ja/nee, uit Workday. |
| `over401kLimit` | Over-contribution to 401k | Nee | Ja/nee, uit Workday. |
| `surveyLink` | Survey Link | Nee | URL van de actieve survey van de persoon, uit Workday. |

Een upload heeft ook `employeeId` nodig, je eigen stabiele id voor de rij, en accepteert de vier relatiekolommen hieronder. Pyn negeert elke andere kop, dus een kolom zoals `employmentType` in een spreadsheet stelt niets in.

Een HRIS kan aangepaste velden toevoegen; die verschijnen op **Details** vóór de standaardvelden, en velden met enkelvoudige of meervoudige keuze verschijnen in de lijst **Filters**. Een tekst-, boolean- of enkelvoudige-keuze-eigenschap kan een demografie worden: [Een demografie maken](https://support.pyn.ai/nl/directory/demographics/create-a-demographic/).

## Relaties

| Relatie | Uploadkolom | Gebruikt voor |
| --- | --- | --- |
| **Manager** | `managerId` | De ontvanger Manager en tokens; de relatiegroep **Managers**. |
| **Buddy** | `buddyId` | De ontvanger Buddy; de groep **Buddies**. |
| **HRBP** | `hrbpId` | De ontvanger HRBP en tokens; de groep **HRBPs**. |
| **Mentor** | `mentorId` | De groep **Mentors**. |

Elke uploadkolom bevat de `employeeId` van de andere persoon uit hetzelfde bestand. Een HRIS levert zijn eigen id's en Pyn matcht ze. Een relatie telt voor een relatiegroep alleen wanneer de gerelateerde persoon een huidige medewerker is.

## Externe id's en bronnen

Pyn matcht records aan één profiel op de eigen id van het systeem (een BambooHR-medewerker-id, een Workday-worker-id, je `employeeId` in een Employee File) en het e-mailadres van de persoon, dus een spreadsheetrij en een HRIS-record met hetzelfde werk-e-mailadres worden één medewerker. Inloggen met een e-mailadres dat bij een profiel past koppelt de gebruiker eraan.

Elke waarde komt uit de eerste bron die haar levert, in deze volgorde: formulierantwoorden en webhookinzendingen, dan Workday, BambooHR, ADP, Greenhouse, Ashby, Rippling, HiBob, en dan Employee File. Slack komt als laatste, en alleen voor de weergavenaam, voorkeursnaam, primair e-mailadres, tijdzone en aangepaste velden. De avatar is de uitzondering: de foto uit Slack gaat vóór een foto uit een HRIS. Het tabblad **Sources** op een profiel somt de records op, en **Disconnect** op een record haalt het uit de samenvoeging.

## Hoe de lifecyclefase wordt bepaald

Pyn zet de startdatum, de einddatum en vandaag op volgorde en leest de fase af uit die volgorde:

| Datums | Fase |
| --- | --- |
| Verwijderd uit de bron | **Terminated**, wat de datums ook zeggen. |
| Startdatum in de toekomst (einddatum afwezig of eerder) | **Upcoming Joiner** |
| Startdatum in het verleden, geen einddatum of einddatum in de toekomst, niet als inactief gemarkeerd | **Current Active Employee** |
| Startdatum in het verleden en als inactief gemarkeerd (of geen dienstverbandbron) | **Terminated** |
| Einddatum in het verleden | **Terminated** |
| Helemaal geen datums | **Current Active Employee** indien actief, anders **Terminated** |

"Als inactief gemarkeerd" betekent dat de bron met de hoogste voorkeur `inactive` zegt, of dat geen enkele bron een dienstverbandsysteem is. Slack, Microsoft Teams, Greenhouse en Ashby zijn dat niet: iemand die alleen daar bekend is, geldt als inactief. Een `active` van `leave` wordt op het record getoond als **On Leave**, maar verandert de fase niet: een gestarte medewerker met verlof is **Current Active Employee**.

## Hoe een tijdzone wordt afgeleid

1. De tijdzone die de bron aanlevert, als het een geldige IANA-naam, een herkende afkorting of een Windows-tijdzonenaam is.
2. Anders het land en de postcode, voor de VS (ZIP), Canada en Australië.
3. Anders het land, als het één tijdzone heeft.
4. Anders geen. Berichten aan de persoon worden verstuurd in de tijdzone van de workspace uit **Settings** > **Account Settings**, en een Employee File-upload meldt de rij zodat je een tijdzone of postcode kunt toevoegen.

## Gerelateerd

- [Een ontbrekende manager, tijdzone of e-mail herstellen](https://support.pyn.ai/nl/directory/employees/fix-missing-details/) om een waarde recht te zetten.
- [Medewerkers uploaden uit een spreadsheet](https://support.pyn.ai/nl/directory/employees/upload-employees-from-a-spreadsheet/) voor het bestand waar deze sleutels de koppen van zijn.
- [Groepstypen](https://support.pyn.ai/nl/directory/employee-groups/reference-group-types/) voor de groepen die uit deze eigenschappen worden opgebouwd.
