Payroll integration
ADP Workforce Now to Nmbrs integration: the Dutch payroll group from ADP in the right Nmbrs company
With an integration between ADP Workforce Now and Visma Nmbrs, new hires, pay changes and leavers of the Dutch payroll group go from ADP Workforce Now to the right company in Nmbrs. Nmbrs then runs payroll under Dutch rules, and the payroll tax credit and pension stay with payroll in Nmbrs.
What the integration does
Organisations that pay US and Canadian staff in ADP Workforce Now and Dutch staff in Nmbrs maintain the Dutch group in two systems. Payroll often only hears about a pay adjustment when the Dutch manager asks about it.
- HR records a Dutch employee or change in ADP Workforce Now, in the Dutch payroll group.
- KoppelHet fetches the workers of that payroll group, page by page, and compares them with Nmbrs.
- A new worker becomes an employee in the Nmbrs company of that entity; a change updates employment, hours or salary with effective date.
- Payroll adds the Dutch tax details in Nmbrs.
- A termination sets the end date of the employment in Nmbrs.
What to watch for with ADP Workforce Now and Nmbrs
- KoppelHet filters ADP on the payroll group of the Dutch entity. If the organisation has more Dutch entities, each payroll group corresponds to one company in Nmbrs, and that is where the employee lands.
- The BSN sits among the national IDs in ADP, which the API masks by default. The integration only reads the Dutch number, and only after the administrator has released it for this API Central project.
- Workforce Now accepts and stores salary as an amount per period, per hour or per day; it calculates the annual amount itself. KoppelHet uses the stored amount with the pay frequency and converts it to the Dutch monthly salary or hourly wage in Nmbrs.
- Whether a worker is still employed is derived by ADP from the primary work assignment. If someone holds another position next to the Dutch one, KoppelHet checks the status of the Dutch position itself before ending the employment in Nmbrs.
- ADP returns at most one hundred workers per call. The full comparison before the Nmbrs run therefore fetches the payroll group in pages, so nobody is missing.
- Payroll tax credit, pension scheme and collective agreement do not exist in Workforce Now. Payroll records them in Nmbrs, and the integration leaves those fields alone on later changes.
- Nmbrs stops the SOAP API on 1 March 2027. This integration therefore writes through the Nmbrs REST API from the start.
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
Can we test first without production data?
A Workforce Now test environment only exists if ADP sets it up on request; according to ADP there is none for Next Gen and TotalSource. We check this early in the project.
Do payslips go back to ADP?
No. Dutch payslips stay in Nmbrs. A flow back can follow later as an extension.
What if an employee moves to another payroll group in ADP?
Then the employee falls outside the filter. KoppelHet puts that on the difference list, so payroll deliberately ends the employment in Nmbrs.
Technical details for IT
For those who want to know how it works under the hood: APIs, fields and sources used.
- ADP Workforce Now through the Worker Management API - GET /hr/v2/workers with $filter=workers/workAssignments/payrollGroupCode eq '{code}', paging with $top (maximum 100) and $skip, Accept application/json;masked=false for governmentIDs, birthDate and baseRemuneration (after release in Manage Profiles), plus events worker.hire and worker.terminate. Salary only as payPeriodRateAmount, hourlyRateAmount or dailyRateAmount.
- To Nmbrs through the Nmbrs REST API with OAuth 2.0, per company; the SOAP API stops on 1 March 2027.
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in ADP Workforce Now | Field in Nmbrs | Notes |
|---|---|---|
workerID/idValue | Personeelsnummer in Nmbrs | Unique per ADP client |
workAssignments/payrollGroupCode | Nmbrs-bedrijf | One payroll group per Dutch entity |
person/governmentIDs (NL) | BSN | Only unmasked |
person/legalName | Voornaam, tussenvoegsel, achternaam | |
workAssignments/hireDate | Datum in dienst | |
workAssignments/standardHours | Uren per week | |
baseRemuneration (payPeriodRateAmount of hourlyRateAmount) | Salaris | Converted to a monthly amount or hourly wage |
workAssignments/terminationDate | Datum uit dienst |
Related
ADP Workforce Now → 4PS Construct
ADP Workforce Now to 4PS Construct integration: employees with company, dimensions and statistics group in 4PS
ADP Workforce Now → Active Directory
ADP Workforce Now to Active Directory integration: accounts in your own domain, with expiry date and rehire from ADP
ADP Workforce Now → AFAS Profit
ADP Workforce Now to AFAS integration: Dutch employees from the US HR system in AFAS Profit
ADP Workforce Now → AllSolutions
ADP Workforce Now to AllSolutions integration: employees with department, cost centre and manager in AllSolutions