Verzuimsignaal - Visma Raet YouServe API

[#1]

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

Onderstaande velden gebruikt Verzuimsignaal in haar connector:

Verzuimsignaal scherm	Verzuimsignaal veldnaam	Verplicht voor Verzuimsignaal	API Endpoint	Veld / waarde	HRCoreBusiness rubriek	Opmerkingen / bijzonderheden
Bedrijf - Bedrijfsgegevens	Bedrijfsnaam	Verplicht	OrgUnits	fullName	549 - Naam OE
Bedrijf - Bedrijfsgegevens	Werkgeversnummer	Verplicht	OrgUnits	shortName	548 - Code OE
			OrgUnits	parentOrgUnit	6000 - Organisatie eenheid - verwijzing naar de Organisatorische eenheid een niveau hoger
Bedrijf			OrgUnits	organizationUnitType	7475 - Type organisatie
Bedrijf - Werkgever contactpersoon	Achternaam	Verplicht	OrgUnits	manager	7137 - Manager	Achternaam incl. eventuele tussenvoegsels
Bedrijf - Communicatie		Verplicht	van de manager Employees / phoneNumbers emailAddresses	type /  number address	Home : 7376 - Telefoonnummer prive Mobile : 7377 - Telefoonnummer mobiel Business : 7374 - Telefoonnummer intern Business : 7212 - E-mailadres Prive: 7213 - E-mailadres Prive	Soort communicatie code; 01 = Vaste telefoon (verplicht in VS) 02 = Mobiele telefoon 04 = E-mail adres (verplicht in VS) 05 = Privé e-mail adres Vertaling toegepast: Tel -> Home(tel prive) = 01 Tel -> Mobile (mobiel) = 02 Tel -> Business (tel zakelijk) = 01 Mail -> Business (zakelijke email) = 04 Mail -> Prive: (prive email) = 04
Werknemer - Persoonsgegevens	GUID	Verplicht	Employees	personCode	7014 - Uniek Persoonlijk ID (UPI)	Een unieke identificatie van de werknemer bij de werkgever. Een eenmaal uitgegeven identificatie wordt niet hergebruikt.
Werknemer			Employees	personId	10519680 - PersonNumber
Werknemer - Persoonsgegevens	Burgerservicenummer		Employees	nationalIdentificationNumber	10000018 - Burgerservice nummer
Werknemer - Persoonsgegevens	Geboortedatum	Verplicht	Employees	birthDate	35 - Geboorte datum
Werknemer - Persoonsgegevens	Overlijdingsdatum		Employees	deceasedDate	10302568 - Datum overlijden
Werknemer - Persoonsgegevens	Achternaam	Verplicht	Employees	lastNameAtBirth	24 - Achternaam
Werknemer - Persoonsgegevens	Initialen	Verplicht	Employees	initials	25 - Voorletters
Werknemer - Persoonsgegevens	Tussenvoegsel		Employees	lastNameAtBirthPrefix	26 - Voorvoegsel
Werknemer - Persoonsgegevens	Roepnaam		Employees	firstNames	51 - Voornamen
Werknemer - Persoonsgegevens	Voorkeurshantering	Verplicht	Employees	nameAssembleOrder	28 - Eigennaam code	Voorkeurshantering 01 = Eigen naam 02 = Naam partner 03 = Naam partner gevolgd door eigen naam 04 = Eigen naam gevolgd door naam partner 99 = Onbekend, wordt standaard 01 in VS
Werknemer - Persoonsgegevens	Geslacht	Verplicht	Employees	gender	36 - Geslacht	Geslacht; M= Man en V = vrouw
Werknemer - Persoonsgegevens	Partner achternaam		Employees	partnerName	27 - Naam Partner
Werknemer - Persoonsgegevens	Partner tussenvoegsel		Employees	partnerNamePrefix	166 - Voorvoegsel Partner
Werknemer			Employees	lastName	524 - Opgemaakte naam
Werknemer			Employees	lastNamePrefix	524 - Voorvoegsel Opgemaakte naam
Werknemer			Employees	titlePrefix	94 - Titel voor
Werknemer - Communicatie [adres]		Ja	Employees	addressType	01 Living address / 02 Postal address	Soort adres; 01 = Woonadres, verblijfadres of vestigingsadres 02 = Postadres cq correspondentie adres 04 = Tijdelijk adres
Werknemer - Communicatie [adres]	Postcode	Verplicht	Employees	postalCode	394 - Postcode
Werknemer - Communicatie [adres]	Woonplaats	Verplicht	Employees	city	395 - Woonplaats
Werknemer - Communicatie [adres]	Huisnummer	Verplicht	Employees	number	392 - Huisnummer
Werknemer - Communicatie [adres]	Huisnummer		Employees	streetNumberAdditional	393 - Huisnummer toevoeging	Huisnr toevoeging wordt aan het huinsnr in VS geplakt.
Werknemer - Communicatie [adres]	Straatnaam		Employees	streetName	391 - Straat	Straatnaam, eventueel afgekort als deze groter is dan 80 karakters
Werknemer - Communicatie [adres]	Land	Verplicht	Employees	country	34 - Woonland > omschrijving
Dienstverbanden - Dienstverband	Personeelsnummer	Verplicht	Employees / employments	personCode	7014 - Uniek Persoonlijk ID (UPI)	De code waarmee de natuurlijk persoon in de administratie van de inhoudingsplichtige bekend is.
		Verplicht	Employees / employments	employmentCode	91 - Contract Id
Dienstverbanden - Dienstverband	Datum in dienst [subdvb]	Verplicht	Employees / employments	hireDate	39 - Datum indienst	Datum wijziging dienstverband
Dienstverbanden - Dienstverband	Datum in dienst [hoofddvb]	Verplicht	Employees / employments	originalHireDate	308 - Datum indienst organisatie	Ingangsdatum dienstverband
Dienstverbanden - Dienstverband	Datum uit dienst		Employees / employments	dischargeDate	10520479 - Geplande laatste datum indienst (40 - Datum uitdienst minus 1 dag)	Einddatum dienstverband
Dienstverbanden - Dienstverband	Functie		Employees / employments	jobProfile	97 - Functie	Naam van de functie die de werknemer uitoefend in het kader van het dvb.
Dienstverbanden - Dienstverband	Normuren per week	Verplicht	Employees / employments	workingAmount	465 - Uren Periode	Norm uren per week
Dienstverbanden			Employees / employments	contractCode	91 - Contract Id
Dienstverbanden			Employees / employments	contractType	10204687 - Contract type
Dienstverbanden			Employees / employments	employeeCode	22 - Medewerkercode
Dienstverbanden			Employees / employments	employmentType	7393 - Type Medewerker
Dienstverbanden			Employees / employments	organizationUnit	6000 - Organisatorische eenheid
		Verplicht	Employees / employments	company	18 - Company code
Verzuimmelding - Melding	Datum 1e ziektedag	Verplicht	Sickness / sickness leave	startDate	7206 - Eerste verzuimdag
		Verplicht	Sickness / sickness leave	Id	7471 - Sleutel van de ziekmelding	Sleutelwaarde voor verzuimdossier
		Verplicht	Sickness / sickness leave	sicknessType	7107 - Soort Ziekte	Vangnetcode; 00 = Geen vangnetgeval 02 = Verzuim a.g.v. van zwangerschap en/of bevalling 03 = Verzuim a.g.v. van orgaandonatie 04 = WW uitkering en meer dan xx weken verzuim 05 = Uitzendkracht of oproepkracht 06 = Beëindiging dienstverband tijdens verzuim 07 = Gedeeltelijk ao /verzuim binnen x jr na begin dnstverb. / Gedeeltelijk arbeidsongeschikt en verzuim binnen xx jaar na begin dienstverband 08 = Bijzonder dienstverband 99 = Overige oorzaken Alleen ziekte t.g.v. zwangerschap wordt hierop gemapt. Default is 99.
			Sickness / sickness leave	sicknessType	7107 - Soort Ziekte	Bepaald protocol in VS; 01 = Zwangerschapsverlof 02 = Adoptieverlof 03 = Pleegzorgverlof
Verzuimmelding - Melding	Start datum	Verplicht	Sickness / sickness leave partial recovery Therapeutic period	startDate	Ingangsdatum van het ziektepercentage	Wijzigingsdatum. Startdatum voor (deel)herstel
Verzuimmelding - Melding	Percentage ziek	Verplicht	Sickness / partial recovery	illnessPercentage	7464 - Ziektepercentage	Ziekte percentage Omrekenen naar herstelpercentage
Verzuimmelding - Melding	Meldingsdatum	Verplicht	Sickness / sickness leave	reportingDate	7189 - Datum ziekmelding	Meldingsdatum
Verzuimmelding - Melding	Datum hersteld		Sickness / sickness leave	recoveryDate	7207 - Eerste werkdag
Verzuimmelding - Melding	Percentage AT		Sickness / Therapeutic period	workingPercentage	7089 - Arbeidstherapiepercentage	Percentage AO/ Arbeidstherapeutisch
Verzuimmelding - Ongeval	Sprake van een ongeval	Verplicht	Sickness / sickness leave	recourse	7391 - Regres	Oorzaak verzuim; 10 = Arbeidsongeval 11 = Verkeersongeval met regresmogelijkheid 99 = Overige redenen Indien geen regres of WAZO code, dan gewoon ziek.
Verzuimmelding			Sickness / sickness leave	absenceReason	Niet beschikbaar
Verzuimmelding			Sickness / sickness leave	dateWVP	7076 - Date WVP
Verzuimmelding			Sickness / sickness leave	hoursWorkedFirstDay	7423 - Gewerkte uren eerste verzuimdag
Verzuimmelding			Sickness / sickness leave	ongoingSickness	7075 - Doorlopend ziektegeval
Verzuimmelding			Sickness / sickness leave	safetynetCase	Niet beschikbaar
		Verplicht	Sickness / Nursing address	postalCode	394 - Postcode
		Verplicht	Sickness / Nursing address	number	392 - Huisnummer
		Verplicht	Sickness / Nursing address	city	395 - Woonplaats
			Sickness / Nursing address	country	34 - Woonland
			Sickness / Nursing address	nameCareAddres	7442 - Naam verpleegadres
			Sickness / Nursing address	numberAdditional	393 - Huisnummer toevoeging
			Sickness / Nursing address	streetName	391 - Straat
			MaternityLeave	actualDeliveryDate	7599 - Feitelijke bevallingsdatum
			MaternityLeave	firstWorkingDay	7596 - Eerste werkdag
			MaternityLeave	probableDeliveryDate	7598 - Vermoedelijke bevallingsdatum
			MaternityLeave	reportingDate	7595 - Datum melding
			MaternityLeave	startDate	7594 - Begindatum verlof / WAZO
			RoleAssignments	personId	10519680 - personNumber
			RoleAssignments	shortName	549 - (short)name of the role assignment
			RoleAssignments	fullName	549 - (full)name of the role assignment
			RoleAssignments	organizationUnitId	548 - Code of the Organisation Unit
			RoleAssignments	includingChildOrgUnits	Inclusief onderlieggende OE's
			RoleAssignments	validFrom	Ingangsdatum van de versie
			RoleAssignments	validTo	Einddatum van de versie

Mutaties op de onderwerpen zwangerschapsverlof (Maternity leave) en de rollen (Role assignments) zijn niet gecontroleerd op doorwerking naar Verzuimsignaal. Advies om bij ingebruikname van de connector de doorwerking te controleren.

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 Verzuimsignaal de entiteit (organisatorische eenheid, medewerker of ziekmelding) niet verwerken. Advies om binnen Youforce deze velden ook verplicht te stellen.

Verzuimsignaal synchroniseert 1 keer per dag de Organisatorische eenheden en de medewerkers, zij doen iedere dag een volledige synchronisatie. De ziekmeldingen worden iedere 8 uur gesynchroniseerd, de ziekmeldingen worden dan opgehaald die de laatste 48 uur zijn veranderd. 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 Verzuimsignaal dus iedere 8 uur een sync op doet.

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

Medewerkers met een uitdienstdatum worden tot 61 dagen na hun uitdienstdatum nog gesynchroniseerd.

Wanneer een medewerker of ziekmelding uit HRCore wordt verwijderd dan moet de medewerker of ziekmelding handmatig uit Verzuimsignaal verwijderd worden. De connector ondersteunt geen 'verwijderingen'.

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

Direct toegang vanuit Youforce naar Verzuimsignaal is niet opgenomen in deze connector en daarmee niet mogelijk.

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