---
title: HiBob-Feldzuordnung
description: Die Nachrichten-Tokens und Profilfelder von Mitarbeitenden, die Pyn aus HiBob füllen kann, wenn HiBob verbunden ist, das Bob-Feld hinter jedem, welche anderen Quellen es liefern können und was du prüfst, wenn ein Wert nicht erscheint.
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
---

Ein Token in einer Nachricht, etwa `principal.preferredName` oder `principal.managerName`, liest ein Feld im Profil der Person in Pyn. Ist HiBob verbunden, kann Pyn diese Profilfelder aus Bob füllen. Ob ein Feld einen Wert hat, hängt davon ab, was dein Bob-Tenant enthält, was das verbundene Bob-Konto sehen kann und welche anderen Quellen verbunden sind. Nutze die Tabellen, um ein Token zu dem Bob-Feld zurückzuverfolgen, das du in Bob füllen oder korrigieren musst.

## Tokens und die Bob-Felder dahinter

Wähle **Insert token** in der Editor-Symbolleiste oder tippe `@`, und die Liste zeigt jedes Token mit seinem Namen unter **principal** (die eingeschriebene Person) und **recipient** (die Person, die die Nachricht erhält). Jede Zeile ist ein Token, das Pyn aus Bob füllen kann, nicht eines, das immer einen Wert hat: Ist das Profilfeld leer, zeigt das Token seinen Fallback. Jedes `principal`-Token unten mit einem `recipient`-Zwilling in der Liste liest dasselbe Feld für den Empfänger.

