Payroll integration
Personio to Visma YouServe integration: new hires and compensation on time at the payroll service
With an integration between Personio and Visma YouServe, new Dutch employees are in YouServe as soon as their contract is in Personio, and changes in hours, salary, allowances and bonuses go to Visma's payroll service automatically. HR retypes nothing, and one-off payments arrive as a change in the right payroll period.
What the integration does
Employers that use Personio and have placed Dutch payroll with Visma YouServe sometimes only report new colleagues to the payroll service after their first working day. Bonuses go by email, and a forgotten bonus comes a month later.
- HR creates a new employee in Personio with contract, hours and department.
- KoppelHet creates the employee in YouServe straight away, with the collective agreement that belongs to the Dutch company.
- If something changes later, KoppelHet checks what differs from YouServe and sends only that, with an effective date.
- Allowances, one-off payments and bonuses for the period go to YouServe as changes, in time for the submission date.
- Anything YouServe does not process shows with the reason in the KoppelHet platform.
What to watch for with Personio and Visma YouServe
- Personio only reports a new employee as started at midnight on the first working day. YouServe may already be closed for the first period by then. KoppelHet therefore creates the employee in YouServe as soon as the contract is in Personio.
- A notification from Personio only says that someone changed, not what. YouServe, in turn, leaves everything that is not sent untouched. KoppelHet therefore compares with YouServe and sends only the field that really differs, so a correction by the payroll service is not overwritten.
- Personio splits compensation into fixed salary, hourly wage, recurring allowances, one-off payments and bonuses. Fixed salary and recurring allowances belong to the employment in YouServe. One-off payments and bonuses go to YouServe as a change file, so they are only paid in that one period.
- Personio releases compensation per month. KoppelHet requests each YouServe period separately, and a bonus HR enters afterwards for an earlier month goes along as a separate change in the next run.
- YouServe only creates an employee when the collective agreement is known. Personio has no field for it. KoppelHet chooses the agreement based on the company or office in Personio, and with a custom attribute if several agreements apply within one company.
- BSN and IBAN live in Personio in custom attributes that the administrator must release for the integration. A changed bank account gets an effective date in YouServe; without release the field stays empty and an alert follows.
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 YouServe not simply receive a bonus through the API?
For one-off payments YouServe has a fixed file format that is imported automatically. KoppelHet builds that file from Personio, so for HR it makes no difference.
Do employees in other countries go along too?
No. Only employees of the Dutch company in Personio go to YouServe.
What if someone leaves in Personio?
The end date goes to YouServe. The final settlement, such as holiday allowance and untaken leave, is done by the payroll service.
Technical details for IT
For those who want to know how it works under the hood: APIs, fields and sources used.
- Personio is read through webhooks (only the id of person or employment; employment.started fires at midnight UTC on the start date) and the Personio API v2. The compensations endpoint accepts a period of at most one month, with the categories FIXED_SALARY, HOURLY_SALARY, RECURRING, ONE_TIME and BONUS_PAYOUT. BSN and IBAN from custom attributes released for API access.
- YouServe is written through the API for HR Core and Payroll (POST employees with mandatory collectiveLaborAgreement; PATCH on contract, address and bank account with mandatory start date). One-off changes go through the YouServe File API as a file of the type CSV one-off changes (business type 113002), which Visma must set up in HR Core Payroll Business.
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in Personio | Field in Visma YouServe | Notes |
|---|---|---|
Persoon-id | Extern nummer of vrij veld | |
Voornaam en achternaam | Voornaam, voorvoegsel, achternaam | |
BSN (custom attribute) | BSN | |
Startdatum dienstverband | Datum in dienst | |
Bedrijf of vestiging | Werkgever en cao | Through a lookup table |
weekly_working_hours | Uren per week | |
FIXED_SALARY of HOURLY_SALARY | Salaris of uurloon | An annual amount is converted to monthly |
RECURRING | Vaste looncomponent | |
ONE_TIME en BONUS_PAYOUT | Eenmalige mutatie (bestand) | |
IBAN (custom attribute) | Bankrekening | |
Einddatum dienstverband | Datum uit dienst |
Related
Ashby → Personio
Ashby to Personio integration: hires with hours and entity as new employees in Personio
Bullhorn → Personio
Bullhorn to Personio integration: placements as a person with employment in Personio
Carerix → Personio
Carerix to Personio integration: successful placement as a new employee in Personio
Greenhouse → Personio
Greenhouse to Personio integration: hired candidates as employees in Personio