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.
Volledig artikel weergeven