MLM API - Release Notes 2021-05

[#1]

Extra fields endpoints Employees & Contracts

We’ve added two fields "noRisk" & "endDateNoRisk" to the endpoint /contracts & /employees (V1 / V2) related to the data of HR coresystem HRCB (r1). In this HR core system users are able to manage the following WIA / no-risk related elements :

The field ‘No Risk polis van toepassing' is a dropdown with the options Ja/Nee.
The field 'Einddatum no risk periode’ is a date field.

For sharing this relevant information to external MLM systems / UWV, we’ve added two extra fields in the /contracts & /employees endpoints of the MLM API:

• noRisk (boolean field) > mapped to ‘No Risk polis van toepassing'.

• endDateNoRisk (date field) > mapped to ‘Einddatum no risk periode'.

Latest version endpoint /contracts :
(see row 25 & 26)

[
  {
    "validFrom": "2021-06-10T06:24:53.362Z",
    "validUntil": "2021-06-10T06:24:53.362Z",
    "extensions": [
      {
        "key": "string",
        "value": "string"
      }
    ],
    "id": "string",
    "isDeleted": true,
    "employeeCode": "string",
    "personId": "string",
    "contractCode": "string",
    "originalHireDate": "2021-06-10T06:24:53.362Z",
    "dischargeDate": "2021-06-10T06:24:53.362Z",
    "hireDate": "2021-06-10T06:24:53.362Z",
    "company": "string",
    "employmentType": "string",
    "contractType": "string",
    "jobProfile": "string",
    "organizationUnit": "string",
    "fullTimeWorkingAmount": 0,
    "noRisk": true,
    "endDateNoRisk": "2021-06-10T06:24:53.362Z",
    "phoneNumbers": [
      {
        "type": "string",
        "number": "string"
      }
    ],
    "emailAddresses": [
      {
        "type": "string",
        "address": "string"
      }
    ],
    "workingAmount": {
      "amountOfWork": 0,
      "unitOfWork": "string",
      "periodOfWork": "string"
    }
  }
]

Latest version endpoint /employees :
(see row 78 & 79)

[
  {
    "validFrom": "2021-06-10T06:25:58.121Z",
    "validUntil": "2021-06-10T06:25:58.121Z",
    "extensions": [
      {
        "key": "string",
        "value": "string"
      }
    ],
    "id": "string",
    "personCode": "string",
    "isDeleted": true,
    "initials": "string",
    "firstNames": "string",
    "knownAs": "string",
    "lastNameAtBirth": "string",
    "lastNameAtBirthPrefix": "string",
    "lastName": "string",
    "lastNamePrefix": "string",
    "nameAssembleOrder": "string",
    "partnerName": "string",
    "partnerNamePrefix": "string",
    "titlePrefix": "string",
    "titleSuffix": "string",
    "gender": "string",
    "birthDate": "2021-06-10T06:25:58.121Z",
    "deceasedDate": "2021-06-10T06:25:58.121Z",
    "nationalIdentificationNumber": "string",
    "userUID": "string",
    "phoneNumbers": [
      {
        "type": "string",
        "number": "string"
      }
    ],
    "emailAddresses": [
      {
        "type": "string",
        "address": "string"
      }
    ],
    "addresses": [
      {
        "type": "string",
        "streetName": "string",
        "houseNumber": "string",
        "houseNumberAddition": "string",
        "postalCode": "string",
        "city": "string",
        "country": "string"
      }
    ],
    "contracts": [
      {
        "validFrom": "2021-06-10T06:25:58.121Z",
        "validUntil": "2021-06-10T06:25:58.121Z",
        "extensions": [
          {
            "key": "string",
            "value": "string"
          }
        ],
        "id": "string",
        "isDeleted": true,
        "employeeCode": "string",
        "personId": "string",
        "contractCode": "string",
        "originalHireDate": "2021-06-10T06:25:58.121Z",
        "dischargeDate": "2021-06-10T06:25:58.121Z",
        "hireDate": "2021-06-10T06:25:58.121Z",
        "company": "string",
        "employmentType": "string",
        "contractType": "string",
        "jobProfile": "string",
        "organizationUnit": "string",
        "fullTimeWorkingAmount": 0,
        "noRisk": true,
        "endDateNoRisk": "2021-06-10T06:25:58.121Z",
        "phoneNumbers": [
          {
            "type": "string",
            "number": "string"
          }
        ],
        "emailAddresses": [
          {
            "type": "string",
            "address": "string"
          }
        ],
        "workingAmount": {
          "amountOfWork": 0,
          "unitOfWork": "string",
          "periodOfWork": "string"
        }
      }
    ]
  }
]

By using the fields ‘No Risk polis van toepassing' & 'Einddatum no risk periode’ in the above screen of HRCB the ‘sickleave coordinators' of our customers can manage all fields for administrative purposes. Only the red alligned elements are exposed to the MLM API for external sharing reasons.