Accounts in applicaties
Nmbrs Magister koppeling: personeelsaccounts in Magister vanuit de salarisadministratie in Nmbrs
Met een koppeling tussen Nmbrs en Magister krijgt elke nieuwe medewerker die de salarisadministratie in Nmbrs invoert automatisch een personeelsaccount in Magister, met personeelsnummer, werkmail en afdeling. De einddatum van het dienstverband in Nmbrs wordt de vervaldatum in Magister, en daarna blokkeert KoppelHet het account.
Wat de koppeling doet
Scholen die de salarissen in Nmbrs verwerken en Magister als leerlingadministratie gebruiken, hebben geen apart HR-systeem dat accounts aanstuurt. De salarisadministratie weet als eerste wie er begint en vertrekt, maar het Magister-account wordt los daarvan met de hand gemaakt en geblokkeerd.
- KoppelHet vraagt bij Magister een partnerclient met alleen de scopes voor personeelsaccounts aan, en de school maakt een Nmbrs-token voor KoppelHet.
- De salarisadministratie voert de nieuwe medewerker in Nmbrs in, met afdeling en werkmail.
- KoppelHet vergelijkt dagelijks de medewerkers per Nmbrs-bedrijf met de vorige stand en maakt voor nieuwe medewerkers een account in Magister aan.
- Een einddatum in Nmbrs wordt de vervaldatum van het account.
- Na de einddatum blokkeert KoppelHet het account.
Waar je op let bij Nmbrs en Magister
- Nmbrs geeft medewerkers per bedrijf terug en heeft geen lijst met alleen de wijzigingen. KoppelHet haalt daarom per bedrijf alle dienstverbanden en personalia op, vergelijkt die met de vorige ronde en stuurt alleen nieuwe medewerkers en nieuwe einddatums naar Magister.
- Een personeelsnummer is in Nmbrs uniek binnen een bedrijf, niet over bedrijven heen. Heeft een stichting meerdere Nmbrs-bedrijven onder één Magister-omgeving, dan spreekt KoppelHet een voorvoegsel per bedrijf af, zodat twee medewerkers met hetzelfde nummer niet aan dezelfde personeelsregistratie in Magister hangen.
- Nmbrs heeft een uitvraag van personalia zonder BSN. KoppelHet gebruikt die, zodat het burgerservicenummer de salarisadministratie niet verlaat; Magister heeft het voor een account ook niet nodig.
- Nmbrs kent een zakelijk en een privé e-mailadres, en Magister neemt er maar één aan, alleen bij het aanmaken. KoppelHet gebruikt alleen het zakelijke adres en wacht met aanmaken tot het in Nmbrs is ingevuld.
- Een einddatum staat in Nmbrs op het dienstverband en is vaak al vóór de laatste salarisrun bekend. KoppelHet zet die datum meteen als vervaldatum in Magister, zodat de toegang ook stopt als niemand eraan denkt.
- Afdelingen hebben in Nmbrs een historie per periode, en Magister neemt de afdeling alleen bij het aanmaken aan. Verandert de afdeling van een medewerker in Nmbrs, dan meldt KoppelHet dat aan de Magister-beheerder in plaats van het account aan te passen.
- Nmbrs zet de SOAP API, waar deze gegevens nu uit komen, per 1 maart 2027 uit. KoppelHet stapt over op de REST API van Nmbrs; voor Magister en voor de school verandert daardoor niets.
Deze koppeling hoort ook bij in-, door- en uitstroom.
Hoe we het bouwen en beheren
- De koppeling draait op het KoppelHet platform, gehost in een datacenter in de EU.
- Elke synchronisatie en elke fout is zichtbaar in de functionele logging; bij een fout krijgt jullie beheerder een melding.
- Een mutatie die niet door kan, wordt niet half doorgezet maar klaargezet om opnieuw te proberen.
- KoppelHet is ISO 27001-gecertificeerd. Gegevens gaan versleuteld over en blijven niet langer op het platform dan nodig.
- Na livegang beheren wij de koppeling en passen we hem aan als jullie proces verandert.
- De koppeling past naast je bestaande integratielaag. Alleen de velden uit het ontwerp gaan over; het platform houdt geen eigen registratie bij.
Implementatie en prijs
Dit is geen app die je aanzet. We bouwen de koppeling voor jullie organisatie op ons platform, met bouwstenen die we steeds opnieuw gebruiken. Zo is het maatwerk, zonder dat we bij nul beginnen.
Een consultant bereidt de intake voor en analyseert beide systemen. Daarna leggen we de mapping en uitzonderingen per veld vast, testen we in de test- of acceptatieomgeving en gaan we live op een moment dat jij kiest. De kosten bestaan uit een eenmalig bedrag voor de inrichting en een maandbedrag voor platform, monitoring en beheer.
Veelgestelde vragen
Is Nmbrs wel de goede bron voor Magister-accounts?
Als Nmbrs jullie enige personeelsadministratie is wel. De salarisadministratie heeft de startdatum en einddatum als eerste; zonder werkmail wacht de koppeling.
Waarom dagelijks en niet direct?
Nmbrs meldt geen wijzigingen. Eén vergelijking per dag is genoeg, omdat de startdatum meestal ruim vooraf bekend is.
Worden leerlingen ook gekoppeld?
Nee. Via de SCIM-API kunnen alleen personeelsaccounts worden aangemaakt.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Nmbrs via de SOAP EmployeeService - PersonalInfoWithoutBSN_Get_GetAllEmployeesByCompany (EmployeeNumber, FirstName, Nickname, Prefix, LastName, EmailWork), Employment_GetAll_AllEmployeesByCompany (StartDate, EndDate) en Department_GetAll_AllEmployeesByCompany. De SOAP API stopt per 1 maart 2027; daarna via de REST API met OAuth 2.0.
- Magister via de SCIM-API (SCIM v2.0) - POST User (alleen personeel) met name, emails, employeeCode en organizationalUnits; PATCH User voor blocked en expiresOn; SEARCH op employeeCode om dubbele accounts te voorkomen. Scopes iam.scim.user.read, iam.scim.user.create, iam.scim.user.manage en iam.scim.user.attributes.manage. Client via magister.nl/partners.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Nmbrs | Veld in Magister | Toelichting |
|---|---|---|
EmployeeNumber | employeeCode | Uniek maken als er meer Nmbrs-bedrijven zijn; alleen bij aanmaken |
Nickname of FirstName, Prefix en LastName | name | Alleen bij aanmaken |
EmailWork | emails | Eén adres, alleen bij aanmaken |
Afdeling | organizationalUnits | Vertaaltabel; alleen bij aanmaken |
EndDate van het dienstverband | expiresOn | |
Einddatum verstreken | MagisterIamUser.blocked |
Gerelateerd
ADP Workforce Now → Nmbrs
ADP Workforce Now Nmbrs koppeling: de Nederlandse payrollgroep uit ADP in het juiste Nmbrs-bedrijf
AlexisHR → Nmbrs
AlexisHR (Simployer One) Nmbrs koppeling: Nederlandse medewerkers in de salarisadministratie
BambooHR → Nmbrs
BambooHR Nmbrs koppeling: Nederlandse salarisadministratie naast een globaal HR-systeem
Bullhorn → Nmbrs
Bullhorn Nmbrs koppeling: plaatsingen met uurloon en einddatum in de verloning