---
title: "Medewerkers uploaden uit een spreadsheet"
description: "Laad je medewerkers of werk ze bij vanuit een CSV-, XLS- of XLSX-bestand via de Employee File-integratie, en lees het resultaat."
sidebar:
  order: 2
area: directory
feature: employees
appPath: /settings/home
lastVerified: 2026-11-15
version: "2026-11-03"
audience: admin
screenshots:
  - id: directory-employees-employee-file-panel
    caption: Het Employee File-paneel in Settings, met Download Sample File en Upload.
related:
  - directory/employees/reference-employee-properties
  - directory/employees/export-employees
  - integrations/employee-file
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: "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: directory/employees/upload-employees-from-a-spreadsheet.mdx
  sourceSha: 051ad972061a58edb0af5148cb90a042b5bfef40
---

Zonder HRIS-koppeling is een spreadsheet de manier waarop medewerkers in Pyn komen, en waarop ze actueel blijven. Bij elke upload worden rijen gematcht op je `employeeId`, worden gewijzigde waarden bijgewerkt, en worden mensen die in het bestand ontbreken gemarkeerd als verwijderd uit deze bron.

## Voordat je begint

- Je bent admin van de workspace.
- Je bestand heeft een koprij met de kolomnamen uit het voorbeeldbestand (stap 2), dat elke geaccepteerde kolom bevat; Pyn negeert een kolom die het niet kent. `employeeId` en `primaryEmail` zijn verplicht in elke rij. [Eigenschappen van medewerkers](https://support.pyn.ai/nl/directory/employees/reference-employee-properties/) geeft aan welke eigenschappen een upload kan instellen.

![Het Employee File-paneel in Settings, met Download Sample File en Upload.](https://support.pyn.ai/media/directory/employees/directory-employees-employee-file-panel.png)

## Stappen

1. Open in Pyn **Settings** onderaan de linkernavigatie en dan **Integrations**. Selecteer **Installed** en de tegel **File Upload** als je al eerder hebt geüpload; selecteer anders **Available** en de tegel **File Upload**, wat de integratie aanmaakt en opent. In beide gevallen heet het paneel dat opent **Employee File**.

2. Selecteer in de banner van het paneel **Download Sample File** voor een CSV met elke kolom en voorbeeldrijen, en gebruik die als je sjabloon.

3. Controleer de kolommen die een bepaald formaat nodig hebben: datums als `yyyy-MM-dd` of `yyyy/MM/dd`, of als datumcel in een `.xls`- of `.xlsx`-bestand; een getalcel zoals een postcode wordt gelezen zoals het blad hem toont, dus een `00000`-opmaak behoudt voorloopnullen; `status` als `active`, `leave` of `inactive` (leeg betekent actief); `country` als naam of ISO-code; `timeZone` als IANA-naam zoals `Europe/London` (of laat het leeg en vul `country` in en, voor de VS, Canada en Australië, `postalCode`); `birthday` als `MM-dd`, `dd/MM` of `yyyy-MM-dd`; `managerId`, `buddyId`, `hrbpId` en `mentorId` als de `employeeId` van een andere rij.

4. Selecteer **Upload** en kies het bestand.

5. Lees de banner. **Uploading...** en dan **Success!** gevolgd door **Uploaded N records.** betekent dat elke rij is geslaagd. Anders heeft de banner de kop **There were N errors found in the uploaded file:** en somt hij de eerste vijf op als **Row #n:** gevolgd door de kolom en de ontvangen waarde, bijvoorbeeld **startDate is invalid. Received: 12/01/2026** of **Could not determine timezone from country "United States". Add a postal code or choose a time zone.**, en dan **As well as N additional errors...**. Herstel elke genoemde rij en upload opnieuw; een bestand met ook maar één mislukte rij wordt niet toegepast.

6. Open **Directory** in de linkernavigatie. Verwerken duurt een minuut of twee; daarna verschijnen profielen of worden ze bijgewerkt onder **Active**, **Upcoming** en **Inactive**.

> **Caution:** Iemand die door een eerdere upload in Pyn staat maar niet in het nieuwe bestand, wordt gemarkeerd als verwijderd uit de bron Employee File. Was dat de enige bron, dan wordt de fase **Terminated** en verhuist de persoon naar **Inactive**. Exporteer bij twijfel eerst en bewerk de export.

## Wat je zou moeten zien

Het tabblad **History** van het Employee File-paneel legt elke upload vast met een statusstip. **Advanced** toont **Fields in Employee File**: elke geziene kolom en hoeveel rijen een waarde hadden. In **Directory** staan de nieuwe rijen met de waarden uit je bestand; een waarde die een andere bron al aanlevert (een HRIS, bijvoorbeeld) wordt niet overschreven, omdat Employee File in de samenvoegvolgorde na de HRIS-bronnen komt.

## Gerelateerd

- [Eigenschappen van medewerkers](https://support.pyn.ai/nl/directory/employees/reference-employee-properties/) voor elke kolom en welke bron wint.
- [Medewerkers exporteren](https://support.pyn.ai/nl/directory/employees/export-employees/) om je volgende update te beginnen vanuit wat Pyn heeft.
- [Employee File](https://support.pyn.ai/nl/integrations/employee-file/) voor de integratie zelf.
