Dayforce to Nmbrs integration: Dutch payroll per end client
With an integration between Dayforce and Nmbrs, new hires, contracts and salaries from Dayforce reach the right Nmbrs company automatically, ready for the Dutch payroll run. For a payroll provider we set up the integration per end client, with its own translation of jobs and salaries and its own feedback to Dayforce.
Written by Marcel van Beek, founder and integration specialistLast updated:
What the integration does
Payroll providers that run Nmbrs payroll for clients who manage their staff in Dayforce receive every new employee by email or spreadsheet. For each client the payroll team has to check what changed since the previous period, and with several clients side by side that quickly diverges.
The end client's HR records a new hire or change in Dayforce.
Per end client KoppelHet fetches new and changed employees, with employment, job, address and bank account.
A change that takes effect later only lands in Nmbrs on that date, not too early.
The employee appears in that end client's Nmbrs company, with contract, schedule, salary and bank account.
After processing in Nmbrs the agreed feedback goes back to Dayforce. The payroll team sees errors per end client in the KoppelHet platform.
Out: Employee with personal data and address · Employment with start and end date · Job, department and location · Salary · Bank account Back: Feedback from Nmbrs to Dayforce, agreed per end client
What to watch for with Dayforce and Nmbrs
Each end client has its own Dayforce environment with its own credentials. KoppelHet manages these separately per end client, so data from different brands never mixes.
In Nmbrs each end client sits in its own company under the payroll provider. The integration uses the Dayforce environment to decide which Nmbrs company an employee goes to.
Dayforce only passes on a field when the integration has rights to it in the end client's role. An empty field for a new end client is therefore often a permissions issue in Dayforce.
Dayforce stores job and department with start and end dates. KoppelHet reads which job applies on the effective date, not only the current one.
International brands often use an annual salary and head office job codes in Dayforce. KoppelHet converts per end client to the Dutch monthly salary and the jobs in Nmbrs.
Dutch payroll tax data is not in Dayforce by default. The payroll provider records it in Nmbrs, and the integration leaves it untouched there.
Nmbrs retires its old integration method on 1 March 2027. New end clients therefore connect to the new one straight away.
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.
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 · Complex
€ 0.000 – € 00.000
€ 000 per month
Customer case
How it runs at Tentoo
How these organisations use the integration. The configuration differs for each customer.
Tentoo
Payrolling
Tentoo runs Dutch payroll for international employers that use Dayforce as their HR system. The integration brings employees, pay components and hours from Dayforce to Nmbrs, and returns payroll results and payslips from Nmbrs to Dayforce.
The foundation is the same for every end client. What takes time is translating jobs, departments and pay components, and arranging access in that client's Dayforce environment.
What if an end client uses its own field in Dayforce?
We add it to that end client's translation. The other end clients are not affected.
Does this also work for an employer using Nmbrs itself?
Yes. There is then one Dayforce environment and one Nmbrs company, and the per-client setup falls away.
Technical details for IT
For those who want to know how it works under the hood: APIs, fields and sources used.
Dayforce is read through the REST API, per end client with its own company name in the API URL and its own credentials. Updated employees through the update-date filters of the Employees endpoint, details with expand for EmploymentStatuses, WorkAssignments, Addresses, DirectDeposits and CompensationSummary.
With contextDate and a date range KoppelHet reads the state on the effective date. Fields are only returned with field-level access in the API user's role.
Nmbrs is written through the Nmbrs REST API; the SOAP API is retired from 1 March 2027. The Dayforce XRefCode is the key.
Which fields are transferred
The key fields. The full mapping is agreed per customer.
Field in Dayforce
Field in Nmbrs
Notes
XRefCode
Personeelsnummer of vrij veld
The Dayforce key of the employee; needed to find changes again
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.