Updates a Contract version

put https://api.factorialhr.com/api/2025-01-01/resources/contracts/contract_versions/{id}

Path Params

string

required

contract version identifier.

Body Params

integer

required

contract version identifier.

employee_id

integer

employee identifier, refers to /employees/employees endpoint.

effective_on

string

the day the specific contract starts, in case of hiring the same than starts_on.

starts_on

string

the day the employee is hired.

ends_on

string

the day the employee is terminated.

working_hours_frequency

string

the frequency of the working hours.

working_week_days

string

the days of the week the employee works.

working_hours

integer

the amount of hours the employee works.

salary_frequency

string

the frequency of the salary payment.

salary_amount

integer

the amount of money the employee earns.

job_title

string

job title of the employee.

es_cotization_group

integer

cotization group identifier.

es_professional_category_id

integer

professional category identifier.

es_education_level_id

integer

education level identifier.

es_contract_type_id

integer

contract type identifier.

es_working_day_type_id

integer

working day type identifier.

has_trial_period

boolean

a flag that indicates if the employee has a trial period.

trial_period_ends_on

string

when the trial period ends.

Response

Response body

object

integer

identifier for the contract version.

company_id

integer

required

identifier for company.

employee_id

integer

required

employee identifier, refers to /employees/employees endpoint.

effective_on

string

required

the day the specific contract starts, in case of hiring the same than starts_on.

country

string

nationality country code of the employee (Spain ES, United Kingdom GB).

job_title

string

job title of the employee.

job_catalog_level_id

integer

job catalog level identifier, refers to /job_catalog/levels endpoint.

job_catalog_level

string

the level of the employee in the job catalog.

job_catalog_role

string

the role of the employee in the job catalog.

starts_on

string

the day the employee is hired.

ends_on

string

the day the employee is terminated.

has_payroll

boolean

required

boolean that indicates if the employee asociated to this contract belongs to a payroll policy.

has_trial_period

boolean

a flag that indicates if the employee has a trial period.

trial_period_ends_on

string

when the trial period ends.

salary_amount

integer

the amount of money the employee earns.

salary_frequency

string

the frequency of the salary payment.

working_week_days

string

the days of the week the employee works.

working_hours

integer

the amount of hours the employee works.

working_hours_frequency

string

the frequency of the working hours.

max_legal_yearly_hours

integer

the maximum amount of hours the employee can work in a year.

maximum_weekly_hours

integer

the maximum amount of hours the employee can work in a week.

created_at

string

required

the date the contract version was created.

updated_at

string

required

the date of the last contract version updated.

es_has_teleworking_contract

boolean

flag that indicates if the contract has teleworking.

es_cotization_group

integer

the group of cotization of the employee.

contracts_es_tariff_group_id

integer

the group of cotization of the employee.

es_contract_observations

string

observations of the contract.

es_job_description

string

the job description of the employee.

es_contract_type_id

integer

contract type identifier.

es_working_day_type_id

integer

working day type identifier.

es_education_level_id

integer

education level identifier.

es_professional_category_id

integer

professional category identifier.

fr_employee_type

string

employee type.

fr_forfait_jours

boolean

required

flag that indicates if the employee is allowed to work within the framework of a fixed number of days.

fr_jours_par_an

integer

the number of days the employee is allowed to work.

fr_coefficient

string

coefficient for france contracts.

fr_contract_type_id

integer

contract type identifier.

fr_level_id

integer

level identifier.

fr_step_id

integer

step identifier.

fr_mutual_id

integer

mutual identifier.

fr_professional_category_id

integer

professional category identifier.

fr_work_type_id

integer

work type identifier.

de_contract_type_id

integer

contract type identifier.

pt_contract_type_id

integer

contract type identifier.

xxxxxxxxxx
curl --request PUT \
     --url https://api.factorialhr.com/api/2025-01-01/resources/contracts/contract_versions/id \
     --header 'accept: application/json' \
     --header 'content-type: application/json'

200OK