Skip to main content
Working-time arrangements are a beta feature. You may not benefit from this feature. Working-time-arrangements are the replacement for the workcycles. If this feature has not been deployed on your environment, please contact our support.

The job position represents a stage in an employee's career during one of their employment in a given business-establishment.

It therefore outlines the attributes of the person as a professional (qualifications) and their role in the company as well as who's their manager.

​
startsOn
string<date>
required

Effective date of this job-position for this employee.

Cannot be outside the range of the employment.

This should be considered "applicable" based on the related employment business-establishment timezone.

​
businessEstablishment
object
required

Reference to a business-establishment resource.

​
department
object
required

Reference to a department resource. Reference to a department.

​
id
string
Minimum length: 1
​
type
string
Allowed value: "job-position"
​
url
string<uri>
​
remoteId
string | null

Resource identifier in a third-party system. No unicity constraint: two job-positions may have the same value.

Required string length: 1 - 1024
​
employment
object

Reference to an employment resource.

​
employee
object

Read-only. Reference to the employment's employee.

​
status
enum<string>

Read-only. The employee status is calculated from the employee's employments.

  • active: employee has an employment as of today.
  • upcoming: employee currently has no employment but will have one in the future.
  • deactivated: employee used to have an employment but no longer does.
Available options:
active,
upcoming,
deactivated
Examples:

"active"

​
endsOn
string<date> | null

Read-only. End date (included) of this job-position effectiveness.

Is calculated from the startsOn property of the closest next job-position, or the endsOn date of the parent employment.

This should be considered "applicable" based on the related employment business-establishment timezone.

Must be greater or equal than StartsOn date.

​
jobTitle
string | null

Short description of the job occupied by this employee.

Maximum length: 250
​
jobQualification
object | null

Reference to a job-qualification. Reference to a job-qualification resource.

​
manager
object | null

Reference to another employee, who is considered to be this employee's manager. Reference to an employee resource.

​
occupationCategory
object | null

Reference to an occupation-category. Reference to an occupation-category resource.

​
workingTimeArrangement
object | null

Reference to a working-time-arrangement. Reference to a working-time-arrangement resource.

​
document
object | null

Reference to a document resource.

​
notes
string | null

Optional notes about this job-position change.

Maximum length: 500
​
t9n
object
​
updatedAttributes
enum<string>[]

List of attributes that changed compared with this employee previous job-position, even if said job-position was on another employment and/or not immediately sequential.

​
createdAt
string<date-time-offset>

Read-only. UTC timestamp of the moment this object was created.

Examples:

"2023-01-23T12:45:23.1234Z"

​
lastUpdatedAt
string<date-time>

Read-only. UTC timestamp of the moment this object was last updated. Set upon creation, update or deletion of the object.

Examples:

"2023-01-23T12:45:23.1234Z"

​
links
null
⌘I