X4HR naar ITSM
Nmbrs Xurrent koppeling: personen per bv en verzoeken uit een sjabloon in Xurrent (4me)
Met een koppeling tussen Nmbrs en Xurrent (voorheen 4me) staat elke medewerker uit jullie Nmbrs-bedrijven als persoon in Xurrent, in de organisatie van zijn bv en afdeling, met functie en manager. Bij een nieuw dienstverband, een wissel per salarisperiode of een datum uit dienst maakt KoppelHet een verzoek uit jullie Xurrent-sjabloon, en na de laatste werkdag wordt de persoon uitgeschakeld.
Wat de koppeling doet
Organisaties met meerdere bv's in Nmbrs en een servicedesk in Xurrent zetten personen er vaak in met een periodieke import of SCIM uit de identity provider. Wie nog geen account heeft, ontbreekt daarin, en bij welke bv iemand hoort voor doorbelasting van hardware staat nergens.
- De salarisadministratie voert de medewerker in bij het juiste Nmbrs-bedrijf.
- Zodra het werkadres bekend is, maakt KoppelHet de persoon aan in de organisatie van zijn afdeling, onder de business unit van zijn bv.
- Binnen de afgesproken termijn voor de datum in dienst volgt het onboardingverzoek uit het sjabloon, voor de nieuwe persoon.
- Een wissel per de volgende salarisperiode geeft een verzoek met de eerste dag van die periode als gewenste afronddatum.
- Bij een datum uit dienst komt het offboardingverzoek; na de laatste werkdag wordt de persoon uitgeschakeld.
Waar je op let bij Nmbrs en Xurrent (4me)
- Elke bv in Nmbrs wordt in Xurrent een business unit, met de afdelingen van die bv als organisaties eronder. Omdat afdelingen in Nmbrs bij een bedrijf horen, hoort een afdeling Service van bv A nooit bij die van bv B, en rapporten in Xurrent zijn per bv te maken.
- Xurrent slaat geen persoon op zonder e-mailadres, en een salarisadministratie voert een nieuwe medewerker vaak in voordat IT het werkadres kent. KoppelHet houdt de persoon daarom vast tot het zakelijke adres in Nmbrs staat; het onboardingverzoek wordt intussen ingediend door de manager, zodat IT niet hoeft te wachten.
- Nmbrs houdt per salarisperiode een kostenplaats bij. Xurrent heeft bij een organisatie een veld voor de financiële code. KoppelHet vult dat met de kostenplaats van de afdeling, zodat doorbelasting van hardware per bv dezelfde code gebruikt als het loonjournaal.
- Personeelsnummers zijn in Nmbrs per bedrijf uniek. KoppelHet zet bedrijfscode en nummer samen in het employeeID van Xurrent, en noteert Nmbrs als bron, zodat een import uit een ander systeem deze personen herkent en niet overschrijft.
- Komt een oud-medewerker terug onder hetzelfde Nmbrs-nummer, dan schakelt KoppelHet de bestaande persoon in Xurrent weer in in plaats van een nieuwe aan te maken. Zijn eerdere verzoeken en configuratie-items blijven zo bij hem.
- Een import in Xurrent die alleen op e-mailadres matcht, overschrijft alle velden van die persoon. Staan medewerkers er al via zo'n import of via SCIM, dan koppelt KoppelHet ze eenmalig op werkadres, laat jullie de lijst controleren en schakelt daarna over op het Nmbrs-nummer.
- Een functiewissel per de volgende periode staat al in Nmbrs voordat hij ingaat. KoppelHet maakt het verzoek direct, maar met de eerste dag van die periode als gewenste afronddatum, zodat IT rechten op tijd klaarzet en niet te vroeg wijzigt.
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
Kunnen we SCIM uit Entra ID houden?
Ja, als we per veld afspreken welke bron wint. Nmbrs levert dan bv, afdeling, kostenplaats en datums; de identity provider het account.
Gaan loon of BSN naar Xurrent?
Nee. De koppeling leest alleen persoons-, dienstverband- en organisatiegegevens.
Ons administratiekantoor beheert Nmbrs. Wat merken zij?
Ze maken eenmalig een login op werkgeversniveau en geven toestemming voor jullie bedrijven. Daarna niets meer.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Nmbrs wordt gelezen via de Nmbrs REST API met OAuth 2.0 en alleen leesscopes voor medewerker- en dienstverbandgegevens en de bedrijfsstructuur, per bedrijf; webhooks bij wijzigingen. De SOAP API stopt per 1 maart 2027.
- Naar Xurrent via de REST API met een OAuth-token en de header X-Xurrent-Account. Personen via /people (primary_email verplicht, employeeID, job_title, organization, manager, disabled, source en sourceID), organisaties via /organizations (parent, business_unit, financialID, manager). Het token krijgt nooit meer rechten dan de rollen van het integratieaccount.
- Verzoeken via POST /requests met requested_for, requested_by, subject, category, team en template, plus desired_completion_at en custom_fields voor de UI-extensie van het sjabloon.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Nmbrs | Veld in Xurrent (4me) | Toelichting |
|---|---|---|
Bedrijfscode + personeelsnummer | employeeID en sourceID (source Nmbrs) | Nummers zijn in Nmbrs alleen per bedrijf uniek |
Voornaam, tussenvoegsel en achternaam | name | |
Zakelijk e-mailadres | primary_email | Verplicht in Xurrent |
Functie (huidige periode) | job_title | |
Bedrijf | organization met business_unit | |
Afdeling (huidige periode) | organization met het bedrijf als parent | |
Kostenplaats | financialID van de organisatie | |
Leidinggevende (e-mailadres) | manager van de person | |
Indiensttreding, wissel of vertrek | Request met template, requested_for en desired_completion_at | |
Datum uit dienst verstreken | disabled = true |
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