---
title: HiBob-veldmapping
description: De berichttokens en profielvelden van medewerkers die Pyn uit HiBob kan vullen wanneer HiBob is gekoppeld, het Bob-veld achter elk ervan, welke andere bronnen het kunnen leveren, en wat je controleert wanneer een waarde niet verschijnt.
sidebar:
  order: 1
area: integrations
feature: hibob
appPath: /settings/integrations/installed
lastVerified: 2026-11-15
version: "2026-11-06"
audience: admin
related:
  - flows/steps/reference-tokens
  - integrations/hibob
  - integrations/hris-fields
  - directory/employees/reference-employee-properties
  - directory/employees/fix-missing-details
translation:
  source: integrations/hibob/field-mapping.mdx
  sourceSha: 2642a82ed96efd584f86db853f16c51104e71d57
---

Een token in een bericht, zoals `principal.preferredName` of `principal.managerName`, leest een veld op het profiel van de medewerker in Pyn. Wanneer HiBob is gekoppeld, kan Pyn die profielvelden uit Bob vullen. Of een veld een waarde heeft, hangt af van wat je Bob-tenant bevat, wat het gekoppelde Bob-account mag zien, en welke andere bronnen zijn gekoppeld. Gebruik de tabellen om een token terug te voeren op het Bob-veld dat je in Bob invult of corrigeert.

## Tokens en de Bob-velden erachter

Selecteer **Insert token** in de werkbalk van de editor, of typ `@`, en de lijst toont elk token op naam onder **principal** (de ingeschreven medewerker) en **recipient** (de persoon die het bericht ontvangt). Elke rij is een token dat Pyn uit Bob kan vullen, niet een dat altijd een waarde heeft: is het profielveld leeg, dan toont het token zijn terugvalwaarde. Elk `principal`-token hieronder met een `recipient`-tegenhanger in de lijst leest hetzelfde veld voor de ontvanger.

| Token | Profielveld dat het leest | Bob-veld-id |
| --- | --- | --- |
| `principal.preferredName` (in de lijst als **Preferred Name**) | **Preferred Name**, anders het eerste woord van **Display Name** | `root.displayName` |
| `principal.firstName` | Eerste woord van **Display Name** | `root.displayName` |
| `principal.preferredFullName` | **Preferred Name** en achternaam, anders **Display Name** | `root.displayName` |
| `principal.legalName` | **Legal Name** | `root.fullName` |
| `principal.jobTitle` | **Job Title** | `work.title` |
| `principal.department` | **Department** | `work.department` |
| `principal.location` | **Location** | `work.site`, anders `address.city` |
| `principal.startDate`, `principal.startDate.dayAfter`, `principal.startDate.nextBusinessDay`, `principal.nextAnniversary` | **Start Date** | `work.startDate` |
| `principal.tenure` | **Tenure Date**, anders **Start Date** | `work.originalStartDate`, anders `work.startDate` |
| `principal.birthday`, `principal.nextBirthday` | **Birthday** | `personal.shortBirthDate` |
| `principal.managerName`, `principal.managerPreferredName`, `principal.managerEmail` | De **Display Name** en het **Primary Email Address** van de **Manager** | `work.reportsTo` wijst de manager aan; diens eigen `root.displayName` en `root.email` vullen de waarden |
| `principal.hrbp.name`, `principal.hrbp.preferredName`, `principal.hrbp.preferredFullName`, `principal.hrbp.email` | De naam en het e-mailadres van de **HRBP** | `employee.hrbp` wijst de HRBP aan; diens eigen `root.displayName` en `root.email` vullen de waarden |
| `principal.buddy.name`, `principal.buddy.preferredName`, `principal.buddy.preferredFullName`, `principal.buddy.email`, `principal.buddy.startDate.nextBusinessDay` | De naam, het e-mailadres en de startdatum van de **Buddy** | Je aangepaste buddyveld wijst de buddy aan; diens eigen `root.displayName`, `root.email` en `work.startDate` vullen de waarden |

Bob heeft geen veld voor de roepnaam dat Pyn leest, dus de tokens voor de roepnaam tonen het eerste woord van de weergavenaam in Bob, tenzij een andere bron een roepnaam levert.

