Payroll integration
UKG Pro to ADP iHCM integration: salary and terminations of the Dutch pay group to ADP
With an integration between UKG Pro and ADP iHCM NL, new salaries and terminations of Dutch employees in UKG Pro reach ADP iHCM automatically, without payroll retyping them. UKG Pro stays the source for HR, ADP iHCM calculates Dutch pay, and the integration makes sure both say the same thing in time for the payroll run.
What the integration does
Organisations with an international HR environment in UKG Pro and Dutch payroll in ADP iHCM keep two systems aligned by hand. A raise approved in the United States often only reaches Dutch payroll through an email or an export.
- ADP or payroll creates a new worker in iHCM; KoppelHet links it once to the employee in UKG Pro.
- Every three hours KoppelHet requests the changed employees from UKG Pro and fetches their compensation details.
- Only employees in the Dutch pay group with an amount in euros continue.
- A different salary goes to the work assignment in ADP iHCM with its effective date.
- An end date in UKG Pro starts the termination in ADP; if the date moves, KoppelHet cancels the termination and starts a new one.
What to watch for with UKG Pro and ADP iHCM
- UKG Pro wants the list of changed employees to be requested at most every three hours. ADP iHCM accepts only one salary change per call. KoppelHet therefore collects the changes per round and then sends them to ADP one by one, without hitting the UKG limit.
- That list does not say which field changed in UKG Pro. KoppelHet keeps what it sent to ADP earlier and compares amount and pay basis against it, so a changed phone number does not create a new salary line in ADP.
- For compensation UKG Pro gives an annual amount, an amount per period and an hourly rate. ADP iHCM knows a salary code and an amount for base pay. Based on the salaried or hourly code, KoppelHet chooses which UKG amount goes to ADP, and which ADP code belongs with it.
- We saw no separate effective date per salary in UKG Pro's compensation details. ADP rejects a salary change dated before the start of the work assignment. KoppelHet uses the date HR records in UKG and first puts a date before the start to payroll.
- Every compensation row in UKG Pro has a currency code, because UKG is often set up from the United States. KoppelHet does not put an amount in dollars into ADP iHCM; payroll gets a notification.
- An end date cannot be edited in ADP iHCM. If HR moves the terminationDate in UKG Pro, KoppelHet cancels the termination in ADP and starts it again with the new date.
- Besides the first hire date, UKG Pro also keeps the date of the last hire. If someone returns, KoppelHet sees it from that date. Because ADP has no public API to rehire someone, such a return goes to payroll as a task.
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 the integration create new workers in ADP?
No. ADP's public iHCM guides contain no API to hire someone. Payroll creates the worker; the integration keeps it up to date after that.
Do bonuses come along too?
Not in the first version. Variable amounts can be added later as an extension through ADP's Pay Data Input API, if you record them per period in UKG Pro.
Technical details for IT
For those who want to know how it works under the hood: APIs, fields and sources used.
- UKG Pro through the Personnel API with a service account (header US-CUSTOMER-API-KEY plus basic authentication). GET /personnel/v1/employee-changes (changes since the previous call, at least three hours apart, per_page up to 200, no field level; fields include employeeNumber, companyId, hireDate, dateOfLastHire, terminationDate, employeeStatus) and GET /personnel/v1/compensation-details (salaryOrHourlyCode, annualSalary, payPeriodPayRate, hourlyPayRate, payGroupCode, payPeriod, currencyCode). View roles on EmployeeExport and Employee Compensation Details. 429 on too many calls.
- ADP iHCM through the Base Remuneration Change API (POST /events/hr/v1/worker.work-assignment.base-remuneration.change; associateOID and work assignment itemID, effectiveDateTime, 2417 as payPeriodRateAmount and 2416 as recordingBasisCode; one event per call) and the Worker Terminate API (worker.terminate and worker-termination.cancel; completion only through events). Every canonical URI in the Consumer Application Registry (CAR).
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in UKG Pro | Field in ADP iHCM | Notes |
|---|---|---|
employeeNumber | payrollfilenumber | Linked once; after that through the associateOID |
payGroupCode | payrollGroupCode | Lookup table; only the Dutch pay group is included |
salaryOrHourlyCode | 2416 salariscode | Salaried or hourly to the ADP code |
payPeriodPayRate of hourlyPayRate | 2417 salarisbedrag | |
currencyCode | Controle vóór verzending | Only EUR passes |
terminationDate | worker.terminate |
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 → AFAS Profit
UKG Pro to AFAS integration: Dutch employees of a US head office in AFAS Profit