Nmbrs logoNS Business logo

Lease and mobility

Nmbrs to NS Business integration: employees per company in NS Go, departure on the last working day

With an integration between Nmbrs and NS Business (NS Go), every new employee from Nmbrs appears in NS Go the next day, under the right company and with home address and cost centre. Departures, moves and a change of department in Nmbrs go along automatically, so HR no longer keeps user management in NS Go up to date by hand.

What the integration does

Employers with several entities in one Nmbrs environment that give employees an NS-Business Card through NS Go often add new colleagues to NS Go by hand. If HR picks the wrong entity, costs and the CO2 report end up at the wrong entity.

  1. HR enters the new employee in Nmbrs, at the entity that employs them.
  2. Nmbrs reports the change and KoppelHet prepares the employee for the next NS Go import.
  3. The next day the employee is in NS Go under the right legal entity and cost centre and can request the card.
  4. A move or a different department in Nmbrs reaches NS Go the next day.
  5. The end of employment goes along as soon as HR enters it, and the card stops on that date.
Nmbrs → KoppelHet → NS BusinessSOURCENmbrsTARGETNS BusinessKoppelHetmapping · logging · monitoringNmbrs → KoppelHet → NS BusinessSOURCENmbrsTARGETNS BusinessKoppelHetmapping · logging · monitoring
Out: Employee with employee number, name and email · Company within the Nmbrs environment · Home address · Department and cost centre · Start and end of employment

What to watch for with Nmbrs and NS Business

  • One Nmbrs environment can contain several companies, each with its own employee numbers. NS Go splits users and the CO2 report per legal entity and Chamber of Commerce number. KoppelHet carries the Nmbrs company as the entity, so two employees with the same number at different entities are not mixed up.
  • Someone who leaves one entity in Nmbrs and joins another on an internal transfer would become a new user in NS Go. KoppelHet recognises the same person and moves them to the new entity, so their card and travel history stay.
  • Since July 2024 Nmbrs records the means of transport and fuel type on mileage expense claims, for the work-related mobility report. NS Go produces its own CO2 report for public transport and shared mobility. An employee who also claims public transport in Nmbrs then counts twice; the agreement becomes that public transport only runs through NS Go.
  • Nmbrs has fixed pay codes for travel costs, such as the untaxed public transport allowance. NS Go also reimburses public transport and kilometres through its payroll export. A fixed travel allowance in Nmbrs must therefore stop or go down for people travelling with NS Go; the integration flags new NS Go users who still have one.
  • Nmbrs reports changes immediately, NS Go imports once a day. KoppelHet collects the changes of a day and delivers them at once, so an employee who is changed twice in one day does not end up half-updated in NS Go.
  • In Nmbrs the integration only reads employees, addresses and employments and does not touch salary or payslips. Only what NS Go needs goes to NS Go, without citizen service number or bank account.

How we build and run it

  • The integration runs on the KoppelHet platform, hosted in a data centre in the EU.
  • Every sync and every error is visible in the functional log; on an error your administrator is notified.
  • A change that cannot go through is not half-applied but queued for another attempt.
  • KoppelHet is ISO 27001 certified. Data travels encrypted and stays on the platform no longer than needed.
  • After go-live we manage the integration and adjust it when your process changes.
  • The integration fits next to your existing integration layer. Only the fields in the design are transferred; the platform keeps no register of its own.

Implementation, architecture and compliance

Implementation and price

This is not an app you switch on. We build the integration for your organisation on our platform, with building blocks we reuse on every project. So it is custom work that does not start from scratch.

A consultant prepares the intake and analyses both systems. We then record the mapping and exceptions field by field, test in the test or acceptance environment and go live at a moment you choose. Costs are a one-off amount for the setup and a monthly amount for platform, monitoring and support.

Price indication · Basic

Leave your work email and you see the price indication right away.

We only use your address to follow up on your question about this integration.

Frequently asked questions

Do the travel costs from NS Go go to Nmbrs as well?

That can be added later. The NS Go payroll export holds the amounts per pay code; they can reach Nmbrs as wage components. We start with the employees, because a forgotten departure costs the most.

What if an employee wants to change their address in NS Go?

NS Go refers them to HR. HR changes the address in Nmbrs, or the employee does so through Nmbrs self-service, and the next day it is in NS Go.

Does an internal transfer belong to the new or the old entity in NS Go?

From the start date at the new entity the employee belongs to the new entity. Trips before that stay with the old entity in the report.

Technical details for IT

For those who want to know how it works under the hood: APIs, fields and sources used.

  • Nmbrs is read through the Nmbrs REST API with OAuth 2.0 and read-only scopes for employees, addresses, employments and the company structure, per company; webhooks on changes. The SOAP API stops on 1 March 2027.
  • According to NS, NS Go supports a daily import of a data file or a direct API connection for joiners, leavers, role and address. NS publishes no technical API documentation; format and fields are agreed per customer with NS.

Which fields are transferred

The key fields. The full mapping is agreed per customer.

Field in NmbrsField in NS BusinessNotes
Bedrijf en personeelsnummerPersoneelsnummerEmployee numbers in Nmbrs are per company; together they form the key
RoepnaamVoornaam
Tussenvoegsel en achternaamAchternaam
Zakelijk e-mailadresE-mailadres
WoonadresThuisadres
BedrijfJuridische entiteitThrough a table from Nmbrs company to Chamber of Commerce number
Afdeling en kostenplaatsKostenplaats
Begin- en einddatum dienstverbandStart- en einddatum dienstverband

Related

Which systems do you want to connect?

Tell us which systems you use and what should happen automatically. Together we define the smallest working solution, with a clear design and a quote before building.