Odoo 19.0 Community · Persistent

hr.version: fields, relations and API

The hr.version model ("Employee Contract") is a persistent model declared by the Employees module, then extended by 5 other modules. It exposes 98 fields, 69 of them declared directly on the model; 5 fields from other models point to it. Below you will find every field with its technical name, type, label and relations, followed by an Odoo 19 JSON-2 API call.

View source code Search another model

Model identity

Technical name: hr.version
Label: Employee Contract
Type: Persistent (models.Model)
SQL table: hr_version
Origin module: Employees (hr)
Extended by: hr_attendance, hr_holidays, hr_work_entry, hr_work_entry_holidays, l10n_fr_hr_work_entry_holidays
Default order (_order): date_version
Display field (_rec_name): name
Inherits from (mixins): mail.thread mail.activity.mixin

Model fields

69 own fields, 24 inherited from mixins and 5 automatic ORM fields. Click a name to get a direct link to that field.

Hide inherited fields

98 of 98 fields shown

Technical name	Label	Type	Details
active	Active	`boolean`
active_employee	Active Employee	`boolean`	related: `employee_id.active`
additional_note	Additional Note	`text`
address_id	Work Address	`many2one` → res.partner
allowed_country_state_ids	Allowed Country State	`many2many` → res.country.state	computed
children	Dependent Children	`integer`
company_country_id	Company country	`many2one` → res.country	read-only related: `company_id.country_id`
company_id	Company	`many2one` → res.company	computed, stored
contract_date_end	Contract End Date End date of the contract (if it's a fixed-term contract).	`date`
contract_date_start	Contract Start Date	`date`
contract_template_id	Contract Template Select a contract template to auto-fill the contract form with predefined values. You can still edit the fields as needed after applying the template.	`many2one` → hr.version
contract_type_id	Contract Type	`many2one` → hr.contract.type
contract_wage	Contract Wage	`monetary`	computed
country_code	Country Code	`char`	read-only related: `company_country_id.code`
country_id	Nationality (Country)	`many2one` → res.country
currency_id	Currency	`many2one` → res.currency	read-only related: `company_id.currency_id`
date_end	Date End	`date`	computed
date_generated_from	Generated From	`datetime`	requiredread-only added by Work Entries (`hr_work_entry`)
date_generated_to	Generated To	`datetime`	requiredread-only added by Work Entries (`hr_work_entry`)
date_start	Date Start	`date`	computed
date_version	Date Version	`date`	required
department_id	Department	`many2one` → hr.department
departure_date	Departure Date	`date`
departure_description	Additional Information	`html`
departure_reason_id	Departure Reason	`many2one` → hr.departure.reason
display_name	Display Name	`char`	computed
distance_home_work	Home-Work Distance	`integer`
distance_home_work_unit	Home-Work Distance unit	`selection`	required Values: `kilometers` (km), `miles` (mi)
employee_id	Employee	`many2one` → hr.employee
employee_type	Employee Type	`selection`	required Values: `employee` (Employee), `worker` (Worker), `student` (Student), `trainee` (Trainee), `contractor` (Contractor), `freelance` (Freelancer)
hr_responsible_id	HR Responsible Person responsible for validating the employee's contracts.	`many2one` → res.users	required
identification_id	Identification No Enter the employee's National Identification Number issued by the government (e.g., Aadhaar, SIN, NIN). This is used for official records and statutory compliance.	`char`
is_current	Is Current	`boolean`	computed
is_custom_job_title	Is Custom Job Title	`boolean`	computed, stored
is_flexible	Is Flexible	`boolean`	computed, stored
is_fully_flexible	Is Fully Flexible	`boolean`	computed, stored
is_future	Is Future	`boolean`	computed
is_in_contract	Is In Contract	`boolean`	computed
is_past	Is Past	`boolean`	computed
job_id	Job	`many2one` → hr.job
job_title	Job Title	`char`	computed, stored
km_home_work	Home-Work Distance in Km	`integer`	computed, stored
last_generation_date	Last Generation Date	`date`	read-only added by Work Entries (`hr_work_entry`)
last_modified_date	Last Modified on	`datetime`	required
last_modified_uid	Last Modified by	`many2one` → res.users	required
marital	Marital Status	`selection`	required Values computed at runtime
member_of_department	Member of department Whether the employee is a member of the active user's department or one of it's child department.	`boolean`	computed
name	Name	`char`
passport_expiration_date	Passport Expiration Date	`date`
passport_id	Passport No	`char`
private_city	Private City	`char`
private_country_id	Private Country	`many2one` → res.country
private_state_id	Private State	`many2one` → res.country.state
private_street	Private Street	`char`
private_street2	Private Street2	`char`
private_zip	Private Zip	`char`
resource_calendar_id	Working Hours	`many2one` → resource.calendar
ruleset_id	Ruleset	`many2one` → hr.attendance.overtime.ruleset	added by Attendances (`hr_attendance`)
sex	Gender This is the legal sex recognized by the state.	`selection`	Values: `male` (Male), `female` (Female), `other` (Other)
spouse_birthdate	Spouse Birthdate	`date`
spouse_complete_name	Spouse Legal Name	`char`
ssnid	SSN No Social Security Number	`char`
structure_type_id	Salary Structure Type	`many2one` → hr.payroll.structure.type	computed, stored
trial_date_end	End of Trial Period End date of the trial period (if there is one).	`date`
tz	Tz	`selection`	related: `employee_id.tz`
wage	Wage Employee's monthly gross wage.	`monetary`
work_entry_source	Work Entry Source Defines the source for work entries generation Working Schedule: Work entries will be generated from the working hours below. Attendances: Work entries will be generated from the employee's attendances. (requires Attendance app) Planning: Work entries will be generated from the employee's planning. (requires Planning app)	`selection`	required Values: `calendar` (Working Schedule) added by Work Entries (`hr_work_entry`)
work_entry_source_calendar_invalid	Work Entry Source Calendar Invalid	`boolean`	computed added by Work Entries (`hr_work_entry`)
work_location_id	Work Location	`many2one` → hr.work.location
activity_calendar_event_id	Next Activity Calendar Event	`many2one` → calendar.event	computed inherited from mail.activity.mixin
activity_date_deadline	Next Activity Deadline	`date`	read-onlycomputed inherited from mail.activity.mixin
activity_exception_decoration	Activity Exception Decoration Type of the exception activity on record.	`selection`	computed Values: `warning` (Alert), `danger` (Error) inherited from mail.activity.mixin
activity_exception_icon	Icon Icon to indicate an exception activity.	`char`	computed inherited from mail.activity.mixin
activity_ids	Activities	`one2many` → mail.activity	inverse: `res_id` inherited from mail.activity.mixin
activity_state	Activity State Status based on activities Overdue: Due date is already passed Today: Activity date is today Planned: Future activities.	`selection`	computed Values: `overdue` (Overdue), `today` (Today), `planned` (Planned) inherited from mail.activity.mixin
activity_summary	Next Activity Summary	`char`	related: `activity_ids.summary` inherited from mail.activity.mixin
activity_type_icon	Activity Type Icon	`char`	related: `activity_ids.icon` inherited from mail.activity.mixin
activity_type_id	Next Activity Type	`many2one` → mail.activity.type	related: `activity_ids.activity_type_id` inherited from mail.activity.mixin
activity_user_id	Responsible User	`many2one` → res.users	read-onlycomputed inherited from mail.activity.mixin
has_message	Has Message	`boolean`	computed inherited from mail.thread
message_attachment_count	Attachment Count	`integer`	computed inherited from mail.thread
message_follower_ids	Followers	`one2many` → mail.followers	inverse: `res_id` inherited from mail.thread
message_has_error	Message Delivery error If checked, some messages have a delivery error.	`boolean`	computed inherited from mail.thread
message_has_error_counter	Number of errors Number of messages with delivery error	`integer`	computed inherited from mail.thread
message_has_sms_error	SMS Delivery error If checked, some messages have a delivery error.	`boolean`	computed inherited from mail.thread
message_ids	Messages	`one2many` → mail.message	inverse: `res_id` inherited from mail.thread
message_is_follower	Is Follower	`boolean`	computed inherited from mail.thread
message_needaction	Action Needed If checked, new messages require your attention.	`boolean`	computed inherited from mail.thread
message_needaction_counter	Number of Actions Number of messages requiring action	`integer`	computed inherited from mail.thread
message_partner_ids	Followers (Partners)	`many2many` → res.partner	computed inherited from mail.thread
my_activity_date_deadline	My Activity Deadline	`date`	read-onlycomputed inherited from mail.activity.mixin
rating_ids	Ratings	`one2many` → rating.rating	inverse: `res_id` inherited from mail.thread
website_message_ids	Website Messages Website communication history	`one2many` → mail.message	inverse: `res_id` inherited from mail.thread
create_date	Created on	`datetime`	read-onlyautomatic
create_uid	Created by	`many2one` → res.users	read-onlyautomatic
id	ID	`integer`	read-onlyautomatic
write_date	Last Updated on	`datetime`	read-onlyautomatic
write_uid	Last Updated by	`many2one` → res.users	read-onlyautomatic

Relations

Models linked from this model

hr.attendance.overtime.ruleset: ruleset_id
hr.contract.type: contract_type_id
hr.department: department_id
hr.departure.reason: departure_reason_id
hr.employee: employee_id
hr.job: job_id
hr.payroll.structure.type: structure_type_id
hr.version: contract_template_id
hr.work.location: work_location_id
res.company: company_id
res.country: company_country_id, country_id, private_country_id
res.country.state: allowed_country_state_ids, private_state_id
res.currency: currency_id
res.partner: address_id
res.users: hr_responsible_id, last_modified_uid
resource.calendar: resource_calendar_id

Fields of other models pointing here

hr.employee: current_version_id, version_id
hr.version: contract_template_id
hr.version.wizard: contract_template_id
hr.work.entry: version_id

Reading this model through the API

Odoo 19 JSON-2 API call reading the first five records with real fields of the model. Replace the instance, database and API key with your own.

curl

curl -X POST "https://your-instance.odoo.com/json/2/hr.version/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","date_generated_from","date_generated_to","date_version","distance_home_work_unit"],"limit":5}'

Python (requests)

import requests

BASE_URL = "https://your-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "your-db"}

res = requests.post(
    f"{BASE_URL}/hr.version/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","date_generated_from","date_generated_to","date_version","distance_home_work_unit"], "limit": 5},
)
res.raise_for_status()
print(res.json())

External API access requires Odoo's Custom plan.
XML-RPC and JSON-RPC will be removed in Odoo 22 (fall 2028): use JSON-2.
The access rights and record rules of the key's user apply.

Cite this tool

Writing a tutorial, internal documentation or a forum answer? Copy this link to send your readers to the up-to-date reference.

<a href="https://aidoo.ai/en/outils/explorateur-modeles-odoo/hr-version">hr.version (Odoo 19.0)</a>

Sources

Data verified on September 23, 2026 · Odoo 19.0 Community

Have an Odoo project, or want to put your ERP to work with AI? Let's talk

Implementation, custom module development, connecting Claude or ChatGPT to your data: tell us about your context and we will reply within 24 business hours.