om een gepersonaliseerde navigatie te krijgen.
om een gepersonaliseerde navigatie te krijgen.
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.
Copyright 2022 Visma Community. All right reserved.