Payroll integration
UKG Pro to Nmbrs integration: paying the Dutch entity with data from UKG Pro
With an integration between UKG Pro and Nmbrs, employees of the Dutch company from UKG Pro are in Nmbrs with employment, schedule, salary and IBAN, and changes follow with the effective date HR records in UKG Pro. The payroll bureau no longer gets a list from the United States, and a US social security number never reaches Nmbrs.
What the integration does
Anyone running HR for the whole group in UKG Pro with the Dutch entity paid in Nmbrs by a payroll bureau delivers changes as an export. The bureau therefore regularly misses new employees who start mid-month.
- HR records a new employee or change at the Dutch company in UKG Pro.
- Every three hours KoppelHet requests the changed employees and fetches their current data.
- A new employee is in Nmbrs with start date, schedule, salary or hourly wage and IBAN.
- Salary and hours changes go to Nmbrs with their effective date.
- The payroll bureau completes collective agreement, payroll tax credit and pension and runs payroll.
What to watch for with UKG Pro and Nmbrs
- UKG Pro has an indicator per employee for salary or hourly pay. KoppelHet puts hourly-paid staff on an hourly wage and salaried staff on a gross monthly salary in Nmbrs, so the payroll bureau does not need to check per employee which pay type applies.
- Changes can be requested from UKG Pro at most every three hours. A new employee recorded today is in Nmbrs the same day; the check before the cut-off catches anything that changes after that.
- UKG Pro stores identification numbers with the country of issue. Only a Dutch number goes to Nmbrs as BSN; if there is only a foreign number, KoppelHet reports it to HR before the first run.
- IBAN and SWIFT code of employees outside the United States are held in separate bank details in UKG Pro. KoppelHet fetches the IBAN there, so the first payment from Nmbrs does not fail on a missing account number.
- UKG Pro indicates which employees changed, not which field. KoppelHet compares with the previous state, so Nmbrs only receives changes that matter for payroll.
- If a payroll bureau pays the Dutch entity, the bureau grants the integration access to your company only in Nmbrs. The service account in UKG Pro only has read rights on the APIs the integration uses.
- If an employee returns after an earlier departure, UKG Pro gives a new last hire date next to the original one. KoppelHet then starts a new employment for the existing employee in Nmbrs.
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
Does this work for employees on hourly wages?
Yes. The hourly rate from UKG Pro goes to Nmbrs. The hours worked per period come from your time registration; we connect that separately if needed.
What changes for our payroll bureau?
The UKG Pro export disappears. New employees and changes are in Nmbrs; the Dutch setup stays with the bureau.
What if an employee does not have a BSN yet?
The employee still arrives in Nmbrs, and HR sees in the KoppelHet platform that the BSN is missing. The bureau can add it later.
What can be traced afterwards for an audit?
Every action of the integration is recorded in the audit logging of the KoppelHet platform. KoppelHet works with an ISO 27001 certified management system.
Technical details for IT
For those who want to know how it works under the hood: APIs, fields and sources used.
- UKG Pro is read through the Personnel API with a service account, the US-Customer-Api-Key and basic authentication. employee-changes for changed employees (at least three hours between calls, up to eight times a day), employment-details, compensation-details (salaryOrHourly, annualSalary, hourlyPayRate, salaryEffectiveDate), national-documents and employee-global-banks (iban). 429 with too many calls.
- Nmbrs is written through the Nmbrs REST API, which authenticates per debtor; the SOAP API is retired from 1 March 2027.
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in UKG Pro | Field in Nmbrs | Notes |
|---|---|---|
employeeId | Personeelsnummer of vrij veld | Fixed key |
firstName en lastName | Voornaam, tussenvoegsel en achternaam | |
nationalId met nationalIdCountry NLD | BSN | Only the Dutch number |
lastHireDate | Datum in dienst | |
terminationDate | Datum uit dienst | |
scheduledWorkHours | Rooster | |
salaryOrHourly | Maandsalaris of uurloon | |
annualSalary of hourlyPayRate | Bruto maandsalaris of uurloon | Annual amount converted to monthly |
salaryEffectiveDate | Ingangsdatum salaris | |
iban (global banks) | IBAN |
Related
Recruitee → UKG Pro
Recruitee to UKG Pro integration: European hires through the Global New Hire service in UKG Pro
Teamtailor → UKG Pro
Teamtailor to UKG Pro integration: European hires as global new hires
UKG Pro → Active Directory
UKG Pro to Active Directory integration: domain accounts for the Dutch branch
UKG Pro → ADP iHCM
UKG Pro to ADP iHCM integration: salary and terminations of the Dutch pay group to ADP