By setting up the integration between YouServe (Visma) and Alleo, you achieve the following:
All existing employees in YouServe are added to Alleo
Any changes in YouServe (employees joining or leaving) are automatically synchronised with Alleo on a daily basis
π Through this integration, Alleo receives 'Read-Only' access to YouServe β we can never modify data in YouServe.
Steps to set up the integration
Create an account on the YouServe Developer Portal at developers.youserve.nl. Registration is free and only requires a business email address and company address.
Submit a support ticket to YouServe to create an API application on your account. The API key will then appear under 'Your Apps' in the Developer Portal.
Generate a private/public key pair. Send the public key to YouServe for registration. The private key is used locally to generate a JWT token.
Share the API key (client_id) and tenant information with your Alleo contact.
Alleo will generate a test export of the data and share it with you for review.
Once you confirm that the employee data is correct, the integration can be activated.
What data is exchanged after setting up the integration with YouServe?
The following fields are retrieved via the YouServe API:
Employee (employee object)
YouServe field | Alleo field |
id | external_id |
emailAddresses[] β type personal | private email |
emailAddresses[] β type business | |
knownAs | first name |
lastName | last name |
dateOfBirth | birthday |
isActive | enrollment status |
Employment (employments[])
YouServe field | Alleo field |
contractId | employment external_id |
employeeCode | payroll ID |
employmentType | employment type |
hireDate | start_date |
originalHireDate | work anniversary (original start date) |
dischargeDate / endDate | offboarding date |
Company (/iam/v1.0/companies)
YouServe field | Alleo field |
id | company external_id |
shortName | company short name |
fullName | company full name |
π Note: YouServe does not have a clear prefix separation. The prefix field is therefore left empty in Alleo.
