Create a work-contract

Create a new work-contract.

There are two possible scenarios:

The user/employee already exists: in this case, you may first have to set an end date to the previous contract.
The user does not already exist:
- recommended POST /api/v3/users?contract=true: this will create the user and his contract. You may then need to PATCH the contract that was thus created in order to set additional data.
- POST /api/v3/users?contract=false: this will create the user without a contract. It will therefore be essential to create your contract via a POST on the contracts API.

POST

directory

api

4.0

work-contracts

curl --request POST \
  --url https://{host}/directory/api/4.0/work-contracts \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "ownerId": 89,
  "startsOn": "2022-01-19",
  "establishmentId": 1,
  "spcId": 0,
  "typeId": 1,
  "hiringTypeId": 1,
  "trialPeriodDays": 120,
  "renewedTrialPeriodDays": 240,
  "externalId": "123",
  "endsOn": "2022-02-10",
  "terminationReasonId": 27
}'

{
  "id": 514,
  "ownerId": 416,
  "startsOn": "2021-01-01",
  "endsOn": null,
  "isApplicable": true,
  "establishmentId": 13,
  "spcId": 1,
  "typeId": 1,
  "hiringTypeId": 3,
  "terminationReasonId": null,
  "trialPeriodDays": 120,
  "renewedTrialPeriodDays": null,
  "trialPeriodEndDate": "2021-05-01",
  "trialPeriodEndDate2": null,
  "authorId": 45,
  "lastModifierId": 45,
  "createdAt": "2021-11-08T17:48:18.12",
  "lastModifiedAt": "2024-01-10T12:27:02.22"
}

Headers

Authorization

string

required

API key. Value must be formatted like so: lucca application={api_key}.

Body

application/json

Response

200

application/json

The response is of type object.

List work-contracts

Retrieve a work-contract

curl --request POST \
  --url https://{host}/directory/api/4.0/work-contracts \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "ownerId": 89,
  "startsOn": "2022-01-19",
  "establishmentId": 1,
  "spcId": 0,
  "typeId": 1,
  "hiringTypeId": 1,
  "trialPeriodDays": 120,
  "renewedTrialPeriodDays": 240,
  "externalId": "123",
  "endsOn": "2022-02-10",
  "terminationReasonId": 27
}'

{
  "id": 514,
  "ownerId": 416,
  "startsOn": "2021-01-01",
  "endsOn": null,
  "isApplicable": true,
  "establishmentId": 13,
  "spcId": 1,
  "typeId": 1,
  "hiringTypeId": 3,
  "terminationReasonId": null,
  "trialPeriodDays": 120,
  "renewedTrialPeriodDays": null,
  "trialPeriodEndDate": "2021-05-01",
  "trialPeriodEndDate2": null,
  "authorId": 45,
  "lastModifierId": 45,
  "createdAt": "2021-11-08T17:48:18.12",
  "lastModifiedAt": "2024-01-10T12:27:02.22"
}