Deze tokens in de lijst hebben geen HiBob-bron: `date.reference`, de referentiedatum van de enrollment, en `recipient.surveyLink`.

Voor elk ander profielveld, zoals **Probation End Date** of een aangepast Bob-veld dat Pyn-support heeft gekoppeld, selecteer je **Insert token**, dan **Employee Field…**, en kies je het veld. In een Raw HTML-e-mail leest `principal.email` het veld `root.email`, `principal.personalEmail` het veld `home.privateEmail`, `principal.endDate` het veld `internal.terminationDate` en `principal.country` het veld `address.country`. Zie [Tokens](https://support.pyn.ai/nl/flows/steps/reference-tokens/) voor elk token en zijn terugvalwaarde.

## Profielvelden die HiBob kan vullen

De eerste kolom is het label van het veld op het medewerkersprofiel in Pyn. Elke rij is een veld dat Pyn uit Bob kan vullen, niet een dat elk profiel heeft: een veld blijft leeg wanneer Bob geen waarde heeft of het gekoppelde account het niet mag zien, en een andere bron kan het in plaats daarvan leveren. Het Bob-veld-id is de naam die de API van Bob voor het veld gebruikt.

| Veld in Pyn | Veld in Bob | Bob-veld-id | Opmerkingen |
| --- | --- | --- | --- |
| **Display Name** | Display name | `root.displayName` | Valt terug op Full name, dan First name en Last name. |
| **Legal Name** | Full name | `root.fullName` | Valt terug op First name en Last name (`root.firstName`, `root.surname`). |
| **Primary Email Address** | Email | `root.email` | Het zakelijke adres waar berichten naartoe gaan. Ook gebruikt om records te matchen. |
| **Personal Email Address** | Personal email | `home.privateEmail` | Gebruikt om een pre-hire zonder zakelijk adres te matchen. |
| **Job Title** | Job title | `work.title` | |
| **Department** | Department | `work.department` | De waarde zoals Bob haar toont, niet het lijst-id. |
| **Location** | Site | `work.site` | Valt terug op de woonplaats uit het adres (`address.city`). |
| **Primary Country** | Country | `address.country` | Uit het adres. |
| **Postal Code** | Postal code | `address.postalCode` | Uit het adres. |
| **Time Zone** | Geen | | Afgeleid uit land en postcode; zie hieronder. |
| **Birthday** | Date of birth | `personal.shortBirthDate` | Alleen dag en maand. |
| **Start Date** | Start date | `work.startDate` | |
| **Tenure Date** | Original start date, anders Start date | `work.originalStartDate`, `work.startDate` | Telt vanaf de oorspronkelijke startdatum in Bob wanneer die er is, anders gelijk aan **Start Date**. |
| **Termination Date** | Termination date | `internal.terminationDate` | |
| **Probation End Date** | Probation end date | `internal.probationEndDate` | |
| **Original Start Date in HiBob** | Original start date | `work.originalStartDate` | Een eigenschap die alleen HiBob levert. Voedt **Tenure Date**. |
| **Active status** | Lifecycle status, dan Status | `internal.lifecycleStatus`, `internal.status` | Een lifecyclestatus die "leave" bevat is **On Leave**. Anders is een Status Active, of geen status, **Active**, en al het andere **Inactive**. |
| **Manager** | Reports to | `work.reportsTo` | Gematcht met het Bob-record van de manager. Zie [Manager](#manager) hieronder. |
| **HRBP** | HRBP | `employee.hrbp` | Gematcht met het Bob-record van de HRBP. |
| **Buddy** | Je buddyveld | Een aangepast veld | Bob heeft geen standaard buddyveld. Pyn-support stelt in welk aangepast veld de buddy bevat. |
| Aangepaste velden | Het veld dat je kiest | Elk veld-id | Gelezen als tekst, ja/nee, een datum of een getal. Pyn-support koppelt elk veld voor je. |

Pyn leest deze niet uit Bob: **Preferred Name**, **Avatar Image**, **Secondary Email Address**, **Employment Type**, **Business Unit**, **Division**, **Team** en **Mentor**. De velden voor type dienstverband en contract in Bob zijn niet gekoppeld aan **Employment Type**; Pyn-support kan een van beide in plaats daarvan als aangepast veld koppelen. Elk ander aangepast veld in Bob, zoals een veld "Manager ID", wordt genegeerd tenzij het is gekoppeld.

### Manager

Pyn neemt het id in **Reports to** en zoekt de Bob-medewerker met dat id. Geeft Bob geen id terug, dan gebruikt Pyn de **Employee ID** van de manager uit Bob (`work.reportsToIdInCompany`) en matcht die met de persoon met die **Employee ID** (`work.employeeIdInCompany`) in hetzelfde Bob-bedrijf. De manager moet ook in de synchronisatie zitten, dus het gekoppelde Bob-account heeft leestoegang tot diens record nodig.

### Tijdzone

Pyn leest geen tijdzone uit Bob. Het leidt er een af uit **Primary Country** en **Postal Code**: de postcode voor de Verenigde Staten, Canada en Australië, en alleen het land wanneer dat één tijdzone heeft. Voor andere landen met meer dan één tijdzone gebruikt Pyn de Slack-tijdzone van de persoon wanneer die er een heeft; anders blijft **Time Zone** leeg, en wordt een stap die in de tijdzone van de ontvanger is gepland in plaats daarvan in de tijdzone van de workspace verstuurd.

## Hoe de synchronisatie loopt

Een wijziging in Bob bereikt Pyn, en de tokens in het volgende verstuurde bericht, binnen ongeveer een uur. Een run waarin niets in Bob is veranderd, wordt onder **History** vastgelegd als "Successfully integrated to HiBob. No employee changes found". Pyn leest alleen uit Bob en schrijft nooit terug.

Vertrekkers blijven in de synchronisatie, zodat hun datums uit dienst binnenkomen. Een persoon die uit de resultaten van Bob verdwijnt, wordt gemarkeerd als **Removed** en wordt **Terminated**.

## Problemen oplossen

| Wat je ziet | Wat je controleert |
| --- | --- |
| Een token toont zijn terugvalwaarde, zoals "Manager" of "department" | Het profielveld erachter is leeg. Open de persoon in [Employees](https://support.pyn.ai/nl/directory/employees/) en controleer het veld, daarna de rijen hieronder. Andere gekoppelde bronnen kunnen sommige velden ook vullen; het tabblad **Sources** van het profiel toont elk record achter een persoon. |
| Een veld is in Bob ingevuld maar in Pyn leeg | Open de HiBob-integratie onder **Installed** en selecteer **Advanced**. **Fields in Report** toont wat Bob heeft teruggegeven en voor hoeveel mensen. Een ontbrekend veld betekent dat de rechtengroep van de service user, of je eigen account als je met **Connect with HiBob** hebt ingelogd, het niet mag zien. Bob laat zo'n veld zonder foutmelding weg. |
| **Manager** is leeg | **Reports to** is leeg in Bob, de rechtengroep mag het niet zien, of de manager is niet zichtbaar voor de service user. Een aangepast veld met een manager-id wordt niet gelezen. |
| **Location** toont een woonplaats | De persoon heeft geen Site in Bob, dus Pyn heeft de woonplaats uit het adres gebruikt. |
| Een aangepast Bob-veld ontbreekt | Aangepaste velden worden pas gelezen zodra Pyn-support ze koppelt. |
| Een wijziging in Bob is niet aangekomen | Wacht op de volgende uurlijkse verversing en controleer **History** op de integratie. |

## Gerelateerd

- [Tokens](https://support.pyn.ai/nl/flows/steps/reference-tokens/) voor elk token, zijn terugvalwaarde en zijn opmaak.
- [HiBob](https://support.pyn.ai/nl/integrations/hibob/) om Bob te koppelen en de rechten te geven die Pyn nodig heeft.
- [HRIS-velden](https://support.pyn.ai/nl/integrations/hris-fields/) om HiBob met de andere bronnen te vergelijken.
- [Eigenschappen van medewerkers](https://support.pyn.ai/nl/directory/employees/reference-employee-properties/) voor elk veld in Pyn.
- [Een ontbrekende manager, tijdzone of e-mail herstellen](https://support.pyn.ai/nl/directory/employees/fix-missing-details/) om een waarde recht te zetten.
