MLM API - Release Notes 2021-02

[#1]

Release field “fullTimeWorkingAmount”

In January we’ve improved the field “fullTimeWorkingAmount”, which indicates the full-time hours per period within a specific company. For example 40 or 36 hours per week.
This field is now finally released to the PROD environments of the MLM API.

In December 2020 this field was already correctly shown in the endpoint:

Endpoint /companies

[
{
"validFrom": "2021-03-22T16:33:20.583Z",
"validUntil": "2021-03-22T16:33:20.583Z",
"extensions": [
{
"key": "string",
"value": "string"
}
],
"id": "string",
"code": "string",
"name": "string",
"totalWorkAmount": "string",
"establishmentCountry": "string",
"isDeleted": true,
"address": {
"street": "string",
"houseNumber": "string",
"houseNumberAddition": "string",
"postalCode": "string",
"city": "string",
"country": "string"
},
"mailingAddress": {
"boxNumber": "string",
"postalCode": "string",
"cityTown": "string"
}
}
]

In January 2021 we’ve corrected the position in the different body responses of other endpoints. Until Dec-2020 the field “fullTimeWorkingAmount” was part of the Person data details. However, the values of this specific field belong to contracts/employments. That’s why we’ve added the field to the endpoints:

Endpoint /contracts

[
  {
    "validFrom": "2021-03-22T16:34:23.131Z",
    "validUntil": "2021-03-22T16:34:23.131Z",
    "extensions": [
      {
        "key": "string",
        "value": "string"
      }
    ],
    "id": "string",
    "isDeleted": true,
    "employeeCode": "string",
    "personId": "string",
    "contractCode": "string",
    "originalHireDate": "2021-03-22T16:34:23.131Z",
    "dischargeDate": "2021-03-22T16:34:23.131Z",
    "hireDate": "2021-03-22T16:34:23.131Z",
    "company": "string",
    "employmentType": "string",
    "contractType": "string",
    "jobProfile": "string",
    "organizationUnit": "string",
    "fullTimeWorkingAmount": 0,
    "phoneNumbers": [
      {
        "type": "string",
        "number": "string"
      }
    ],
    "emailAddresses": [
      {
        "type": "string",
        "address": "string"
      }
    ],
    "workingAmount": {
      "amountOfWork": 0,
      "unitOfWork": "string",
      "periodOfWork": "string"
    }
  }
]

Endpoint /employees

[
  {
    "validFrom": "2021-03-22T16:36:27.514Z",
    "validUntil": "2021-03-22T16:36:27.514Z",
    "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-03-22T16:36:27.514Z",
    "deceasedDate": "2021-03-22T16:36:27.514Z",
    "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-03-22T16:36:27.514Z",
        "validUntil": "2021-03-22T16:36:27.514Z",
        "extensions": [
          {
            "key": "string",
            "value": "string"
          }
        ],
        "id": "string",
        "isDeleted": true,
        "employeeCode": "string",
        "personId": "string",
        "contractCode": "string",
        "originalHireDate": "2021-03-22T16:36:27.514Z",
        "dischargeDate": "2021-03-22T16:36:27.514Z",
        "hireDate": "2021-03-22T16:36:27.514Z",
        "company": "string",
        "employmentType": "string",
        "contractType": "string",
        "jobProfile": "string",
        "organizationUnit": "string",
        "fullTimeWorkingAmount": 0,
        "phoneNumbers": [
          {
            "type": "string",
            "number": "string"
          }
        ],
        "emailAddresses": [
          {
            "type": "string",
            "address": "string"
          }
        ],
        "workingAmount": {
          "amountOfWork": 0,
          "unitOfWork": "string",
          "periodOfWork": "string"
        }
      }
    ]
  }
]