With the YouServe integration, employees are added to Epassi automatically and joiners and leavers are updated daily.
By setting up the integration between YouServe (Visma) and Epassi, you achieve the following:
- All existing employees in YouServe are added to Epassi
- Any changes in YouServe (employees joining or leaving) are automatically synchronised with Epassi on a daily basis
Through this integration, Epassi 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 Epassi contact.
- Epassi 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 Epassi.