Leave, absence and time
ADP Workforce Now to Quinyx integration: employees with agreements, positions and leave in hours in scheduling
With an integration between ADP Workforce Now and Quinyx, every employee from ADP arrives in Quinyx with a role per position and an agreement with the contract hours, and approved time off becomes an absence in the schedule. KoppelHet converts the standard hours from ADP to weekly hours and books time off in hours as part of the shift.
What the integration does
Organisations with ADP Workforce Now as their HR and payroll system and Quinyx for scheduling often find that the agreements in Quinyx do not match the hours in ADP, and that someone with two positions shows up in only one place in the schedule.
- HR records a hire or a new position in ADP Workforce Now, with location and standard hours.
- KoppelHet creates the employee in Quinyx, with a role per position and an agreement with weekly and full-time hours.
- Approved time off from ADP becomes an absence in Quinyx, full days or part of the shift.
- KoppelHet removes a cancelled request, with the shifts returned to the employee.
- When a position ends, KoppelHet only closes that role, not the whole employee.
What to watch for with ADP Workforce Now and Quinyx
- ADP Workforce Now records standard hours with a unit: weekly, biweekly, monthly or annual, alongside an FTE value. An agreement in Quinyx wants hours per week and the hours of a full-time week. KoppelHet converts each unit to a week and derives the full-time week from hours and FTE, so the part-time factor in Quinyx equals the one in ADP.
- In ADP an employee has one workerID and a positionID per position. Quinyx allows an employee to hold several roles at once, each in its own unit. KoppelHet gives each position a role at the matching location and makes the primary position the home unit, so someone at two sites can be scheduled at both.
- An employee's status in ADP only follows their primary position. If a second position ends, the employee stays active. KoppelHet then sets an end date on that one role in Quinyx, so they stay scheduled at the other site as usual.
- ADP Workforce Now sends no notification for most changes to a position; there are separate notifications for standard hours and work location. KoppelHet listens to those two and compares the workers with Quinyx every night, so a different department or contract type does not get missed.
- Whether time off in ADP is tracked in hours or days depends on the time off policy. Quinyx books a full absence or a partial one with a percentage of the shift. KoppelHet books a full day as a full absence and a number of hours as a percentage of the planned shift.
- ADP only returns time off policies per employee; there is no list of all policies. Each policy must land on an absence type in Quinyx. At the start KoppelHet collects the policies of all workers who schedule in Quinyx and records the Quinyx type per policy, so no leave type stays unlinked.
- ADP's time off API returns requests from the past 90 days and up to two years ahead. Quinyx rejects an absence in a period already transferred to payroll. KoppelHet compares within that window every night and reports a late change to the planner, together with the locked period.
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 hours from Quinyx go back to ADP?
Not in this integration. Hours to payroll can be added later as an extension.
Does this also work for ADP Workforce Now Next Generation?
The worker API applies to both; we check at the start which notifications exist in Next Generation.
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 $top up to 100 and $skip, $filter on workAssignments/homeWorkLocation or positionID. Notifications worker.hire, worker.rehire, worker.terminate, worker.workAssignment.standardHours.change and worker.workAssignment.homeWorkLocation.change. OAuth 2.0 client credentials with a client certificate.
- Time off through the Time Off Request API: GET /time/v2/workers/{aoid}/time-off-details/time-off-requests (90 days back, up to two years ahead), policies through /time-off-details/time-off-configurations per worker, notifications timeOffRequest.review and timeOffRequest.cancel. Fields paidTimeOffPolicy and totalQuantity with unitTimeCode.
- To Quinyx through the Employees API v3 (POST /hr/v3/employees with badgeNumber, homeGroupId and employmentStartDate) and POST /hr/v3/role-assignments (employeeId, groupId, roleId, startDate, endDate). Absences through POST /v2/schedule/groups/{groupId}/absences and /absences/part-time (absenceRate, absenceRateDirection), DELETE with reassignBackShifts; error codes such as SALARY_PERIOD_LOCKED and MISSING_AGREEMENT.
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in ADP Workforce Now | Field in Quinyx | Notes |
|---|---|---|
workerID | badgeNumber | |
legalName | personalInformation (firstName, lastName) | |
positionID en homeWorkLocation per positie | role-assignment met groupId | The primary position becomes the home unit |
standardHours (hoursQuantity, unitCode) | Agreement: uren per week | |
fullTimeEquivalenceRatio | Agreement: uren van een voltijdweek | |
paidTimeOffPolicy | absenceTypeId | Through a table per policy |
totalQuantity (unitTimeCode uren of dagen) | Hele afwezigheid of part-time met absenceRate |
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