---
title: "Employee File"
description: "Gebruik een spreadsheet als bron van medewerkers: download het voorbeeldbestand, vul de kolommen, upload het en upload opnieuw om bij te werken. De manier om Pyn zonder HRIS te draaien."
sidebar:
  label: Overzicht
  order: 0
area: integrations
feature: employee-file
appPath: /settings/integrations/available
lastVerified: 2026-11-09
version: "2026-11-09"
audience: admin
related:
  - integrations
  - directory/employees
  - integrations/sync-and-matching
  - integrations/sample-data
intercom:
  - id: "16755797"
    title: How to Upload Employee Data Manually (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16755797-how-to-upload-employee-data-manually-pyn-2
    note: replaces
  - id: "16755703"
    title: Connect  to your HRIS (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16755703-connect-to-your-hris-pyn-2
    note: draws on
  - id: "6024080"
    title: How to upload employee data manually (Pyn 1)
    url: https://intercom.help/pyn/en/articles/6024080-how-to-upload-employee-data-manually-pyn-1
    note: "Pyn 1 article, kept for reference"
translation:
  source: integrations/employee-file/index.mdx
  sourceSha: 5e56e7dc24fde63c7998601735bb3a5093248c35
---

Employee File maakt van een spreadsheet je medewerkersdirectory. Elke rij is één medewerker, elke kolom een eigenschap in Pyn, en elke upload is je volledige personeelsbestand: rijen worden toegevoegd of bijgewerkt op `employeeId`, en wie in het bestand ontbreekt wordt gemarkeerd als verwijderd uit deze bron. Pyn valideert het bestand voordat er iets wordt opgeslagen en vertelt je welke rijen en kolommen het niet kon lezen.

## Voordat je begint

- Je bent admin of owner.
- Maak een CSV, XLS of XLSX waarvan de kolomkoppen de namen van de eigenschappen hieronder zijn. **Download Sample File** geeft je een CSV met elke kolom en vijf voorbeeldrijen.
- Elke rij heeft `employeeId` en `primaryEmail` nodig. Geef voor medewerkers in een land met meerdere tijdzones een `timeZone`; voor de VS, Canada en Australië volstaat een `postalCode` samen met het `country`. Anders wordt de rij geweigerd.

![De integratie Employee File onder Installed, met het uploadpaneel open.](https://support.pyn.ai/media/integrations/employee-file/integrations-employee-file-tile.png)

## Koppelen

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

2. Selecteer de tegel **Employee File**; de omslag leest **File Upload**. Pyn maakt de integratie aan en opent het paneel: "Upload a spreadsheet of your employees to get started. Use the sample file to see the expected columns." Kan de integratie niet worden aangemaakt, dan meldt een dialoogvenster met de titel **Add Employee File**: "We could not create the Employee File integration. Please try again or contact support."

3. Selecteer **Download Sample File** en gebruik het als basis voor je bestand, met behoud van de kopregel.

4. Selecteer **Upload** en kies je bestand. Het paneel toont **Uploading...** terwijl het valideert en opslaat.

5. Bij succes leest het "Success! Uploaded n records. Head over to the Directory to see employees after processing completes. This can take a minute or two."

Mislukken er rijen, dan toont het paneel de eerste vijf onder "There were n errors found in the uploaded file:" met de rij en het probleem, en een aantal voor de rest, bijvoorbeeld `Unknown country: "Engalnd"`, `Could not determine timezone from country "United States". Add a postal code or choose a time zone.` of `Invalid birthday format. Expected MM-dd, dd/MM, yyyy-MM-dd or ISO8601 datetime.` Er wordt niets opgeslagen zolang een rij mislukt. Herstel de genoemde rijen en upload het hele bestand opnieuw.

## Wat er wordt gesynchroniseerd

| Kolom | Verplicht | Opmerkingen |
| --- | --- | --- |
| `employeeId` | Ja | Je stabiele id voor de persoon; uploads matchen erop |
| `primaryEmail` | Ja | Zakelijk e-mailadres, ook gebruikt om Slack- en Google-accounts te matchen |
| `displayName`, `legalName`, `preferredName`, `jobTitle` | | |
| `personalEmail`, `secondaryEmail`, `avatarUri` | | Het persoonlijke e-mailadres wordt gebruikt voor pre-boarding |
| `status` | | `active`, `inactive` of `leave`; leeg betekent `active` |
| `startDate`, `terminationDate`, `tenureDate` | | `yyyy-MM-dd` of `yyyy/MM/dd`, of een datumcel in een `.xls`- of `.xlsx`-bestand; een datum die niet bestaat wordt geweigerd |
| `birthday` | | `MM-dd`, `dd/MM`, `yyyy-MM-dd` of een ISO-datum-tijd |
| `country`, `postalCode`, `timeZone` | | Land als naam of ISO-code; tijdzone als IANA-naam zoals `Europe/London`. Een getalcel in een `.xls`- of `.xlsx`-bestand wordt gelezen zoals het blad hem toont, dus een postcode in een `00000`-notatie houdt zijn voorloopnullen |
| `businessUnit`, `department`, `division`, `location`, `team` | | Worden demografieën en groepen |
| `managerId`, `buddyId`, `hrbpId`, `mentorId` | | Het `employeeId` van de gerelateerde persoon |

Er is geen geplande verversing; het bestand wordt gelezen wanneer je het uploadt. Het tabblad **Advanced** toont **Fields in Employee File** met een aantal per kolom. Je kunt ook één persoon tegelijk toevoegen met **Add employee** in [Employees](https://support.pyn.ai/nl/directory/employees/), dat vraagt om **Full name\***, **Preferred name**, **Work email**, **Personal email**, **Start date\***, **Country\***, **Time zone\*** en **Manager**, en de persoon toevoegt als aankomende joiner.

## Testen

Open [Employees](https://support.pyn.ai/nl/directory/employees/) een minuut of twee na de upload. Actieve rijen verschijnen onder **Active**, toekomstige startdatums onder **Upcoming**, en een `status` van `inactive` onder **Inactive**. Open een persoon om de koppeling met de manager te controleren.

## Opnieuw koppelen of ontkoppelen

Er zijn geen inloggegevens. Upload een nieuw bestand om gegevens te wijzigen, en upload altijd iedereen: een rij die in een later bestand ontbreekt, wordt gemarkeerd als verwijderd uit deze bron en de persoon wordt als inactief weergegeven; staat die persoon in een later bestand weer op de lijst, dan komt hij terug met de `status` van die rij. **Deactivate** behoudt de gegevens maar negeert uploads; **Activate** schakelt ze weer in.

## Problemen oplossen

| Wat je ziet | Wat het betekent |
| --- | --- |
| "The uploaded file was empty" | Geen gegevensrijen onder de kopregel, of de kopregel ontbreekt. |
| Een rijfout die `country` of `postalCode` noemt | De landnaam is niet herkend, of de postcode leverde geen zone op. Voeg `timeZone` toe. |
| Een manager is niet gekoppeld | `managerId` komt met geen enkele `employeeId` van een rij overeen. |
| Iemand staat er twee keer in | Zijn of haar `employeeId` en e-mailadressen zijn tussen twee uploads allemaal veranderd, dus niets matchte met het eerdere record. Houd id's en e-mailadressen stabiel. |

## Gerelateerd

- [Integrations](https://support.pyn.ai/nl/integrations/) voor de HRIS-alternatieven.
- [Employees](https://support.pyn.ai/nl/directory/employees/) om de geüploade records te controleren en één persoon toe te voegen.
- [Synchronisatiefrequentie en matching](https://support.pyn.ai/nl/integrations/sync-and-matching/) voor hoe id's en e-mailadressen matchen.
- [Sample Data](https://support.pyn.ai/nl/integrations/sample-data/) om Pyn in plaats daarvan met een fictief personeelsbestand uit te proberen.
