What we take care of
Mapping pay components from HR to payroll
You map pay components with a translation table that links each pay element in the HR system, such as a travel allowance or bonus in Personio, Oracle HCM or SAP, to a recurring or variable pay component in AFAS, Nmbrs, Loket or YouServe. A recurring allowance belongs to the employment, a one-off payment only goes into the period of payment.
What it is
A global HR system sets up pay elements for the whole group, not according to a Dutch collective agreement. Personio has five kinds of compensation, Oracle element entries, SAP wage types. Payroll works with its own pay components per company.
Without a fixed translation a bonus is processed as salary, a one-off payment carries on into next month, or a new element disappears silently. You only see it on the payslip.
How the integration handles it
- A translation table links each pay element to a pay component. We agree it with payroll at the start and manage it on the KoppelHet platform, not in a spreadsheet.
- Recurring allowances become fixed pay components that run until their end date. One-off payments and bonuses only apply in the period of payment.
- A new element without an agreement becomes a notification to payroll, not a silent pay line.
- Elements without a Dutch counterpart are left out, for example an SAP wage type that does not run through payroll in the Netherlands.
- With YouServe fixed salary and recurring allowances go with the employment; one-off payments and bonuses go as a change file for that one period.
- Personio releases compensation per month. KoppelHet requests each pay period separately, so nothing falls between two requests.
- Hourly pay stays hourly pay. A monthly salary is converted with the contract hours, so someone on an hourly wage does not get a converted monthly amount.
Edge cases we handle
- The HR system usually does not know collective agreement scale and step. For a scale salary KoppelHet delivers job and hours or the amount, and payroll chooses scale and step.
- In the Netherlands holiday allowance is often included in the headquarters annual amount. At the start we fix what the annual amount is divided by.
- HR enters a bonus afterwards for an earlier month. It goes as a separate change into the next run.
- Overtime from a time system such as Yoobi must not be paid twice. KoppelHet remembers which period and lines were delivered, because AFAS does not warn about duplicate pay changes.
What KoppelHet does
Pay components largely determine the lead time of a payroll project. KoppelHet drafts the translation table with payroll, tests it with real cases in the test environment and maintains it afterwards. When a new element appears you see a notification and we add it. Plan on three to six weeks as an indication, depending on pay components and entities.
Common integrations
Personio → Loket
Personio to Loket integration: employees, hours and pay components to payroll
Personio → Visma YouServe
Personio to Visma YouServe integration: new hires and compensation on time at the payroll service
Oracle HCM Cloud → Nmbrs
Oracle HCM to Nmbrs integration: the Dutch entity in payroll automatically
SAP HCM → Nmbrs
SAP HCM to Nmbrs integration: SAP HR data to Dutch payroll
SAP SuccessFactors → Loket
SuccessFactors to Loket integration: Employee Central as the source for Dutch payroll
Factorial → Nmbrs
Factorial to Nmbrs integration: HR changes from Factorial ready for the Dutch payroll run
Yoobi → AFAS Profit
Yoobi to AFAS integration: overtime, mileage and expenses from Yoobi in the AFAS payroll run
Customer case
War Child Alliance
Non-profit
War Child uses Personio for all HR processes and ADP iHCM for local payroll. The integration moves new hires, changes, salaries and additional pay components such as travel allowance and bonuses from Personio to ADP automatically.
“Whenever my colleague Lukas raised an issue, KoppelHet responded quickly and thought along actively.”
Frequently asked questions
Who maintains the translation table?
KoppelHet, on the platform. Payroll decides which pay component belongs to which element.
What if HR creates a new pay element?
Then a notification appears instead of a silent pay line. Once agreed with payroll we add it.
Can hours and expenses go across as pay components too?
Yes. Overtime or extra shifts can go across as a separate stream of pay components, next to the stream for hires and changes.
More on Payroll integration
Payroll integration: the overview
Common situations
What we take care of
- Effective dates and retroactive changesChanges ahead, after the fact and across the year end, in the right pay period.
- Pay componentsSalary, recurring allowances, bonuses and one-off payments to the right pay component.
- Multiple employers and employmentsSeveral entities, moves between entities, two employments and rehires.