Met de import UserCsvImport maak je medewerkers aan in Benefits Manager, werk je hun gegevens bij en beëindig je een contract. Dit artikel legt uit wat de import precies doet met elke regel, welke kolommen verplicht zijn en waar het vaak misgaat.
In het kort
- Eén regel per medewerker. De eerste zeven kolommen liggen vast:
Identifier;Username;Name;Email;ContractCode;ContractStart;ContractEnd. Daarna kun je basisgegevens toevoegen. - Nieuwe medewerker: de eerste zes kolommen zijn verplicht. De medewerker krijgt de rol Medewerker.
- Bestaande medewerker: een lege cel laat de bestaande gegevens staan. Het contractnummer moet gelijk zijn aan dat van het lopende contract.
-
Uitdienst: vul
ContractEndmet de datum uit dienst. - Basisgegevens gelden vanaf de eerste dag van de periode die je kiest bij de import.
Het bestand
Het formaat staat in Medewerkergegevens aanleveren: het importbestand en de koppeling: UTF-8, puntkomma als scheidingsteken, een kopregel, datums als jaar-maand-dag (2026-11-01) en getallen met een punt (36.5). Zet je het bestand klaar in Excel, volg dan Een Excel-bestand omzetten naar CSV voor een import.
| Kolom | Verplicht bij een nieuwe medewerker | Toelichting |
|---|---|---|
| Identifier | Ja | Personeelsnummer. Hiermee herkent de import of de medewerker al bestaat. |
| Username | Ja | Gebruikersnaam waarmee de medewerker inlogt |
| Name | Ja | Volledige naam |
| Ja | E-mailadres voor berichten uit Benefits Manager | |
| ContractCode | Ja | Contractnummer, meestal gelijk aan het personeelsnummer |
| ContractStart | Ja | Datum in dienst |
| ContractEnd | Nee | Datum uit dienst; leeg bij een lopend contract |
| Basisgegevens (optioneel) | Nee | Eén kolom per gegeven, met de code van het gegeven als kolomnaam, bijvoorbeeld Uurloon
|
De kolomnamen moeten exact zo geschreven zijn, in deze volgorde en met dezelfde hoofdletters. Welke basisgegevens je kunt meegeven en hoe de codes heten, hangt af van de inrichting van je organisatie. Vraag de lijst op via een ticket als je die niet hebt.
Voorbeeld:
Identifier;Username;Name;Email;ContractCode;ContractStart;ContractEnd;Uurloon100234;j.jansen@voorbeeld.nl;Jan Jansen;j.jansen@voorbeeld.nl;100234;2026-11-01;;24.50100187;;;;100187;2024-03-01;2026-11-30;
De eerste regel maakt een nieuwe medewerker aan met een uurloon. De tweede regel beëindigt het contract van een bestaande medewerker per 30 november en laat de overige gegevens ongemoeid.
Wat de import met een regel doet
Nieuwe medewerker (het personeelsnummer bestaat nog niet)
- De medewerker en het contract worden aangemaakt. De medewerker krijgt de rol Medewerker.
- Ontbreekt een van de eerste zes kolommen, dan wordt de regel afgekeurd.
- Een welkomstmail met een link om een wachtwoord in te stellen gaat alleen uit als de instelling Stuur nieuwe gebruikers email aan staat. Standaard staat die uit. Werkt je organisatie met inloggen via SSO, dan is die mail meestal niet nodig.
Bestaande medewerker met een lopend contract
- Username, Name en Email worden alleen bijgewerkt als de cel gevuld is. Een lege cel wist niets.
-
ContractCodeenContractStartzijn verplicht, enContractCodemoet gelijk zijn aan het contractnummer van het lopende contract. Is dat niet zo, dan wordt de regel afgekeurd met de melding dat de medewerker geen contract met dat contractnummer heeft. - De begin- en einddatum van het contract worden bijgewerkt. Zo meld je een medewerker uit dienst.
Bestaande medewerker zonder lopend contract (bijvoorbeeld bij terugkeer in dienst)
- Er wordt een nieuw contract aangemaakt. De eerste zes kolommen zijn dan weer verplicht.
"Lopend" betekent: actief op de dag dat de import draait, niet in de periode die je bij de import kiest.
Basisgegevens in hetzelfde bestand
Extra kolommen na ContractEnd worden als basisgegevens van de medewerker vastgelegd, met de eerste dag van de gekozen periode als ingangsdatum. Een lege cel laat de bestaande waarde staan. Waarom basisgegevens op de eerste van de maand ingaan, lees je in Waarom basisgegevens op de 1e van de maand moeten ingaan (en wanneer de exacte datum telt).
Een nieuwe waarde vervangt ook de waarden die in latere maanden al stonden. Kies je bijvoorbeeld de periode januari terwijl er al waarden voor februari en maart staan, dan geldt na de import vanaf januari de nieuwe waarde en zijn die van februari en maart weg. Importeer met terugwerkende kracht dus alleen als je dat bewust wilt.
De extra vinkjes die je bij een handmatige import ziet (1 periode geldig en lege of 0-waarden toevoegen), werken alleen bij Basisgegevens importeren met BasItemCsvImport: format, ingangsdatum en de vinkjes, niet bij deze import.
Problemen oplossen
De hele import is afgekeurd
Dan klopt de kopregel niet. De eerste zeven kolomnamen moeten exact Identifier;Username;Name;Email;ContractCode;ContractStart;ContractEnd zijn, en elke extra kolomnaam moet een bestaande code van een basisgegeven zijn. Een onbekende code keurt het hele bestand af.
Eén medewerker staat met een foutmelding in de lijst
Elke regel wordt apart verwerkt; de andere medewerkers gaan gewoon door. Bekijk de foutmelding onder Processen > Import medewerker gegevens, zie Processen lezen: stappen, taken en statussen van een import of export (alleen zichtbaar als je bent ingelogd). De meest voorkomende oorzaken:
- een verplichte kolom is leeg bij een nieuwe medewerker;
- het contractnummer wijkt af van dat van het lopende contract;
- de regel heeft meer of minder kolommen dan de kopregel.
Een nieuwe medewerker heeft geen mail ontvangen
Controleer of de instelling Stuur nieuwe gebruikers email aan staat. Staat die uit, dan kan de medewerker op het inlogscherm via Wachtwoord vergeten zelf een link aanvragen. Wil je dat nieuwe medewerkers voortaan automatisch een mail krijgen, vraag dan via een ticket om de instelling aan te zetten.
Een getal is veel te groot geworden
Gebruik een punt als decimaalteken (24.50). Een komma (24,50) wordt gelezen als scheiding van duizendtallen; gebruik dus altijd een punt.
Test een nieuw of gewijzigd bestand altijd eerst op de acceptatieomgeving, zie Een handmatige import starten (alleen zichtbaar als je bent ingelogd).
Kom je er niet uit? Stel je vraag via het contactformulier of reageer op een eerder ingediend ticket, dan kijken we even met je mee.