Met de import BasItemCsvImport lees je basisgegevens van bestaande medewerkers in, zoals een uurloon, een deelnamevinkje of een eenmalig bedrag. Dit artikel legt uit hoe het bestand eruitziet, vanaf wanneer een waarde geldt en wat de vinkjes 1 periode geldig en Voeg lege of 0-waarden toe in de toekomst doen.
In het kort
- De eerste kolom heet
Identifier(het personeelsnummer). Daarna volgt één kolom per basisgegeven, met de code van het gegeven als kolomnaam. - De medewerker moet al bestaan en een lopend contract hebben. Nieuwe medewerkers maak je aan met Gebruikers importeren met UserCsvImport: nieuwe medewerkers, wijzigingen en uitdienst.
- Een waarde geldt vanaf de eerste dag van de periode die je bij de import kiest.
- Zonder vinkje blijft de waarde gelden tot er een nieuwe komt. Met 1 periode geldig geldt de waarde alleen in die ene maand.
- Een lege cel verandert niets.
Het bestand
Identifier;Uurloon;Studieschuld_Deelnemen100234;24.50;True100187;;False
- UTF-8, puntkomma als scheidingsteken, de eerste regel is de kopregel. Zie ook Medewerkergegevens aanleveren: het importbestand en de koppeling en, als je in Excel werkt, Een Excel-bestand omzetten naar CSV voor een import.
- Getallen met een punt (24.50). Een komma (24,50) wordt gelezen als scheiding van duizendtallen; gebruik dus altijd een punt.
-
Ja/nee-waarden als
TrueofFalse. - Datums als jaar-maand-dag (2026-11-01).
- Elke regel heeft evenveel kolommen als de kopregel.
Welke codes je kunt gebruiken, hangt af van de inrichting van je organisatie. Een onbekende code in de kopregel keurt het hele bestand af. Vraag de lijst met codes op via een ticket als je die niet hebt.
Vanaf wanneer een waarde geldt
Je kiest bij de import een periode (maand en jaar). De waarde geldt vanaf de eerste dag van die maand, ook als de medewerker halverwege de maand in dienst kwam. Waarom dat zo werkt, lees je in Waarom basisgegevens op de 1e van de maand moeten ingaan (en wanneer de exacte datum telt).
Wat er daarna gebeurt, hangt af van de vinkjes:
| Keuze | Wat er gebeurt | Gebruik het voor |
|---|---|---|
| Geen vinkje | De waarde geldt vanaf de gekozen maand en blijft gelden tot er een nieuwe waarde komt. | Een blijvende wijziging, zoals een nieuw uurloon |
| 1 periode geldig | De waarde geldt alleen in de gekozen maand. Vanaf de maand erna geldt weer de waarde van daarvoor. | Een tijdelijke afwijking in één maand |
| 1 periode geldig én Voeg lege of 0-waarden toe in de toekomst | De waarde geldt alleen in de gekozen maand. Vanaf de maand erna is het gegeven leeg (bij een getal 0). | Een eenmalig bedrag dat niet mag doorlopen |
Het tweede vinkje verschijnt pas als je 1 periode geldig aanzet.
Zonder vinkje vervangt een nieuwe waarde ook de waarden die in latere maanden al stonden. Kies je 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. Wil je alleen één maand met terugwerkende kracht corrigeren, gebruik dan 1 periode geldig.
Hoe je de import start
- Ga in de Administrator Module naar Processen > Handmatige import starten.
- Kies het importtype BasItemCsvImport.
- Kies de periode waarvanaf de waarde moet gelden.
- Zet zo nodig de vinkjes uit de tabel hierboven.
- Kies het bestand en start de import.
Meer over de handmatige import lees je in Een handmatige import starten. BasItemCsvImport kan ook gepland draaien met een bestand via SFTP; dat richt BCS voor je in.
Waar je op let
- De periodieke import wint. Levert de import uit je salaris- of HR-systeem hetzelfde gegeven aan, dan overschrijft die bij de volgende run jouw waarde. Een blijvende correctie hoort dan in het bronsysteem.
-
Leegmaken lukt niet met een lege cel. Een lege cel laat de bestaande waarde staan. Wil je een getal op nul zetten, vul dan
0in. - Lopend contract. De medewerker moet een contract hebben dat actief is op de dag dat de import draait. Een medewerker die al uit dienst is, krijgt een foutmelding.
Problemen oplossen
De hele import is afgekeurd
Controleer de kopregel. De eerste kolom moet exact Identifier heten, en elke andere kolomnaam moet een bestaande code van een basisgegeven zijn.
Een medewerker staat met een foutmelding in de lijst
Bekijk de melding onder Processen > Import medewerker gegevens, zie Processen lezen: stappen, taken en statussen van een import of export (alleen zichtbaar als je bent ingelogd). Vaak gaat het om een personeelsnummer dat niet bestaat, een medewerker zonder lopend contract of een regel met een afwijkend aantal kolommen.
Een waarde loopt door in de maanden erna
Dan is de import zonder 1 periode geldig gedraaid. Draai de import opnieuw voor de juiste maand met 1 periode geldig, en zo nodig ook met het tweede vinkje.
Waarden in latere maanden zijn verdwenen
Dan is er met terugwerkende kracht geïmporteerd zonder 1 periode geldig. Lever de waarden voor die latere maanden opnieuw aan, of maak een ticket aan, dan kijken we mee.
Test een nieuw of gewijzigd bestand altijd eerst op de acceptatieomgeving.
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.