v3

latestOpenAPI 3.1.02026-07-311,0939714.5 MB
Concept employee

Convert a concept employee to an employee

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

This endpoint "converts" the conceptEmployee to an actual employee in Loket. This means creating a number of records including Employee, Employment, WorkingHours, Wage etc. If the promotion is successful the concept employee record will be deleted.

The GUID of the conceptEmployee will be copied over to the GUID of the newly created Employee.

Before performing these steps, quite a number of validations are performed to ensure that the provided information can be used to create a functionally valid employee.

If the employeeNumber is empty then this will be set automatically for the employee. (i.e. highest available number +1)

Additional functionality :

  • It is possible to call an alternative functionality closely related to this functionality. This additional functionality will perform the validation ONLY, and it will NOT convert the conceptEmployee to an actual employee even when all validation rules are successful. Other than not performing the actual step of converting the employee the endpoint will behave identically to the actual endpoint.
  • This functionality can be applied by setting the optional X-ValidateOnly header to true
patch/v2/providers/employers/conceptemployees/{conceptEmployeeId}/convertToEmployee

Path parameters

conceptEmployeeIdstring uuid required

The unique identifier of the concept 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

X-ValidateOnlyboolean

If set to true only the validations will be performed no changes will be committed.

Response

OK