LOloket
Absence

Create an Absence for an employee

Activity name : <a href="https://developer.loket.nl/Activities/PostAbsenceByEmployeeId" target="_blank">PostAbsenceByEmployeeId</a>

Metadata : Possible options for fields of the type 'metadata' can be acquired (GET) by adding /metadata to the POST URL.

Defaults : Default values for a new object can be acquired by adding `/defaults' to the POST URL.

Add an Absence (=verzuimmelding) for an employee.

Please note that if this endpoint is called successfully both an absence (=verzuimmelding) AND one underlying absence progress (=verzuimverloop) will be created.

post/v2/providers/employers/employees/{employeeId}/absences

Request

  • Base URL
    https://api.loket.nl
  • URL
    https://api.loket.nl/v2/providers/employers/employees/{employeeId}/absences
  • Auth
    none required

Path parameters

employeeIdstring uuid required

The unique identifier of the employee

Headers

Authorizationstring required
Example:Bearer <TOKEN>

A valid Bearer token for authorizing the request.

Acceptstring required
Example:application/json;version=2018-01-01

The accept header is used to influence what type of output is returned and in most cases the version of the output

Request body

idstring uuid

The unique identifier of an object (GUID/UUID)

hoursWorkedOnFirstDayOfAbsenceinteger nullable

The number of hours worked on the first day of the absence.

isDisruptedEmploymentRelationshipboolean

Indicates whether the employement relationship between employee and employer is disrupted.

isThirdPartyLiabilityboolean nullable

This field is related to accidentType. When accidentType is specified, this field indicates whether a third party is liable for the accident.

isWorkRelatedIllnessboolean

Beroepsziekte

expectedDateOfChildbirthstring date nullable

Bevallingsdatum

expectedEndDateOfMaternityLeavestring date nullable

verwachte datum einde zwangerschapsverlof

hasMobilityIssueboolean nullable

This field indicates whether the Employee has an issue limiting its mobility.

isRecoveredWithinTwoWeeksboolean

This field indicates whether the Employee is (expected) recoverd within two weeks, relating to a full recovery.

commentsstring nullable

Free text field to register any relevant information.

isHospitalisedboolean nullable

Betreft het een ziekenhuisopnamen

Example request

{
  "id": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
  "causeOfAbsence": {
    "key": 1,
    "value": "maternity leave"
  },
  "hoursWorkedOnFirstDayOfAbsence": 3,
  "actionToBeTakenByOccupationalHealthAndSafetyService": {
    "key": 1,
    "value": "Spoedcontrole aan huis"
  },
  "expectedDuration": {
    "key": 1,
    "value": "Minder dan 1 week"
  },
  "isDisruptedEmploymentRelationship": true,
  "accidentType": {
    "key": 1,
    "value": "work related accident"
  },
  "expectedDateOfChildbirth": "2018-01-21",
  "expectedEndDateOfMaternityLeave": "2018-04-21",
  "comments": "Lorem ipsum dolor sit amet, id nibh adhuc omnium vix, ne nec eius inani aliquip.",
  "contactInformation": {
    "startDate": "2018-01-21",
    "locationType": {
      "key": 1,
      "value": "Hospital"
    },
    "name": "RadboudUMC Nijmegen",
    "street": "Voordijk",
    "city": "Leiden",
    "houseNumber": 12,
    "houseNumberAddition": "D",
    "furtherIndication": {
      "key": 1,
      "value": "WW"
    },
    "postalCode": "1234 AA",
    "country": {
      "key": 1,
      "value": "Netherlands",
      "isoCode": "NL"
    },
    "phoneNumber": "+31 13-1234567"
  },
  "caseManager": {
    "name": "Ben Hur",
    "function": "Ben Hur",
    "organization": "Ben Hur",
    "phoneNumber": "+31 13-1234567"
  },
  "reintegration": {
    "reintegrationGoal": {
      "key": 1,
      "value": "Werkhervatting in de eigen functie"
    }
  },
  "progress": {
    "startDate": "2018-01-21",
    "currentIncapacityPercentage": 100
  }
}

Response

Created

Example response

{
  "version": {
    "resourceVersion": "2018-12-31"
  },
  "messages": [
    {
      "type": "Warning",
      "description": "<some warning>",
      "id": "904d6856-6034-4624-bcbc-886188c115c5",
      "code": 12
    }
  ],
  "content": {
    "id": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
    "causeOfAbsence": {
      "key": 1,
      "value": "maternity leave"
    },
    "hoursWorkedOnFirstDayOfAbsence": 3,
    "actionToBeTakenByOccupationalHealthAndSafetyService": {
      "key": 1,
      "value": "Spoedcontrole aan huis"
    },
    "expectedDuration": {
      "key": 1,
      "value": "Minder dan 1 week"
    },
    "isDisruptedEmploymentRelationship": true,
    "accidentType": {
      "key": 1,
      "value": "work related accident"
    },
    "expectedDateOfChildbirth": "2018-01-21",
    "expectedEndDateOfMaternityLeave": "2018-04-21",
    "comments": "Lorem ipsum dolor sit amet, id nibh adhuc omnium vix, ne nec eius inani aliquip.",
    "contactInformation": {
      "startDate": "2018-01-21",
      "locationType": {
        "key": 1,
        "value": "Hospital"
      },
      "name": "RadboudUMC Nijmegen",
      "street": "Voordijk",
      "city": "Leiden",
      "houseNumber": 12,
      "houseNumberAddition": "D",
      "furtherIndication": {
        "key": 1,
        "value": "WW"
      },
      "postalCode": "1234 AA",
      "country": {
        "key": 1,
        "value": "Netherlands",
        "isoCode": "NL"
      },
      "phoneNumber": "+31 13-1234567"
    },
    "caseManager": {
      "name": "Ben Hur",
      "function": "Ben Hur",
      "organization": "Ben Hur",
      "phoneNumber": "+31 13-1234567"
    },
    "reintegration": {
      "reintegrationGoal": {
        "key": 1,
        "value": "Werkhervatting in de eigen functie"
      }
    },
    "progress": {
      "startDate": "2018-01-21",
      "endOfAbsence": {
        "reason": {
          "key": 1,
          "value": "Fully recoverd"
        }
      },
      "currentIncapacityPercentage": 100
    }
  }
}

Changes

No recorded changes to this operation across all 6 revisions of this API.