Stamgegevens importeren

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.

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):

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 (Engels). Het API-endpoint is POST /import.

In English: Import master data.