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.

​
id
string
required
Minimum length: 1
​
type
string
required
Allowed value: "job-position"
​
url
string
required
​
employment
object
required

Reference to an employment resource.

Example:
{
  "id": "354",
  "type": "employment",
  "url": "https://example.ilucca.net/lucca-api/employments/354"
}
​
startsOn
string
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.

Example:
{
  "id": "5",
  "type": "business-establishment",
  "url": "https://example.ilucca.net/lucca-api/business-establishments/5"
}
​
department
object
required

Reference to a department.

Example:
{
  "id": "32",
  "type": "department",
  "url": "https://example.ilucca.net/lucca-api/departments/32"
}
​
remoteId
string | null

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

​
employee
object

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

​
endsOn
string | 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.

Example:
{
  "id": "982",
  "type": "job-qualification",
  "url": "https://example.ilucca.net/lucca-api/job-qualifications/982"
}
​
manager
object | null

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

Example:
{
  "id": "416",
  "type": "employee",
  "url": "https://example.ilucca.net/lucca-api/employees/416"
}
​
occupationCategory
object | null

Reference to an occupation-category.

Example:
{
  "id": "443",
  "type": "occupation-category",
  "url": "https://example.ilucca.net/lucca-api/occupation-category/443"
}
​
workingTimeArrangement
object | null

Reference to a working-time-arrangement.

Example:
{
  "id": "98",
  "type": "working-time-arrangement",
  "url": "about:blank"
}
​
document
object | null

Reference to a document resource.

Example:
{
  "id": "95",
  "type": "document",
  "url": "https://example.ilucca.net/lucca-api/documents/95"
}
​
notes
string | null

Optional notes about this job-position change.

Maximum length: 500
​
changedAttributes
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.

List of attributes that can change for a job-position.

Available options:
remoteId,
jobTitle,
jobDescription,
jobQualification,
occupationCategory,
workingTimeArrangement,
department
​
t9n
object
​
createdAt
string

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

Example:

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

​
lastUpdatedAt
string

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

Example:

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

​
links
null

Was this page helpful?