Benefits Manager rekent met gegevens uit je personeels- of salarissysteem: wie in dienst is, met welk contract, salaris, deeltijdfactor, verlofrechten en andere basisgegevens. Die komen periodiek binnen via een import. Dit artikel beschrijft de manieren waarop je kunt aanleveren, hoe het standaard CSV-bestand eruitziet, hoe je een import controleert en wat je doet als er iets misgaat.
Manieren van aanleveren
- Bestand via SFTP. Je zet periodiek een CSV-bestand op de SFTP-locatie die je bij de inrichting hebt ontvangen. Benefits Manager haalt het bestand op volgens een gepland proces, verwerkt het en verwijdert het van de SFTP-locatie.
- Directe koppeling. Voor een aantal systemen halen we de gegevens rechtstreeks op, onder meer AFAS, Nmbrs, Visma, Exact, Workday, SAP SuccessFactors en systemen met een SOAP- of REST-koppeling. De inrichting daarvan is maatwerk en staat in je inrichtingsdocument.
- Handmatig. Voor een eenmalige aanvulling of correctie kun je zelf een bestand importeren via Processen > Handmatige import starten (zie dat artikel).
Welke velden uit je bronsysteem op welke gegevens in Benefits Manager landen, staat vast in de importmapping die tijdens de implementatie is gemaakt. Wijzigingen daarin lopen via een ticket.
Het standaard CSV-bestand
Gebruik je het standaardformaat, dan gelden deze eisen:
- Tekenset UTF-8, scheidingsteken puntkomma (;), geen aanhalingstekens.
- Eerste regel is de kopregel met de kolomnamen, exact zoals afgesproken.
- Datums bij voorkeur als jaar-maand-dag (2026-01-01); dag-maand-jaar (01-01-2026) wordt ook gelezen.
- Getallen met een punt als decimaalteken (36.5). Dit geldt voor het standaardformaat. Heeft je organisatie een eigen importformaat, dan kan een komma het decimaalteken zijn (36,5) en wordt een punt gelezen als scheiding van duizendtallen: 0.8 wordt dan 8. Volg in dat geval het voorbeeldbestand van je inrichting.
- Eén regel per medewerker. Dubbele personeelsnummers of gebruikersnamen worden afgekeurd.
- Geen lege regels, ook niet tussen de medewerkers. Een regel met alleen scheidingstekens geeft een foutregel.
Voor een gebruikersbestand zijn de eerste kolommen vast: Identifier;Username;Name;Email;ContractCode;ContractStart;ContractEnd, gevolgd door de basisgegevens die voor jouw inrichting zijn afgesproken. Voor een bestand met alleen basisgegevens begint elke regel met Identifier, gevolgd door de gegevens.
| Kolom | Betekenis |
|---|---|
| Identifier | Personeelsnummer; uniek en blijvend per medewerker |
| Username | Gebruikersnaam waarmee de medewerker inlogt; bij SSO exact gelijk aan wat de identity provider meestuurt |
| Name | Volledige naam |
| E-mailadres voor berichten uit Benefits Manager | |
| ContractCode | Contractnummer; meestal gelijk aan het personeelsnummer |
| ContractStart | Datum in dienst |
| ContractEnd | Datum uit dienst; leeg bij een lopend contract |
Krijgt een medewerker een nieuw contract met een nieuw personeelsnummer terwijl de gebruikersnaam gelijk blijft, lever dan het oude account aan met een einddatum en een aangepaste gebruikersnaam, en het nieuwe account apart. Anders ontstaan er twee gebruikers met dezelfde gegevens.
Een voorbeeldbestand met jullie kolommen heb je bij de inrichting ontvangen; vraag het anders op via een ticket.
Wat er na het ophalen gebeurt
- Het bestand of het antwoord van de koppeling wordt opgesplitst in losse regels, één per medewerker.
- Elke regel wordt apart verwerkt: nieuwe medewerkers worden aangemaakt, bestaande bijgewerkt, contracten gestart of beëindigd, basisgegevens vastgelegd met de periode als ingangsdatum. Een fout bij één medewerker houdt de andere medewerkers niet tegen.
- Is er een vervolgstap ingericht, bijvoorbeeld het koppelen van managers aan medewerkers, dan draait die nadat alle regels zijn verwerkt.
- Is de statusmail ingericht, dan ontvangen de afgesproken adressen na elke import een bericht met het resultaat. Welke adressen dat zijn, stelt BCS in; geef via een ticket door wie de mail moet ontvangen.
Gegevens uit de import overschrijven wat er in Benefits Manager staat, ook handmatige wijzigingen door een beheerder. Corrigeer daarom altijd in het bronsysteem.
Een import controleren
Ga naar Processen > Import medewerker gegevens (rol Import inzien) en open de import. Je ziet daar:
- Importbestand downloaden. Hiermee download je het bestand zoals het is aangeleverd of opgehaald.
- Een tabel met één regel per medewerker. De kolom Importgegevens laat zien wat er voor die medewerker is binnengekomen. De kolom Foutmelding laat zien waarom een regel niet is verwerkt. Staat er bij Naam en Email "Error", dan kon het systeem de medewerker niet vinden of niet verwerken.
- De downloadknop boven de tabel. Hiermee download je alle regels als Excel-bestand. Een zoekopdracht of filter die je in de tabel hebt ingesteld, geldt ook voor de download.
Controleer fouten altijd in deze tabel. In het overzicht van de taken van een import tellen niet alle fouten mee: een regel die al bij het ophalen misgaat, staat wel in de tabel maar niet bij de taken. Controleer fouten daarom altijd in de tabel per medewerker.
Het importbestand bevat alleen één zin
Bij sommige koppelingen vraagt Benefits Manager de gegevens per medewerker op bij het bronsysteem, bijvoorbeeld de manager van elke medewerker. Er is dan geen bestand. Omdat elke import toch een bestand nodig heeft, maakt het systeem een bestand met één vaste zin, zoals "De informatie voor deze import wordt verkregen in de SplitData". Dat is geen fout en er ontbreken geen gegevens. Wat er per medewerker is opgehaald, zie je in de kolom Importgegevens van de tabel.
Wanneer neem je contact op
- De import is mislukt of heeft foutregels die je niet kunt verklaren. Vermeld de datum van de import en een voorbeeld van een medewerker met een foutmelding.
- Je wilt een kolom toevoegen of de mapping wijzigen.
- Je SFTP-gegevens werken niet meer of moeten worden vernieuwd.
- Je wilt de import vaker of op een ander moment laten draaien.
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.