Tools4ever HelloID - Visma|Raet IAM API

[#1]

Dit document beschrijft de 'HelloID - Visma Raet IAM API’-connector. Een koppeling gebaseerd op de Visma Raet IAM API.

Onderstaande velden gebruikt HelloID standaard in haar connector. Per implementatie kan hiervan worden afgeweken, vereiste is dat de velden beschikbaar zijn via de IAM API, zie voor de beschikbare velden in de IAM API deze link:

https://community.visma.com/t5/Kennisbank-Youforce-API/IAM-Domain-model-amp-field-mapping/ta-p/42810...

De voor HelloID verplichte velden staan dikgedrukt. De dikgedrukte velden zijn benodigd voor een goede werking van de koppeling. De daadwerkelijk gebruikte en benodigde velden kunnen per implementatie verschillen.

API endpoint	API attribute	HR CoreOnline veldnaam	Omschrijving
Employees	personCode	P01001 - Persoonsnummer	Persoonsnummer
Employees	personId	P01001 - Persoonsnummer	Persoonsnummer
Employees	id	P01001 - Persoonsnummer	Persoonsnummer
Employees	dateOfBirth	P00321 - Geboorte datum	Geboortedatum
Employees	emailAddresses	P01035 - E-mail adres werk	Zakelijk e-mailadres van de medewerker
Employees	firstNames	P01002 - Voornamen	Voornamen
Employees	gender	P00330  - Geslacht	Geslacht
Employees	initials	P00303 - Voorletters	Initialen
Employees	knownAs	P01003 - Roepnaam	Roepnaam
Employees	lastName	P01008 - Samengestelde naam	Samengestelde achternaam
Employees	lastNameAtBirth	P00301 - Geboortenaam	Geboorte-achternaam
Employees	lastNameAtBirthPrefix	P00302 - Geboortenaam voorvoegsels	Geboorte-achternaam-tussenvoegsel
Employees	lastNamePrefix	P01009 - Samengestelde naam voorvoegsel	Samengestelde achternaam-tussenvoegsel
Employees	nameAssembleOrder	P00304 - Gebruik achternaam	Eigennaamcode
Employees	partnerName	P00390 - Partner naam	Achternaam partner
Employees	partnerNamePrefix	P00391 - Voorvoegsel partner	Tussenvoegsel achternaam partner
Employees	phoneNumbers Business	P01037  - Telefoonnummer werk	Zakelijk telefoonnummer
Employees	phoneNumbers Mobile	P01036 - Telefoonnumber mobiel	Mobiel telefoonnummer
Employees	validFrom	Ingangsdatum van de versie	Ingangsdatum van de actuele 'versie'
Employees	validUntil	Einddatum van de versie	Einddatum van de actuele 'versie'
Employment	employmentCode	P01101  - Volgnummer dienstverband	Volgnummer dienstverband
Employment	hireDate	P00322 - Datum in dienst	Datum indienst
Employment	dischargeDate	P00830  - Datum uit dienst	Datum uitdienst
Employment	originalHireDate	P00834 - Datum in dienst CAO	Datum indienst bij de betreffende organisatie
Employment	employmentType	P01102 - Soort arbeidsrelatie	Soort arbeidsrelatie
Employment	jobProfile	P01107 - Primaire functie	Functie vanuit het dienstverband
Employment	organizationUnit	P01106 - Hiërarchisch organisatorische eenheid	Organisatorische eenheid vanuit het dienstverband
Employment	workingAmount	P01109 - Uren per week	Contracturen per week vanuit het dienstverband
Assignments	id	Id van de inzetregel	Unieke id van de inzetregel
Assignments	startDate	P01125 - Ingang inzet	Startdatum van de inzet-regel
-Assignments	endDate	P01126 - Einde inzet	Einddatum van de inzet-regel
Assignments	jobProfile	P0122 - Operationele functie	Functie vanuit de inzet-regel
Assignments	organizationUnit	P1121 - Operationele organisatorische eenheid	Organisatorische eenheid vanuit de inzet-regel
Assignments	workingAmount	P01109 - Uren per week	Contracturen per week vanuit de inzet-regel
Role Assignments	id	P01062 - roleId	Technische code van de roltoewijzing (de rol vastgelegd bij de OE)
Role Assignments	shortName	P01062 - Rol code	Code van de rol (bijvoorbeeld 'MGR')
Role Assignments	startDate	P01063 - Ingangsdatum roltoewijzing	Ingangsdatum van de vastgelegde rol
Role Assignments	endDate	P01064 - Einddatum roltoewijzing	Einddatum van de vastgelegde rol
Role Assignments	organizationUnit	P1121 - Operationele organisatorische eenheid	Bijbehorende OE van de vastgelegde rol
Role Assignments	personCode	P01001 - Persoonsnummer	Persoonsnummer van de vastgelegde rol
Organization Units	fullName	Naam organisatorische eenheid	Tabel met de organisatorische eenheiden, de naam
Organization Units	id	P01061 - Code organisatorische eenheid	Code van de OE
Organization Units	shortName	P01061 - Code organisatorische eenheid	Code van de OE
Organization Units	parentOrgUnit	Organisatie eenheid > Onderdeel van	Code van de 'bovenliggende' OE
Job Profiles	fullName	func_oms - Functie omschrijving	Tabel met de functies, de omschrijving
Job Profiles	shortName	func_code - Functie code	De code van de functie

De tabel met velden is gebasseerd op de standaard-koppeling van Tools4Ever, informeer bij Tools4ever of zij afwijkingen hierop hebben doorgevoerd binnen uw configuratie.

Connector details

Iedere dag doet HelloID een volledige synchronisatie op de bovenstaande velden dus voor alle medewerkers.

Nieuwe medewerkers die zijn opgevoerd in HRCoreOnline worden na een synchronisatie zichtbaar in HelloID. Als bij een bestaande medewerker een waarde in HRCoreOnline is gewijzigd zoals de functie dan is de nieuwe functie zichtbaar in HelloID vanaf het moment dat de wijziging is ingegaan. Oftewel een medewerker krijgt per de 1e van de volgende maand een nieuwe functie dan is de nieuwe functie vanaf de 1e van de volgende maand zichtbaar in HelloID.

Als bij een bestaande medewerker een waarde in HRCore Online is gewijzigd zoals de functie dan wordt deze nieuwe functie doorgegeven aan HelloID.

Afhankelijk van de ingestelde 'businessrules' kan dit er voor zorgen dat accounts of autorisaties in de gekoppelde systemen gemuteerd worden op basis van de ingerichte processen binnen HelloID.

Medewerkers met een uitdienstdatum die langer teruggaat dan 90 dagen worden niet meer gesynchroniseerd.

Filtermogelijkheden

Binnen de IAM API zijn er geen filtermogelijkheden. Echter binnen HelloID kunnen filters ingesteld worden waarmee bijvoorbeeld bepaald kan worden wie een account krijgt en wie niet.