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"

I