| Token | Profilfeld, das es liest | Bob-Feld-ID |
| --- | --- | --- |
| `principal.preferredName` (gelistet als **Preferred Name**) | **Preferred Name**, sonst das erste Wort von **Display Name** | `root.displayName` |
| `principal.firstName` | Erstes Wort von **Display Name** | `root.displayName` |
| `principal.preferredFullName` | **Preferred Name** und Nachname, sonst **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`, sonst `address.city` |
| `principal.startDate`, `principal.startDate.dayAfter`, `principal.startDate.nextBusinessDay`, `principal.nextAnniversary` | **Start Date** | `work.startDate` |
| `principal.tenure` | **Tenure Date**, sonst **Start Date** | `work.originalStartDate`, sonst `work.startDate` |
| `principal.birthday`, `principal.nextBirthday` | **Birthday** | `personal.shortBirthDate` |
| `principal.managerName`, `principal.managerPreferredName`, `principal.managerEmail` | **Display Name** und **Primary Email Address** der **Manager**-Person | `work.reportsTo` wählt die Führungskraft; deren eigene `root.displayName` und `root.email` füllen die Werte |
| `principal.hrbp.name`, `principal.hrbp.preferredName`, `principal.hrbp.preferredFullName`, `principal.hrbp.email` | Name und E-Mail der **HRBP**-Person | `employee.hrbp` wählt den HRBP; dessen eigene `root.displayName` und `root.email` füllen die Werte |
| `principal.buddy.name`, `principal.buddy.preferredName`, `principal.buddy.preferredFullName`, `principal.buddy.email`, `principal.buddy.startDate.nextBusinessDay` | Name, E-Mail und Startdatum der **Buddy**-Person | Dein eigenes Buddy-Feld wählt den Buddy; dessen eigene `root.displayName`, `root.email` und `work.startDate` füllen die Werte |

Bob hat kein Rufnamenfeld, das Pyn liest, daher zeigen die Rufnamen-Tokens das erste Wort von Bobs Display name, sofern nicht eine andere Quelle einen Rufnamen liefert.

Diese Tokens in der Liste haben keine HiBob-Quelle: `date.reference`, das Referenzdatum des Enrollments, und `recipient.surveyLink`.

Für jedes andere Profilfeld, etwa **Probation End Date** oder ein eigenes Bob-Feld, das der Pyn-Support zugeordnet hat, wähle **Insert token**, dann **Employee Field…**, und wähle das Feld. In einer Raw-HTML-E-Mail liest `principal.email` `root.email`, `principal.personalEmail` liest `home.privateEmail`, `principal.endDate` liest `internal.terminationDate` und `principal.country` liest `address.country`. Siehe [Token](https://support.pyn.ai/de/flows/steps/reference-tokens/) für jedes Token und seinen Fallback.

## Profilfelder, die HiBob füllen kann

Die erste Spalte ist die Bezeichnung des Felds im Profil der Person in Pyn. Jede Zeile ist ein Feld, das Pyn aus Bob füllen kann, nicht eines, das jedes Profil hat: Ein Feld bleibt leer, wenn Bob keinen Wert hat oder das verbundene Konto es nicht sehen kann, und eine andere Quelle kann es stattdessen liefern. Die Bob-Feld-ID ist der Name, den Bobs API für das Feld nutzt.

| Pyn-Feld | Feld in Bob | Bob-Feld-ID | Hinweise |
| --- | --- | --- | --- |
| **Display Name** | Display name | `root.displayName` | Fällt auf Full name zurück, dann auf First name und Last name. |
| **Legal Name** | Full name | `root.fullName` | Fällt auf First name und Last name zurück (`root.firstName`, `root.surname`). |
| **Primary Email Address** | Email | `root.email` | Die geschäftliche Adresse, an die Nachrichten gehen. Dient auch dem Abgleich von Datensätzen. |
| **Personal Email Address** | Personal email | `home.privateEmail` | Dient dem Abgleich eines Pre-Hires ohne geschäftliche Adresse. |
| **Job Title** | Job title | `work.title` | |
| **Department** | Department | `work.department` | Der Wert, wie Bob ihn zeigt, nicht seine Listen-ID. |
| **Location** | Site | `work.site` | Fällt auf die Stadt der Adresse zurück (`address.city`). |
| **Primary Country** | Country | `address.country` | Aus der Adresse. |
| **Postal Code** | Postal code | `address.postalCode` | Aus der Adresse. |
| **Time Zone** | Keines | | Aus Land und Postleitzahl ermittelt; siehe unten. |
| **Birthday** | Date of birth | `personal.shortBirthDate` | Nur Tag und Monat. |
| **Start Date** | Start date | `work.startDate` | |
| **Tenure Date** | Original start date, sonst Start date | `work.originalStartDate`, `work.startDate` | Zählt ab Bobs ursprünglichem Startdatum, wenn es eines gibt, sonst gleich **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` | Eine Eigenschaft nur für HiBob. Speist **Tenure Date**. |
| **Active status** | Lifecycle status, dann Status | `internal.lifecycleStatus`, `internal.status` | Ein Lifecycle-Status, der „leave“ enthält, ist **On Leave**. Sonst ist ein Status Active, oder keiner, **Active**, und alles andere **Inactive**. |
| **Manager** | Reports to | `work.reportsTo` | Abgeglichen mit dem Bob-Datensatz der Führungskraft. Siehe [Führungskraft](#führungskraft) unten. |
| **HRBP** | HRBP | `employee.hrbp` | Abgeglichen mit dem Bob-Datensatz des HRBP. |
| **Buddy** | Dein Buddy-Feld | Ein eigenes Feld | Bob hat kein Standardfeld für Buddy. Der Pyn-Support legt fest, welches eigene Feld ihn enthält. |
| Eigene Felder | Das Feld deiner Wahl | Beliebige Feld-ID | Gelesen als Text, Ja/Nein, Datum oder Zahl. Der Pyn-Support ordnet jedes für dich zu. |

Pyn liest diese nicht aus Bob: **Preferred Name**, **Avatar Image**, **Secondary Email Address**, **Employment Type**, **Business Unit**, **Division**, **Team** und **Mentor**. Bobs Felder für Beschäftigungsart und Vertrag werden nicht auf **Employment Type** abgebildet; der Pyn-Support kann eines davon stattdessen als eigenes Feld zuordnen. Jedes andere eigene Feld in Bob, etwa ein Feld „Manager ID“, wird ignoriert, solange es nicht zugeordnet ist.

### Führungskraft

Pyn nimmt die ID in **Reports to** und sucht die Bob-Person mit dieser ID. Gibt Bob keine ID zurück, nutzt Pyn die **Employee ID** der Führungskraft aus Bob (`work.reportsToIdInCompany`) und gleicht sie mit der Person mit dieser **Employee ID** (`work.employeeIdInCompany`) im selben Bob-Unternehmen ab. Die Führungskraft muss ebenfalls in der Synchronisierung sein, das verbundene Bob-Konto braucht also Lesezugriff auf ihren Datensatz.

### Zeitzone

Pyn liest keine Zeitzone aus Bob. Es ermittelt eine aus **Primary Country** und **Postal Code**: über die Postleitzahl für die USA, Kanada und Australien, und über das Land allein, wo es nur eine Zeitzone hat. Bei anderen Ländern mit mehr als einer Zeitzone nutzt Pyn die Slack-Zeitzone der Person, wenn sie eine hat; sonst bleibt **Time Zone** leer, und ein Schritt, der in der Zeitzone des Empfängers geplant ist, wird stattdessen in der Zeitzone des Workspace gesendet.

## Wie die Synchronisierung läuft

Eine Änderung in Bob erreicht Pyn und die Tokens in der nächsten gesendeten Nachricht innerhalb von etwa einer Stunde. Ein Lauf, in dem sich in Bob nichts geändert hat, wird unter **History** als „Successfully integrated to HiBob. No employee changes found“ festgehalten. Pyn liest nur aus Bob und schreibt nie zurück.

Ausscheidende Personen bleiben in der Synchronisierung, damit ihre Austrittsdaten ankommen. Eine Person, die aus Bobs Ergebnissen verschwindet, wird als **Removed** markiert und wird **Terminated**.

## Fehlerbehebung

| Was du siehst | Was du prüfst |
| --- | --- |
| Ein Token zeigt seinen Fallback, etwa „Manager“ oder „department“ | Das Profilfeld dahinter ist leer. Öffne die Person in [Employees](https://support.pyn.ai/de/directory/employees/) und prüfe das Feld, dann die Zeilen unten. Andere verbundene Quellen können einige Felder ebenfalls füllen; der Tab **Sources** des Profils listet jeden Datensatz hinter einer Person. |
| Ein Feld ist in Bob gefüllt, aber in Pyn leer | Öffne die HiBob-Integration unter **Installed** und wähle **Advanced**. **Fields in Report** listet, was Bob zurückgegeben hat und für wie viele Personen. Ein fehlendes Feld heißt, die Berechtigungsgruppe des Service Users, oder dein eigenes Konto, wenn du dich mit **Connect with HiBob** angemeldet hast, kann es nicht sehen. Bob lässt so ein Feld ohne Fehler weg. |
| **Manager** ist leer | **Reports to** ist in Bob leer, die Berechtigungsgruppe kann es nicht sehen, oder die Führungskraft ist für den Service User nicht sichtbar. Ein eigenes Feld mit einer Manager-ID wird nicht gelesen. |
| **Location** zeigt eine Stadt | Die Person hat in Bob keine Site, also hat Pyn die Stadt der Adresse genutzt. |
| Ein eigenes Bob-Feld fehlt | Eigene Felder werden erst gelesen, wenn der Pyn-Support sie zuordnet. |
| Eine Änderung in Bob ist nicht angekommen | Warte auf die nächste stündliche Aktualisierung und prüfe **History** bei der Integration. |

## Verwandte Seiten

- [Token](https://support.pyn.ai/de/flows/steps/reference-tokens/) für jedes Token, seinen Fallback und seine Formatierung.
- [HiBob](https://support.pyn.ai/de/integrations/hibob/), um Bob zu verbinden und die Berechtigungen zu gewähren, die Pyn braucht.
- [HRIS-Felder](https://support.pyn.ai/de/integrations/hris-fields/), um HiBob mit den anderen Quellen zu vergleichen.
- [Eigenschaften von Mitarbeitenden](https://support.pyn.ai/de/directory/employees/reference-employee-properties/) für jedes Pyn-Feld.
- [Fehlende Führungskraft, Zeitzone oder E-Mail korrigieren](https://support.pyn.ai/de/directory/employees/fix-missing-details/), um einen Wert in Ordnung zu bringen.
