LOloket
Employment

Terminate an employment.

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

Terminate an employment. Effectively, the endDate of the employment will be set to the given date.<br/> Please note that setting the endDate for an employment affects multiple resources in Loket (e.g. wage, workingHours and absence). Note that the termination date is to be filled with the last day of employment.<br/>

If the termination needs to be reversed use the ../employments/{employmentId}/reinstate endpoint. <br/> If the termination needs to be changed, use this endpoint to revise the termination data<br/>

The metadata for endOfEmploymentReason and endOfEmploymentReasonTaxAuthorities are included in the 'regular' metadata-endpoint of the Employment resource.

patch/v2/providers/employers/employees/employments/{employmentId}/terminate

Request

  • Base URL
    https://api.loket.nl
  • URL
    https://api.loket.nl/v2/providers/employers/employees/employments/{employmentId}/terminate
  • Auth
    none required

Path parameters

employmentIdstring uuid required

The unique identifier of the employment

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

endDatestring date

The date on which the employment ends (=last day of the employment).

endOfEmploymentDueToIllnessboolean

Indicates whether the reason for the termination of an employment is due to long-term illness. Mandatory if endDate is filled, else leave empty.

createMdvEntryboolean

Indicates whether an MDV-entry should automatically be generated (not sent) by Loket (Melding Dienstverband). This should typically only be used for Colland-related employments and if the module MDV is active for an employer, which means in most cases this indicator should be set to false.

Next to that, a message is ONLY generated when the employment is actually terminated by performing this action (=the employment did not already have an endDate before calling this endpoint).

Example request

{
  "endDate": "2018-10-23",
  "endOfEmploymentReason": {
    "key": 1,
    "value": "VUT"
  },
  "endOfEmploymentReasonTaxAuthorities": {
    "key": 1,
    "value": "Opzegging door de werkgever binnen de proeftijd."
  }
}

Response

OK

contentobject

Example response

{
  "version": {
    "resourceVersion": "2018-12-31"
  },
  "messages": [
    {
      "type": "Warning",
      "description": "<some warning>",
      "id": "904d6856-6034-4624-bcbc-886188c115c5",
      "code": 12
    }
  ]
}

Changes

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