Mijn Communities
Help

mijnLMS - Visma YouServe Learning API

03-03-2021 16:45
  • 0 Antwoorden
  • 0 kudos
  • 445 Weergaven

This document described the ‘mijnLMS - Visma Raet Learning API’-connector. This connector has been built on top of the Visma Raet Learning API.

mijnLMS is a integrated learning-portal which provides organisations with the tools to manage and automate their own training processes and provide central access to their own learning tools and those of 3th parties.
You can read more about the partnership between Visma | Raet and Online Academie for the intergration between the Visma | Raet Youforce platform and mijnLMS on https://www.vismaraet.nl/over-ons/nieuws/samenwerkingsverband-online-academie/

The following fields are used by the mijnLMS connector, required fields are highlighted in bold. Fields described as Uniqe are unique within their entity and tenant.

Field connector API Endpoint API attribute HRCore Business HRCore Online Functional description
ID Employees personId N/A - Technische sleutel medewerker P01001 - Persoonsnummer Unique identifier of the employee
first_name Employees knownAs 165 - Roepnaam P01003 - Roepnaam The employees nickname
last_name Employees lastName

524 - Opgemaakte naam aanhef*
*This field is combination of the last name and the last name prefix

P01008 - Samengestelde naam The persons last name (based on selected name preference)
valid_until Employees validUntil N/A - Ingangsdatum N/A Start date of the version of the employee
N/A Employees validFrom N/A - Einddatum N/A End date of the version of the employee
user_email Employees

emailAddresses

type:"Business"

address

7212 - E-mailadres P01035 - E-mail adres werk List the business email address of the employee
organisationId Employees

employments

company

18 - Bedrijfscode N/A The functional company code of the employees contract (employment)
date_hire Employees

employments

hireDate

39 - Datum indienst P00322 - Datum in dienst The start date of the employees contract (employment)
date_out Employees

employments

dischargeDate

10520479 - Geplande laatste datum indienst*

*Datum uitdienst minus 1 dag

P00830 - Datum uit dienst The end date of the employees contract (employment)
function_id Employees jobProfile 97 - Functie P01107 - Primaire functie The functional job profile code of the employees contract (employment)
lms_organisation_id Employees

employments

organizationUnit

6000 - Organisatorische eenheid P01106 - Hierarchische org. eenheid The functional organizational unit code of the employees contract (employment)

id

Companies id N/A - Technische sleutel bedrijf N/A Unique identifier of the company
organisationId Companies code 18 - Bedrijfscode (code) N/A Functional code of the company
org_name Companies fullName 18 - Bedrijfscode (omschrijving) N/A Functional name of the company
N/A Companies validUntil N/A - Ingangsdatum N/A Start date of that version of the company
N/A Companies validFrom N/A - Einddatum N/A End date of that version of the company

id

JobProfiles id N/A - Technische sleutel functie N/A Unique identifier of the job profile
function_id JobProfiles shortName 97 - Functie code func_kd - Functie code Functional code of the job profile
function_name JobProfiles fullName 97 - Functie code omschrijving func_oms - Functie omschrijving Functional name of the job profile
N/A JobProfiles validUntil N/A - Ingangsdatum N/A Start date of that version of the job profile
N/A JobProfiles validFrom N/A - Einddatum N/A End date of that version of the job profile
lms_organisation_id OrganizationUnits id N/A - Technische sleutel OE N/A - Technische sleutel OE Unique identifier of the organizational unit
lms_organisation_name OrganizationUnits fullName 549 - Naam OE P01061 - Code organisatorische eenheid Functional code of the organizational unit
N/A OrganizationUnits organizationUnitType 7475 - Type organisatorische eenheid N/A - Type organisatorische eenheid Functional name of the organizational unit
lms_parent_id OrganizationUnits parentOrgUnit N/A - Technische sleutel van bovenliggende OE N/A - Technische sleutel van bovenliggende OE Unique identifier of the parent organizational unit
id_manager OrganizationUnits manager 7137 - manager N/A

Unique identifier of the manager of the organizational unit*

*Only for HR Core Business. For HR Core Online the manager is part of the role assignment

Connector details

Each day mijnLMS does a full-load on the described endpoints and detects changes on their side including future changes. Every employee needs to comply with the required fields (highlighted in bold) when this is not met the employee will be ignored and not processed. To ensure proper working of the connector the required fields need to be properly configured in the Youforce customer setup. Employees which have been discharged will be ignored and no longer processed by mijnLMS

Filter applications for HR Core Business-customers

HR Core Business enables filtering on ‘company’ excluding them from the connector sync. The range of companies depends on how it is configured on the customer level in HR CORE visible through the ‘Search company’ list. There is also a possibility to filter on  ‘employee type’ (7393). By default, no filter is applied and any required filters need to be requested through a service desk ticket  

Filter applications for HR Core Online-customers

HR Core Online enables filtering on the field ‘Employment type’ (P01102). By default, no filter is applied and any required filters need to be requested through a service desk ticket  

Value lists for HR Core Business-customers (for example jobprofile)

Fields with a complex type (code and description) need to be configured in the value lists on the customer level (any lower level is not supported). The value lists can be retrieved through the “valuelist” endpoint.