XpertSuite - Visma YouServe MLM API

[#1]

Dit document beschrijft de 'XpertSuite - Visma Raet MLM API’-connector. Een koppeling gebaseerd op de Visma Raet Medical Leave Management (MLM) API.

Otherside of Work faciliteert deze koppeling.

Onderstaande velden gebruikt XpertSuite in haar connector:

XpertSuite	Verplicht in XpertSuite	API Endpoint	API attribute	HRCore Business	HRCore Online
ExternWerknemerID (enkel zichtbaar voor SuperBeheerders)	Ja	Employees v2	Id	10519680 - personNumber	Niet beschikbaar
Personeelsnr	Nee	Employees v2	PersonCode	7014 - Uniek Persoonlijk ID (UPI)	Niet beschikbaar
BSN	Nee	Employees v2	NationalIdentificationNumber	10000018 - Burgerservice nummer	Niet beschikbaar
Achternaam	Ja	Employees v2	LastNameAtBirth	24 - Achternaam	Niet beschikbaar
Tussenvoegsels	Nee	Employees v2	LastNameAtBirthPrefix	26 - Voorvoegsel	Niet beschikbaar
Achternaam partner	Nee	Employees v2	partnerName	27 - Naam Partner	Niet beschikbaar
Tussenvoegsels partner	Nee	Employees v2	partnerNamePrefix	166 - Voorvoegsel Partner	Niet beschikbaar
Naam hantering	Ja	Employees v2	nameAssembleOrder	28 - Eigennaam code	Niet beschikbaar
Voorletters	Ja	Employees v2	initials	25 - Voorletters	Niet beschikbaar
Roepnaam	Nee	Employees v2	knownAs	165 - Roepnaam	Niet beschikbaar
Geslacht	Ja	Employees v2	gender	36 - Geslacht Gender of the person conform the ISO/IEC 5128 standard (0) Not known (1) Male (2) Female (9) Not applicable	Niet beschikbaar
Geboortedatum	Ja	Employees v2	birthdate	35 - geboorte datum	Niet beschikbaar
Overlijdensdatum	Nee	Employees v2	deceasedDate	10302568 - Datum overlijden	Niet beschikbaar
Straat	Nee	Employees v2	addresses.streetName	391 - straat	Niet beschikbaar
Huisnummer	Nee	Employees v2	addresses.houseNumber	392 - Huisnummer	Niet beschikbaar
Huisnummer toevoeging	Nee	Employees v2	addresses.houseNumberAdditional	393 - Huisnummer toevoeging	Niet beschikbaar
Postcode	Nee	Employees v2	addresses.postalCode	394 - Postcode	Niet beschikbaar
Plaats	Nee	Employees v2	addresses.city	395 - Woonplaats	Niet beschikbaar
Land	Nee	Employees v2	addresses.country	34 - Woonland > description	Niet beschikbaar
Telefoon privé	Nee	Employees v2	phoneNumbers.number	Home : 7376 - Telefoonnummer prive	Niet beschikbaar
Mobiel privé	Nee	Employees v2	phoneNumbers.number	Mobile : 7377 - Telefoonnummer mobiel	Niet beschikbaar
Telefoon werk	Nee	Employees v2	phoneNumbers.number	Business : 7374 - Telefoonnummer intern	Niet beschikbaar
E-mailadres privé	Nee	Employees v2	emailAddresses.address	Prive: 7213 - E-mailadres Prive	Niet beschikbaar
E-mailadres werk	Nee	Employees v2	emailAddresses.address	Business : 7212 - E-mailadres	Niet beschikbaar
Startdatum arbeidsovereenkomst	Ja	Employees v2	employments.originalHireDate	308 - Datum indienst organisatie	Niet beschikbaar
Einddatum arbeidsovereenkomst	Nee	Employees v2	employments.dischargeDate	10520479 - Geplande laatste datum indienst (40 - Datum uitdienst minus 1 dag)	Niet beschikbaar
DienstverbandId	Nee	Contracts	Id	49 - Mutkey of the contract	Niet beschikbaar
Werkgevercode	Ja	Contracts	Company	18 - Company code	Niet beschikbaar
ExternWerknemerID (enkel beschikbaar voor SuperBeheerders)	Ja	Contracts	PersonId	10519680 - personNumber	Niet beschikbaar
Afdelingscode	Ja	Contracts	organizationUnit	6000 - Organisatorische eenheid	Niet beschikbaar
Functie	Ja	Contracts	jobProfile	97 - Functie	Niet beschikbaar
Aantal uren	Ja	Contracts	workingAmount. amountOfWork	465 - Uren Periode	Niet beschikbaar
Startdatum dienstverband	Ja	Contracts	validFrom	Ingangsdatum van de versie	Niet beschikbaar
Einddatum dienstverband	Nee	Contracts	validUntil	Einddatum van de versie	Niet beschikbaar
Type dienstverband	Nee	Contracts	employmentType	7393 - Type Medewerker	Niet beschikbaar
DienstverbandCategorieKlasse1	Nee	Contracts	contractType	10204687 - Contract type	Niet beschikbaar
ExternTrajectId (niet zichtbaar voor gebruikers)	Nee	SickLeaves	id	7471 - Key of the sickness	Niet beschikbaar
ExternWerknemerID (enkel beschikbaar voor SuperBeheerders)	Ja	SickLeaves	personId	10519680 - personNumber	Niet beschikbaar
Niet vastgelegd	Ja	SickLeaves	isDeleted	Is de ziekmelding verwijderd	Niet beschikbaar
Niet vastgelegd	Nee	SickLeaves	reportingDate	7189 - Datum ziekmelding	Niet beschikbaar
Eerste ziektedag	Ja	SickLeaves	startDate	7206 - Eerste verzuimdag	Niet beschikbaar
Datum	Ja	SickLeaves	partialRecoveries.startDate	Ingangsdatum van het ziektepercentage	Niet beschikbaar
Verzuimpercentage	Ja	SickLeaves	partialRecoveries.illnessPercentage	7464 - Ziektepercentage	Niet beschikbaar
Verzuimclassificatie	Ja	SickLeaves	sicknessType	7107 - Soort Ziekte	Niet beschikbaar
Niet vastgelegd	Nee	SickLeaves	absenceReason	Niet beschikbaar	Niet beschikbaar
Laatste verzuimdag	Nee	SickLeaves	recoveryDate	7207 - Eerste werkdag	Niet beschikbaar
Niet vastgelegd	Nee	SickLeaves	expectedRecoveryDate	7443 - Verwachte hersteldatum	Niet beschikbaar
Niet vastgelegd	Nee	SickLeaves	recoveryReason	Niet beschikbaar	Niet beschikbaar
ExternTrajectId (niet zichtbaar voor gebruikers)	Nee	MaternityLeaves	Id	7593 - Key of the maternity	Niet beschikbaar
ExternWerknemerID (enkel beschikbaar voor SuperBeheerders)	Ja	MaternityLeaves	personId	10519680 - personNumber	Niet beschikbaar
Niet vastgelegd	Ja	MaternityLeaves	isDeleted	Is de melding verwijderd	Niet beschikbaar
Niet vastgelegd	Nee	MaternityLeaves	reportingDate	7595 - Datum melding	Niet beschikbaar
Eerste ziektedag	Ja	MaternityLeaves	startDate	7594 - Begindatum verlof / WAZO	Niet beschikbaar
Vermoedelijke bevallingsdatum	Nee	MaternityLeaves	probableDeliveryDate	7598 - Vermoedelijke bevallingsdatum	Niet beschikbaar
Feitelijke bevallingsdatum	Nee	MaternityLeaves	actualDeliveryDate	7599 - Feitelijke bevallingsdatum	Niet beschikbaar
Afdelingscode	Ja	OrganisationUnits	Id	6000 - Key org unit	Niet beschikbaar
Naam	Ja	OrganisationUnits	FullName	549 - Naam OE	Niet beschikbaar
Parentcode afdeling	Nee	OrganisationUnits	ParentOrgUnit	6000 - Organisatie eenheid - verwijzing naar de Organisatorische eenheid een niveau hoger	Niet beschikbaar
Leidinggevende	Nee	OrganisationUnits	Manager	7137 - Manager	Niet beschikbaar
Niet vastgelegd	Nee	OrganisationUnits	IsDeleted	Is de OE verwijderd	Niet beschikbaar
Niet vastgelegd	Nee	OrganisationUnits	ValidFrom	Ingangsdatum van de versie	Niet beschikbaar
Niet vastgelegd	Nee	OrganisationUnits	ValidUntil	Einddatum van de versie	Niet beschikbaar
Niet vastgelegd	Nee	JobProfiles	id	Functiecode	Niet beschikbaar
Functie	Ja	JobProfiles	fullName	Functie omschrijving	Niet beschikbaar
Niet van toepassing		ValueLists		Om de omschrijving bij de code op te halen (bijvoorbeeld voor geslacht, land, soort ziekte ed.)	Niet beschikbaar

De velden met het kenmerk verplicht moeten gevuld zijn met een waarde, wanneer bij een medewerker de waarde op 1 van bovenstaande verplichte velden ontbreekt zal XpertSuite de gehele medewerker niet verwerken. Advies om binnen Youforce deze velden ook verplicht te stellen bij het aanmaken van een nieuwe medewerker. Een verwerkingsverslag met daarin door XpertSuite afgekeurde medewerkers kan vanuit XpertSuite worden gemaild, dit kan je instellen in XpertSuite.

XpertSuite keurt de ziekmelding af als er voor diezelfde periode ook zwangerschapsverlof is vastgelegd.

De verzuimoorzaken (in HRCore Business 'Soort ziekte') worden gekoppeld aan oorzaken in XpertSuite, in XpertSuite stel je dit in.

XpertSuite synct 1 keer per dag alle medewerkers en ziekmeldingen. Medewerkers met een uitdienstdatum worden tot 30 dagen na hun uitdienstdatum nog gesynchroniseerd. 

Nieuwe medewerkers die zijn opgevoerd in HRCore worden na een synchronisatie zichtbaar in XpertSuite. Als bij een bestaande medewerker een waarde in HRCore wordt gewijzigd zoals de functie dan is de nieuwe functie ook direct zichtbaar in XpertSuite met de ingangsdatum waarop de functie ingaat.

Personnumber / Uniek Persoonlijk ID (UPI) voor HRCore Business

In de koppeling wordt de waarde op het veld 'Uniek Persoonlijk ID' (UPI) gebruikt als nummer voor de medewerker. Zorg er voor dat alle medewerkers in HRCore Business zijn voorzien van een waarde in dit veld en dat de medewerkers zijn omgezet naar een 'Persoon' anders zal de connector geen data van de medewerker doorgeven.

Filtermogelijkheden voor HRCore Business

Vanuit HR Core Business kunnen ‘bedrijven’ worden uitgesloten van de connector. Het gaat dan om de bedrijf-omschrijvingen zoals ze zijn ingericht in HRCore, zichtbaar via de knop 'Zoek bedrijf': 

Het veld ‘type medewerker’ (7393) is de tweede filter-mogelijkheid.  

Standaard worden er geen fillters ingesteld dus alle medewerkers zijn beschikbaar voor XpertSuite, verzoek om een gewenst filter tijdens de implementatie aan te melden via een Servicedesk-ticket.