DotWebCloud (DWC) - Visma YouServe MLM API

[#1]

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

Onderstaande velden gebruikt DotWebCloud in haar connector:

DotWebCloud veldbenaming	Verplicht in DotWebCloud	API Endpoint	API attribute	HRCore Business	HRCore Online
		Employees v2	PersonId	10519680 - personNumber	Niet beschikbaar
		Employees v2	PersonCode	7014 - Uniek Persoonlijk ID (UPI)	Niet beschikbaar
		Employees v2	NationalIdentificationNumber	10000018 - Burgerservice nummer	Niet beschikbaar
		Employees v2	LastNameAtBirth	24 - Achternaam	Niet beschikbaar
		Employees v2	LastNameAtBirthPrefix	26 - Voorvoegsel	Niet beschikbaar
		Employees v2	firstNames	51 - Voornamen	Niet beschikbaar
		Employees v2	isDeleted	Medewerker is verwijderd uit HRCore	Niet beschikbaar
		Employees v2	userUID	10523564 - PING ID	Niet beschikbaar
		Employees v2	lastName	524 - Opgemaakte naam	Niet beschikbaar
		Employees v2	lastNamePrefix	524 - Voorvoegsel Opgemaakte naam
		Employees v2	partnerName	27 - Naam Partner	Niet beschikbaar
		Employees v2	partnerNamePrefix	166 - Voorvoegsel Partner	Niet beschikbaar
		Employees v2	nameAssembleOrder	28 - Eigennaam code	Niet beschikbaar
		Employees v2	initials	25 - Voorletters	Niet beschikbaar
		Employees v2	knownAs	165 - Roepnaam	Niet beschikbaar
		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
		Employees v2	birthdate	35 - geboorte datum	Niet beschikbaar
		Employees v2	deceasedDate	10302568 - Datum overlijden	Niet beschikbaar
		Employees v2	addresses.streetName	391 - straat	Niet beschikbaar
		Employees v2	addresses.houseNumber	392 - Huisnummer	Niet beschikbaar
		Employees v2	addresses.houseNumberAdditional	393 - Huisnummer toevoeging	Niet beschikbaar
		Employees v2	addresses.postalCode	394 - Postcode	Niet beschikbaar
		Employees v2	addresses.city	395 - Woonplaats	Niet beschikbaar
		Employees v2	addresses.country	34 - Woonland > description	Niet beschikbaar
		Employees v2	phoneNumbers.number	Home : 7376 - Telefoonnummer prive	Niet beschikbaar
		Employees v2	phoneNumbers.number	Mobile : 7377 - Telefoonnummer mobiel	Niet beschikbaar
		Employees v2	phoneNumbers.number	Business : 7374 - Telefoonnummer intern	Niet beschikbaar
		Employees v2	emailAddresses.address	Prive: 7213 - E-mailadres Prive	Niet beschikbaar
		Employees v2	emailAddresses.address	Business : 7212 - E-mailadres	Niet beschikbaar
		Contracts	originalHireDate	308 - Datum indienst organisatie	Niet beschikbaar
		Contracts	hireDate	39 - Datum indienst	Niet beschikbaar
		Contracts	dischargeDate	10520479 - Geplande laatste datum indienst (40 - Datum uitdienst minus 1 dag)	Niet beschikbaar
		Contracts	Id	49 - Mutkey of the contract	Niet beschikbaar
		Contracts	Company	18 - Company code	Niet beschikbaar
		Contracts	isDeleted	Contract is verwijderd uit HRCore	Niet beschikbaar
		Contracts	contractCode	91 - Contract Id	Niet beschikbaar
		Contracts	organizationUnit	6000 - Organisatorische eenheid	Niet beschikbaar
		Contracts	jobProfile	97 - Functie	Niet beschikbaar
		Contracts	workingAmount.amountOfWork	465 - Uren Periode	Niet beschikbaar
		Contracts	validFrom	Ingangsdatum van de versie	Niet beschikbaar
		Contracts	validUntil	Einddatum van de versie	Niet beschikbaar
		Contracts	employmentType	7393 - Type Medewerker	Niet beschikbaar
		SickLeaves	id	7471 - Key of the sickness	Niet beschikbaar
		SickLeaves	contractID	49 - Key of the contract	Niet beschikbaar
		SickLeaves	personId	10519680 - personNumber	Niet beschikbaar
		SickLeaves	isDeleted	Ziekmelding is verwijderd uit HRCore	Niet beschikbaar
		SickLeaves	reportingDate	7189 - Datum ziekmelding	Niet beschikbaar
		SickLeaves	startDate	7206 - Eerste verzuimdag	Niet beschikbaar
		SickLeaves	partialRecoveries.illnessPercentage	7464 - Ziektepercentage	Niet beschikbaar
		SickLeaves	partialRecoveries.startDate	Ingangsdatum van het ziektepercentage	Niet beschikbaar
		SickLeaves	sicknessType	7107 - Soort Ziekte	Niet beschikbaar
		SickLeaves	absenceReason	Niet beschikbaar	Niet beschikbaar
		SickLeaves	recoveryDate	7207 - Eerste werkdag	Niet beschikbaar
		SickLeaves	safetynetCase	Niet beschikbaar	Niet beschikbaar
		SickLeaves	therapeutic period.workingPercentage	7089 - Arbeidstherapiepercentage	Niet beschikbaar
		SickLeaves	therapeutic period.startDate	Ingangsdatum van het arbeidstherapiepercentage	Niet beschikbaar
		SickLeaves	therapeutic period.endDate	Einddatum van het arbeidstherapiepercentage	Niet beschikbaar
		SickLeaves	therapeutic period.workingAmount	Arbeidstherapie in uren	Niet beschikbaar
		SickLeaves	nursing address.nameCareAddress	7442 - Naam verpleegadres	Niet beschikbaar
		SickLeaves	nursing address.streetName	391 - Straat	Niet beschikbaar
		SickLeaves	nursing address.number	392 - Huisnummer	Niet beschikbaar
		SickLeaves	nursing address.numberAdditional	393 - Huisnummer toevoeging	Niet beschikbaar
		SickLeaves	nursing address.locationDesignation	8099 - Locatie omschrijving	Niet beschikbaar
		SickLeaves	nursing address.postalCode	394 - Postcode	Niet beschikbaar
		SickLeaves	nursing address.city	395 - Woonplaats	Niet beschikbaar
		SickLeaves	nursing address.region	10205283 - Regionaam buitenland	Niet beschikbaar
		SickLeaves	nursing address.country	34 - Woonland	Niet beschikbaar
		SickLeaves	nursing address.emailAddress	7447 - E-mailadres	Niet beschikbaar
		SickLeaves	nursing address.phoneNumber	7455 - Telefoon	Niet beschikbaar
		SickLeaves	nursing address.faxNumber	7375 - faxnummer	Niet beschikbaar
		SickLeaves	nursing address.startDate	Ingangsdatum van het verpleegadres	Niet beschikbaar
		SickLeaves	nursing address.endDate	Einddatum van het verpleegadres	Niet beschikbaar
		MaternityLeaves	Id	7593 - Key of the maternity	Niet beschikbaar
		MaternityLeaves	personId	10519680 - personNumber	Niet beschikbaar
		MaternityLeaves	contractId	49 - Key of the contract	Niet beschikbaar
		MaternityLeaves	isDeleted	Zwangerschapsverlof is verwijderd uit HRCore	Niet beschikbaar
		MaternityLeaves	reportingDate	7595 - Datum melding	Niet beschikbaar
		MaternityLeaves	startDate	7594 - Begindatum verlof / WAZO	Niet beschikbaar
		MaternityLeaves	probableDeliveryDate	7598 - Vermoedelijke bevallingsdatum	Niet beschikbaar
		MaternityLeaves	multipleBirthIndication	7350 - Meerling	Niet beschikbaar
		MaternityLeaves	firstWorkingDay	7596 - Eerste werkdag	Niet beschikbaar
		MaternityLeaves	actualDeliveryDate	7599 - Feitelijke bevallingsdatum	Niet beschikbaar
		OrganisationUnits	Id	6000 - Key org unit	Niet beschikbaar
		OrganisationUnits	ShortName	548 - Code OE	Niet beschikbaar
		OrganisationUnits	FullName	549 - Naam OE	Niet beschikbaar
		OrganisationUnits	ParentOrgUnit	6000 - Organisatie eenheid - verwijzing naar de Organisatorische eenheid een niveau hoger	Niet beschikbaar
		OrganisationUnits	Manager	7137 - Manager	Niet beschikbaar
		OrganisationUnits	IsDeleted	OE is verwijderd uit HRCore	Niet beschikbaar
		OrganisationUnits	ValidFrom	Ingangsdatum van de versie	Niet beschikbaar
		OrganisationUnits	ValidUntil	Einddatum van de versie	Niet beschikbaar
		OrganisationUnits	organizationUnitType	7475 - Type organisatie	Niet beschikbaar
		JobProfiles	id	Functiecode	Niet beschikbaar
		JobProfiles	isDeleted	Functie is verwijderd uit HRCore	Niet beschikbaar
		JobProfiles	fullName	Functie omschrijving	Niet beschikbaar
		JobProfiles	level	Toont het niveau van inrichting (bedrijf of klant)	Niet beschikbaar
		JobProfiles	companyCode	Indien relevant het bedrijf	Niet beschikbaar
		JobProfiles	ValidFrom	Ingangsdatum van de versie	Niet beschikbaar
		JobProfiles	ValidUntil	Einddatum van de versie	Niet beschikbaar
		Role assignments	Id	960 - Key of the role assignment	Niet beschikbaar
		Role assignments	organizationUnitId	548 - Code of the Organisation Unit	Niet beschikbaar
		Role assignments	personId	10519680 - personNumber	Niet beschikbaar
		Role assignments	shortName	549 - (short)name of the role assignment	Niet beschikbaar
		Role assignments	validFrom	Ingangsdatum van de versie	Niet beschikbaar
		Role assignments	validUntil	Einddatum van de versie	Niet beschikbaar
		Companies	code	Bedrijfscode	Niet beschikbaar
		Companies	Id	Mutkey of the company	Niet beschikbaar
		Companies	name	Bedrijfsnaam	Niet beschikbaar
		Companies	totalWorkAmount	Normuren per week van het bedrijf	Niet beschikbaar
		Companies	validFrom	Ingangsdatum van de versie	Niet beschikbaar
		Companies	validUntil	Einddatum van de versie	Niet beschikbaar
		ValueLists	EmploymentType	Om de omschrijving bij de code op te halen (bijvoorbeeld voor type medewerker, geslacht, land, soort ziekte ed.)	Niet beschikbaar

De velden met het kenmerk verplicht (**nog niet bekend, informatie wordt toegevoegd**) moeten gevuld zijn met een waarde, wanneer bij een medewerker de waarde op 1 van bovenstaande verplichte velden ontbreekt zal DotWebCloud de gehele medewerker niet verwerken. Advies om binnen Youforce deze velden ook verplicht te stellen bij het aanmaken van een nieuwe medewerker. 

De 'indienst datum' in DotWebCloud is gekoppeld aan de 'Datum indienst organisatie', wanneer deze geen waarde heeft in HRCore dan wordt bij de medewerker de 'Datum indienst' getoond.

Het is belangrijk dat de velden 'E-mailadres' en 'E-mailadres Prive' op de juiste wijze worden gebruikt in HRCoreBusiness, oftewel het prive-e-mailadres van de medewerker dient te zijn vastgelegd op het veld 'E-mailadres Prive'.

De rollen die in HRCore zijn vastgelegd dienen aangemaakt en gekoppeld te worden aan de rollen in DotWebCloud.

DotWebCloud synct diverse keren de gewijzigde data in HRCore, oftewel wijzigingen worden gedeeld vanuit HRCore. Nu slaat DotWeb alleen de actuele stand van de gewijzigde medewerker op, mutaties zoals bijvoorbeeld een nieuw adres, een nieuwe functie ed. wat in de toekomst ingaat worden niet opgeslagen in DotWeb. DotWeb werkt aan een oplossing.

Iedere 30 minuten synct DotWebCloud de data, men dient bij de beoordeling van de doorlooptijd van de data rekening te houden met de vertraging die tussen HRCore en de MLM API zit. Gewijzigde data heeft 10-30 minuten nodig om te 'landen' in de MLM API, waar DotWebCloud dus iedere 30 minuten een sync op doet **de 30 minuten dient nog bevestigd te worden door DotWebCloud**.

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.

UserUID

Dit is het Youforce-nummer wat wordt gebruikt voor het direct inloggen vanuit Youforce, zonder UserUID zal de medewerker niet kunnen inloggen in DotWebCloud. De UserUID is iets anders dan het Youforce R-nummer, het is een unieke code (string) die Youforce genereert.

UserUID voor HR Core Business-klanten

Om er voor te zorgen dat er binnen Youforce een UserUID voor een medewerker wordt aangemaakt moet

De ‘Raet Koppeling’ naar Youforce vanuit HRCore zijn geactiveerd en de ‘Raet Koppeling’ naar Ping id zodat de medewerker een Youforce-account heeft. Het ‘nieuwe inloggen’ hoeft niet geactiveerd te zijn mag natuurlijk wel.

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 DotWebCloud, verzoek om een gewenst filter tijdens de implementatie aan te melden via een Servicedesk-ticket.