Door de integratie tussen YouServe (Visma) en Alleo op te zetten bereik je het volgende:
Alle bestaande medewerkers in YouServe worden toegevoegd aan Alleo
Eventuele mutaties in YouServe (in- en uitdienst van medewerkers) worden dagelijks automatisch gesynchroniseerd met Alleo
📌 Alleo 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 Alleo contactpersoon.
Alleo 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 Alleo daarom leeg gelaten.