Met de integratie met YouServe komen medewerkers automatisch in Epassi en worden in- en uitdienst elke dag bijgewerkt.
Door de integratie tussen YouServe (Visma) en Epassi op te zetten bereik je het volgende:
- Alle bestaande medewerkers in YouServe worden toegevoegd aan Epassi
- Eventuele mutaties in YouServe (in- en uitdienst van medewerkers) worden dagelijks automatisch gesynchroniseerd met Epassi
Epassi krijgt door deze integratie 'Read-Only' toegang tot YouServe waardoor wij nooit gegevens in YouServe kunnen aanpassen.
Stappen om de integratie in te stellen
- Maak een account aan op de YouServe Developer Portal via developers.youserve.nl. Registratie is gratis en vereist alleen een zakelijk e-mailadres en bedrijfsadres.
- Dien een support ticket in bij YouServe om een API-applicatie aan te maken op jouw account. De API key verschijnt vervolgens onder 'Your Apps' in de Developer Portal.
- Genereer een private/public key-paar. Stuur de public key naar YouServe ter registratie. De private key gebruik je lokaal voor het genereren van een JWT-token.
- Deel de API key (client_id) en tenant-informatie met jouw Epassi contactpersoon.
- Epassi maakt een testuitdraai van de gegevens en zal deze met je delen.
- Na bevestiging dat de medewerkergegevens correct zijn, kan de integratie worden ingeschakeld.
Welke gegevens worden uitgewisseld na het opzetten van de integratie met YouServe?
De volgende velden worden opgehaald via de YouServe API
Medewerker (employee object)
| YouServe veld | Alleo veld |
|---|---|
| id | external id |
| emailAddresses[]: type personal | private email |
| emailAddresses[]: type business | |
| knownAs | first name |
| lastName | last name |
| dateOfBirth | birthday |
| isActive | enrollment status |
Dienstverband (employments[])
| YouServe veld | Alleo veld |
|---|---|
| contractId | employment external_id |
| employeeCode | payroll ID |
| employmentType | employment type |
| hireDate | onboarding date |
| originalHireDate | work anniversary |
| dischargeDate / endDate | offboarding date |
Bedrijf (/iam/v1.0/companies)
| YouServe veld | Alleo veld |
|---|---|
| id | company external_id |
| shortName | company short name |
| fullName | company full name |
Opmerking: YouServe hanteert geen duidelijke prefix-scheiding. Het prefix-veld wordt in Epassi daarom leeg gelaten.