# Stamgegevens importeren

> Hulp voor kantoor: medewerkers, opdrachtgevers en plaatsingen importeren uit één CSV-bestand, met een controle voordat er iets wordt opgeslagen.

URL: https://timetracking.tech/developers/help/nl/kantoor/importeren
Last updated: 2026-10-26

Met "Importeren" laad je "Medewerkers", "Opdrachtgevers" en "Plaatsingen" uit één CSV-bestand. Dit is de snelste manier om te starten, of om wijzigingen uit je ATS of salarissysteem over te nemen.

Exacte bestandsspecificatie voor ontwikkelaars (Engels): [CSV import](https://timetracking.tech/developers/data-in/csv-import).

## Het bestand voorbereiden

Eén rij per plaatsing (persoon × opdrachtgever). Een persoon zonder opdrachtgever mag ook: dan wordt alleen de persoon aangemaakt of bijgewerkt.

Download het sjabloon bij "Importeren", of begin met dit voorbeeld (gescheiden door puntkomma's):

```csv
personeelsnummer;voornaam;achternaam;email;telefoon;opdrachtgever;plaatsing;functie;startdatum;einddatum
1005;Ahmed;Bakker;ahmed@example.com;+31612345678;VDL Montage;PL-2026-105;Monteur;01-11-2026;
```

Kolomnamen mogen Nederlands of Engels zijn; deze worden herkend (hoofdletters maken niet uit):

| Veld | Geaccepteerde kopjes |
|---|---|
| Personeelsnummer (verplicht) | `personeelsnummer`, `werknemersnummer`, `nummer`, `employee_number` |
| Voornaam (verplicht) | `voornaam`, `first_name` |
| Achternaam (verplicht) | `achternaam`, `last_name` |
| E-mail | `email`, `e-mail`, `emailadres` |
| Telefoon | `telefoon`, `mobiel`, `phone` |
| Opdrachtgever | `opdrachtgever`, `klant`, `inlener`, `client` |
| Plaatsingsnummer | `plaatsing`, `plaatsingsnummer`, `placement`, `placement_ref` |
| Functie | `functie`, `role` |
| Startdatum (verplicht bij een opdrachtgever) | `startdatum`, `begindatum`, `start_date` |
| Einddatum | `einddatum`, `end_date` |

Datums: `DD-MM-JJJJ` (bijv. `01-11-2026`) of `JJJJ-MM-DD`. Andere kolommen worden genegeerd en als "niet herkend" getoond.

## Hoe rijen worden gekoppeld

- **Medewerkers** worden gekoppeld op personeelsnummer. Bestaand → bijgewerkt (naam, e-mail, telefoon); nieuw → aangemaakt.
- **Opdrachtgevers** worden gekoppeld op naam, ongeacht hoofd- of kleine letters. Een naam die nog niet bestaat maakt een nieuwe opdrachtgever aan, dus let op de spelling ("VDL Montage" en "VDL-Montage" geven twee opdrachtgevers).
- **Plaatsingen** worden gekoppeld op plaatsingsnummer. Zonder plaatsingsnummer maakt elke import een nieuwe plaatsing aan, dus vul het altijd in.

## Stappen

1. Ga naar "Importeren" en kies het bestand.
2. Klik op "Controleer bestand". Er wordt nog niets opgeslagen. Je ziet per rij of die in orde is, en hoeveel medewerkers, opdrachtgevers en plaatsingen er zouden worden aangemaakt of bijgewerkt.
3. Herstel de rijen met fouten in je spreadsheet. Veelvoorkomende meldingen: "personeelsnummer ontbreekt", "naam ontbreekt", "startdatum ontbreekt of is ongeldig (gebruik DD-MM-JJJJ)", "einddatum ligt vóór startdatum".
4. Kies het bestand opnieuw ("Kies het bestand opnieuw als je na de controle importeert") en importeer.
5. Controleer "Medewerkers" en "Plaatsingen". Geef medewerkers die de app nodig hebben toegang ("Toegang geven"; daarvoor is een e-mailadres nodig).

## Veelvoorkomende problemen

| Probleem | Oplossing |
|---|---|
| Letters met accenten zien er vreemd uit | Sla de CSV op als UTF-8 ("CSV UTF-8" in Excel) |
| Dubbele opdrachtgevers na import | Namen van opdrachtgevers moeten exact overeenkomen (hoofdletters tellen niet). Pas de waarden in het bestand aan en importeer opnieuw; verwijder de dubbele opdrachtgever met de hand |
| Een einddatum van een plaatsing kan niet worden ingesteld | Er zijn al uren na de nieuwe einddatum; de plaatsing kan niet worden ingekort tot vóór die uren |
| Dubbele plaatsingen | Vul de kolom plaatsingsnummer, zodat latere imports bijwerken in plaats van aanmaken |

## Automatiseren

`tt import bestand.csv` (controle) en `tt import bestand.csv --commit` doen hetzelfde vanaf de opdrachtregel; zie [CLI](https://timetracking.tech/developers/tools/cli#tt-import) (Engels). Het API-endpoint is [`POST /import`](https://timetracking.tech/developers/api/reference#post-import).

In English: [Import master data](https://timetracking.tech/developers/help/office/import).