Een medewerker is in dienst, staat in het bronsysteem, maar is niet zichtbaar in Benefits Manager. Er zijn een paar oorzaken die dit vrijwel altijd verklaren, en je kunt de meeste zelf herkennen in de import.
Medewerkersaccounts horen via de import te ontstaan. Een handmatig aangemaakt account krijgt geen basisgegevens en botst bij de eerstvolgende import met het account dat de import wil aanmaken. De oplossing bestaat er dus altijd uit dat de gegevens correct worden aangeleverd en de import opnieuw wordt ingelezen.
De drie sleutels die de import gebruikt
- ID (identificatienummer, meestal het personeelsnummer): hierop herkent de import een bestaand account. Bestaat het ID al, dan wordt het bestaande account bijgewerkt; gebruikersnaam, e-mailadres en naam worden dan overschreven met wat het bestand meelevert. Bestaat het ID niet, dan maakt de import een nieuw account aan.
- Gebruikersnaam: verplicht en uniek in de hele omgeving. Meestal het zakelijke e-mailadres.
- Contractcode: bepaalt bij welk contract de gegevens horen.
Het e-mailadres is geen sleutel en hoeft niet uniek te zijn. Bij sommige koppelingen, bijvoorbeeld met Nmbrs, wordt het e-mailadres wel als gebruikersnaam gebruikt en geldt de uniciteit dus alsnog.
Eerst kijken: staat de medewerker misschien al in het systeem
Voordat je de import induikt, twee snelle controles onder Gebruikers:
- Zet het filter Status op Inactief, of haal het weg. De lijst toont standaard alleen actieve medewerkers. Een medewerker met een startdatum in de toekomst, of een oud account met een einddatum in het verleden, zie je dan niet.
- Zoek op naam en op e-mailadres. Vind je een oud account met dezelfde gebruikersnaam, dan heb je de oorzaak waarschijnlijk al gevonden (zie stap 3).
1. Controleer of de medewerker in het importbestand staat
Ga naar Processen > Import medewerker gegevens en open de import van de betreffende periode. Zoek de medewerker op in de tabel met importregels of in het gedownloade bestand.
- Staat de medewerker er niet in? Dan ligt de oorzaak in het bronsysteem. De medewerker moet daar eerst correct worden klaargezet voor uitwisseling.
- Staat de medewerker er wel in, maar is er geen account? Kijk naar de kolom Foutmelding van die regel en ga verder met stap 2 en 3.
2. De foutmeldingen en wat ze betekenen
| Foutmelding bij de importregel | Oorzaak | Wat je doet |
|---|---|---|
| Cannot import a user with an empty username | De gebruikersnaam ontbreekt in het bestand. Veruit de meest voorkomende oorzaak. | Laat het veld in het bronsysteem vullen. Vergelijk de regel met die van een collega die wel goed is aangemaakt. |
| ... bestaat al. Wijzig dit gegeven en sla opnieuw op. | De gebruikersnaam (of het ID) komt al voor bij een ander account. | Zie stap 3. |
| Could not parse date ... | Een datum ontbreekt of heeft een verkeerd formaat, meestal de datum in dienst. | Laat de datum in het bronsysteem vullen in het afgesproken formaat. |
| The user import data could not be processed | De regel kon niet worden verwerkt, vaak door een van de oorzaken hierboven. | Kijk naar de overige kolommen van de regel en naar de voorgaande meldingen. |
| Geen foutmelding, medewerker toch onzichtbaar | De gebruiker bestaat al maar heeft geen actieve rol Benefits Shop. De import werkt hem bij, maar de lijst toont hem niet. | Een beheerder die de rol zelf ook heeft, kan hem opnieuw toekennen. Anders maak je een ticket aan en zet support de rol terug. Zie ook Beheerders toevoegen, wijzigen en intrekken (alleen zichtbaar als je bent ingelogd). |
Controleer fouten altijd in de tabel met importregels.
3. De gebruikersnaam bestaat al: herindiensttreding en dubbele accounts
Een gebruikersnaam en een ID mogen maar één keer voorkomen. Dit speelt in deze situaties:
- Een medewerker komt terug of krijgt een nieuw personeelsnummer, bijvoorbeeld na pensionering, na een stage, bij een nieuw contract of bij een overstap naar een andere werkmaatschappij in het bronsysteem. Het oude account bestaat nog met dezelfde gebruikersnaam. Stuurt het bronsysteem hetzelfde ID als vroeger, dan is er geen probleem: het oude account wordt bijgewerkt.
- Twee verschillende personen met dezelfde naam. Bij een afgeleide gebruikersnaam kunnen die botsen.
- Het e-mailadres hoort al bij een beheerdersaccount dat ooit los is aangemaakt. Bij koppelingen die het e-mailadres als gebruikersnaam gebruiken, botst de import daarop.
De werkwijze bij een botsing: maak de gebruikersnaam (en bij een nieuw ID ook het ID) van het oude account uniek door er een herkenbaar achtervoegsel aan toe te voegen, bijvoorbeeld _OLD. Dat doe je onder Gebruikers bij het oude account via Wijzigen. Pas ook het e-mailadres aan, zodat er geen mails meer naar het oude account gaan. Daarna kan de import het nieuwe account aanmaken; dat gebeurt bij de eerstvolgende import, of laat de import van de betreffende periode opnieuw inlezen.
Let daarbij op:
- Staat het oude account ook nog in het importbestand, dan maakt de import het bij de volgende run gewoon opnieuw aan, en botst het nieuwe account alsnog. Zorg dat het bronsysteem het oude dienstverband met een einddatum aanlevert, of niet meer aanlevert.
- Gegevens over eerdere maanden krijgt het nieuwe account niet automatisch. Stond de medewerker in eerdere maanden al in het bestand, laat die imports dan opnieuw inlezen of vul de basisgegevens handmatig aan.
- Het nieuwe account begint met een nieuw contract. Budgetopbouw en saldi beginnen dan vanaf de nieuwe startdatum. Moet een saldo meeverhuizen, laat dat dan corrigeren via een ticket.
Overleg intern of het bronsysteem het oude nummer hergebruikt bij een herindiensttreding. Als dat de standaard werkwijze is, komt deze situatie niet voor.
4. Let op de periode waarin de gegevens worden ingelezen
Een account krijgt alleen basisgegevens uit de imports die na het aanmaken zijn ingelezen. Stond de medewerker in eerdere maanden nog niet in het bestand, dan ontbreken die maanden en moet je die alsnog laten inlezen of handmatig aanvullen.
Gegevens uit een import krijgen de periode van die import als ingangsdatum. Wordt een nieuwe medewerker ingelezen nadat de keuzeperiode al is gesloten, dan kunnen zijn gegevens bij sommige inrichtingen pas met de volgende periode ingaan. De medewerker ziet dan in de lopende periode nog geen budget of, in Waar ik werk, een afstand van 0 kilometer. Dat herstelt zich bij de volgende periode; moet het eerder, maak dan een ticket aan.
Wat er gebeurt bij het aanmaken
Een nieuw account krijgt de rol Benefits Shop en daarmee toegang tot de Benefits Shop, en ontvangt, afhankelijk van de inrichting van jouw omgeving, een welkomstmail om een wachtwoord in te stellen. Bij single sign-on is geen wachtwoord nodig.
Een medewerker toevoegen via Beheerder toevoegen is geen oplossing voor dit probleem. Daarmee maak je een beheerdersaccount aan, geen medewerkersaccount met budget en keuzes. Zie Beheerders toevoegen, wijzigen en intrekken (alleen zichtbaar als je bent ingelogd) voor het verschil.
Zie ook Medewerkergegevens aanleveren: het importbestand en de koppeling (alleen zichtbaar als je bent ingelogd) over het importbestand en de controle van een import.
Problemen oplossen
Een nieuwe medewerker staat niet onder Gebruikers
- Zet onder Gebruikers het filter Status op Inactief, of haal het weg, en zoek op naam en op e-mailadres.
- Controleer of de medewerker in het importbestand staat (stap 1). Staat de medewerker er niet in, dan ligt de oorzaak in het bronsysteem.
- Staat de medewerker er wel in zonder foutmelding, dan ontbreekt waarschijnlijk een actieve rol Benefits Shop. Een beheerder die de rol zelf ook heeft, kan hem opnieuw toekennen. Anders maak je een ticket aan en zet support de rol terug.
De import meldt dat de gebruikersnaam al bestaat
- Zoek onder Gebruikers het oude account met dezelfde gebruikersnaam.
- Maak de gebruikersnaam (en bij een nieuw ID ook het ID) van het oude account uniek, bijvoorbeeld met
_OLD, en pas het e-mailadres aan (stap 3). - Controleer of het oude account nog in het importbestand staat. Zo ja, dan botst het nieuwe account bij de volgende run alsnog.
De medewerker staat in het bestand maar heeft geen account
- Kijk in de tabel met importregels naar de kolom Foutmelding van die regel, niet alleen naar het overzicht van de taken.
- Zoek de melding op in de tabel bij stap 2 en laat het bronsysteem het ontbrekende of verkeerde gegeven vullen.
- Laat daarna de import van de betreffende periode opnieuw inlezen.
Een nieuwe medewerker ziet geen budget of 0 km
- Controleer wanneer de medewerker is ingelezen. Na het sluiten van de keuzeperiode kunnen de gegevens bij sommige inrichtingen pas met de volgende periode ingaan (stap 4).
- Stond de medewerker in eerdere maanden nog niet in het bestand, laat die imports dan opnieuw inlezen of vul de basisgegevens handmatig aan.
- Moet het eerder dan de volgende periode, maak dan een ticket aan.
Vermeld in een ticket de naam en het ID van de medewerker, de naam van het importbestand waarin de medewerker staat en de foutmelding die bij de importregel wordt getoond. Daarmee kan support de betreffende import gericht opnieuw inlezen.
Lukt het niet? Maak een ticket aan via het contactformulier (zie Werken met het Customer Portal: tickets en kennisbank (alleen zichtbaar als je bent ingelogd)).