Lease and mobility
SAP SuccessFactors to NS Business integration: Employee Central decides who travels in NS Go, with legal entity and addresses
With an integration between SAP SuccessFactors and NS Business (NS Go), the employees of the Dutch legal entities in Employee Central appear in NS Go automatically, with home address, work location and the legal entity for CO2 reporting. A departure or move that HR records ahead of time in SuccessFactors is also in NS Go ahead of time, so the subscription stops or changes on time.
What the integration does
Organisations that use Employee Central and let Dutch colleagues travel with NS Go fill NS Go with exports from SuccessFactors. People who move house or to another site sometimes keep a subscription that no longer fits for months, and the CO2 report per legal entity is only right after a manual check.
- HR saves a new employee in Employee Central at a Dutch legal entity.
- KoppelHet fetches the employee with home address, work location, company and cost centre, even if the start date is in the future.
- The employee is included in the daily delivery to NS Go, under the legal entity that matches their company.
- A new home address or another work location goes to NS Go with the effective date from SuccessFactors.
- A termination goes to NS Go as soon as HR saves it, with the end date recorded in Employee Central.
What to watch for with SAP SuccessFactors and NS Business
- NS Go reports work-related mobility per Chamber of Commerce number. In Employee Central the legal entity is a company in the foundation data, without a fixed field for the Chamber of Commerce number. KoppelHet keeps the matching number per Dutch company, so every trip lands in the right report.
- Addresses in Employee Central have an effective date, and the API merges the country fields of all countries into one address object. KoppelHet takes the Dutch home address valid on the effective date, with street, house number and postcode in the form NS Go expects.
- By default the OData API only returns today's record. A move on the first of next month or a termination in three weeks therefore only arrives on the day itself. KoppelHet also requests future records, so NS Go can already show a departure ahead of time.
- An employee's office is in Employee Central as a location on the job information, with the address held on that location. KoppelHet sends that address as office address to NS Go. If someone moves to another location, NS Go gets the new office address and the employee can see whether their subscription still fits.
- With a global assignment someone gets a second employment at the host entity in Employee Central. If a colleague from abroad comes to a Dutch legal entity temporarily, KoppelHet puts them in NS Go for the duration of that assignment.
- In NS Go employees cannot change their personal data themselves. If employee self-service for addresses is enabled in SuccessFactors, the employee changes their address there, and it is in NS Go the next day without HR stepping in.
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 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.
Frequently asked questions
Do employees in other countries go to NS Go too?
No. Only employees of legal entities with country Netherlands, plus colleagues on a global assignment at such an entity.
Do travel costs come back into SuccessFactors?
Not in this integration. Costs per pay code belong with Dutch payroll processing. An integration from NS Go to payroll can be added later as an extension.
Technical details for IT
For those who want to know how it works under the hood: APIs, fields and sources used.
- Employee Central through the OData API (v2) with OAuth 2.0: EmpJob (company, costCenter, location, managerId), FOCompany, FOLocation with address, PerAddressDEFLT, PerPersonal, PerEmail and EmpEmployment (startDate, endDate, global assignments). Fetched with fromDate and toDate=9999-12-31 and filtered on lastModifiedDateTime.
- 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 specification; 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 SAP SuccessFactors | Field in NS Business | Notes |
|---|---|---|
userId | Personeelsnummer | Fixed key in the delivery |
PerPersonal firstName en lastName | Voornaam en achternaam | |
PerEmail (zakelijk) | E-mailadres | |
PerAddressDEFLT (woonadres) | Thuisadres | The address valid on the effective date |
EmpJob location (adres van FOLocation) | Kantooradres | |
EmpJob company | Juridische entiteit | Through a table from company to Chamber of Commerce number |
EmpJob costCenter | Kostenplaats | |
EmpEmployment startDate en endDate | Start- en einddatum dienstverband |
- NS – Integration with in-house systems (NS Go)
- NS Zakelijk – Pakket Pro
- NS Go – Vernieuwd gebruikersbeheer
- NS Go – Persoonsgegevens wijzigen
- NS Go – Rapportageplicht werkgebonden personenmobiliteit
- SAP Business Accelerator Hub – Employee Central (OData v2)
- SAP KBA 2920680 – lastModifiedDateTime on effective-dated entities
- Boomi – SuccessFactors API endpoints (PerAddressDEFLT)
- SAP Help – Adding a global assignment
Related
Ashby → SAP SuccessFactors
Ashby to SAP SuccessFactors integration: hire as a new employee in Employee Central
Bullhorn → SAP SuccessFactors
Bullhorn to SAP SuccessFactors integration: placements as employees or contingent workers in Employee Central
Carerix → SAP SuccessFactors
Carerix to SAP SuccessFactors integration: successful placement as a new employee in Employee Central
Greenhouse → SAP SuccessFactors
Greenhouse to SAP SuccessFactors integration: a hire as a new employee in Employee Central