v1

latestOpenAPI 3.1.0Apache 2.02026-07-22160175414.0 KB

Work-Contracts

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

Request body

idinteger

Unique identifier of this work-contract.

ownerIdinteger

Unique identifier of the employee this work-contract belongs to.

externalIdstring nullable

Third-party identifier of this work-contract. May be not unique.

typeIdinteger

Identifier of the work-contract template this work-contract conforms to. Determines whether certain optional properties are required.

startsOnstring date

Start date of this work-contract. Format: YYYY-mm-DD.

isApplicableboolean

Readonly. Whether this work-contract applies to the employee at this very moment.

A work-contract is considered "applicable" if:

It is the ongoing work-contract as of today;
If there is none, then it is the first upcoming work-contract;
If not, then it is the last work-contract this employee had.

establishmentIdinteger

Identifier of the establishment the employee works for.

spcIdinteger nullable

Identifier of the socio-professional category.

Refer to the API endpoint: /organization/structure/api/occupation-categories.

hiringTypeIdinteger nullable

Identifier of a hiring reason type.

Refer to the API endpoint: /directory/api/work-contract-hiring-types.

trialPeriodDaysinteger nullable

Number of days of the initial trial period.

renewedTrialPeriodDaysinteger nullable

Number of days of renewed trial period (equal to the length of the initial period, plus the renewal period).

trialPeriodEndDatestring date nullable

Initial trial period end date. Format: YYYY-mm-DD.

trialPeriodEndDate2string date nullable

Renewed trial period end date. Format: YYYY-mm-DD.

temporaryContractGroundIdinteger nullable

Identifier of the temporary contract ground.

Refer to the API endpoint: /directory/api/work-contract-temporary-contract-grounds.

internshipSupervisorIdinteger nullable

Identifier of the employee/user that acts as internship supervisor.

endsOnstring date nullable

End date of this work-contract. Leave null if not (yet) known. Format: YYYY-mm-DD.

terminationReasonIdinteger nullable

Identifier of the termination reason.

Refer to the API endpoint: /directory/api/work-contract-termination-reasons.

authorIdinteger

Read-only. Identifier of the user who created this work-contract.

createdAtstring date-time

Read-only. Timestamp of the moment this work-contract was created.

lastModifierIdinteger

Read-only. Identifier of the user who last modified this work-contract.

lastModifiedAtstring date-time

Read-only. Timestamp of the moment this work-contract was last updated.

Example request

{
  "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"
}

Response