Contracts > ContractVersion > Creates

wbhk

Webhooks > Contracts > ContractVersion > Creates

Subscription_type: contracts/contract_version/create

Payload

Callback payload

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_tree_node_uuid

string

the uuid node in the job catalog tree. For now it only supports level nodes. From this point in the job catalog tree you can get the full ancestor path to the root node including the role. Refer to job_catalog/tree_nodes endpoint.

starts_on

string

the day the employee is hired.

ends_on

string

the day the employee is terminated. It has nothing to do with trial period, these are concepts totally unrelated.

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 contract version has ever had a trial period.

trial_period_ends_on

string

when the trial period ends. If there is no date, it means that the employee has never been in trial. This date is not related with the end date of a contract.

salary_amount

integer

the amount of money the employee earns in cents.

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.

bank_holiday_treatment

string

enum

required

Defines whether a bank holiday should be considered as a workable or non-workable day.

Allowed:

working_time_percentage_in_cents

integer

Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).

annual_working_time_distribution

string

enum

Allows companies to define how annual working hours are spread across the year to ensure compliance with legal limits.

Allowed:

min_rest_minutes_between_days

integer

the minimum amount of minutes the employee must rest between working periods.

max_work_minutes_per_day

integer

the maximum amount of minutes the employee can work in a day.

max_work_days_in_row

integer

the maximum amount of days the employee can work in a row.

min_rest_hours_in_row

integer

the minimum amount of hours the employee must rest in a row.

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.

Response

200

Return a 200 status to indicate that the data was received successfully