Odoo 19.0 Community · Persistant

hr.version : champs, relations et API

Le modèle hr.version (« Contrat de l'employé ») est un modèle persistant déclaré par le module Employés, puis enrichi par 5 autres modules. Il expose 98 champs, dont 69 déclarés directement sur le modèle ; 5 champs d'autres modèles pointent vers lui. Retrouvez ci-dessous chaque champ avec son nom technique, son type, son libellé français et ses relations, puis un exemple d'appel à l'API JSON-2 d'Odoo 19.

Voir le code source Rechercher un autre modèle

Fiche d'identité

Nom technique: hr.version
Libellé: Contrat de l'employé
Type: Persistant (models.Model)
Table SQL: hr_version
Module d'origine: Employés (hr)
Étendu par: hr_attendance, hr_holidays, hr_work_entry, hr_work_entry_holidays, l10n_fr_hr_work_entry_holidays
Tri par défaut (_order): date_version
Champ d'affichage (_rec_name): name
Hérite de (mixins): mail.thread mail.activity.mixin

Champs du modèle

69 champs propres, 24 hérités des mixins et 5 champs automatiques de l'ORM. Cliquez sur un nom pour obtenir le lien direct vers le champ.

Masquer les champs hérités

98 champs affichés sur 98

Nom technique	Libellé	Type	Détails
active	Actif	`boolean`
active_employee	Employé actif	`boolean`	related : `employee_id.active`
additional_note	Note additionnelle	`text`
address_id	Adresse professionnelle	`many2one` → res.partner
allowed_country_state_ids	État/région autorisé(e)	`many2many` → res.country.state	calculé
children	Enfants à charge	`integer`
company_country_id	Pays de la société	`many2one` → res.country	lecture seule related : `company_id.country_id`
company_id	Société	`many2one` → res.company	calculé, stocké
contract_date_end	Date de fin du contrat Date de fin du contrat (s'il s'agit d'un contrat à durée déterminée).	`date`
contract_date_start	Date de début du contrat	`date`
contract_template_id	Modèle de contrat Sélectionnez un modèle de contrat pour préremplir le formulaire avec des valeurs prédéfinies. Vous pouvez toujours modifier les champs après avoir appliqué le modèle.	`many2one` → hr.version
contract_type_id	Type de contrat	`many2one` → hr.contract.type
contract_wage	Salaire contractuel	`monetary`	calculé
country_code	Code du pays	`char`	lecture seule related : `company_country_id.code`
country_id	Nationalité (pays)	`many2one` → res.country
currency_id	Devise	`many2one` → res.currency	lecture seule related : `company_id.currency_id`
date_end	Date de fin	`date`	calculé
date_generated_from	Générée à partir de	`datetime`	requislecture seule ajouté par Prestations (`hr_work_entry`)
date_generated_to	Générée vers	`datetime`	requislecture seule ajouté par Prestations (`hr_work_entry`)
date_start	Date de début	`date`	calculé
date_version	Version datée	`date`	requis
department_id	Département	`many2one` → hr.department
departure_date	Date de départ	`date`
departure_description	Informations supplémentaires	`html`
departure_reason_id	Raison du départ	`many2one` → hr.departure.reason
display_name	Nom d'affichage	`char`	calculé
distance_home_work	Distance Domicile-Lieu de Travail	`integer`
distance_home_work_unit	Unité de distance domicile - lieu de travail	`selection`	requis Valeurs : `kilometers` (km), `miles` (mi)
employee_id	Employé	`many2one` → hr.employee
employee_type	Type d'employé	`selection`	requis Valeurs : `employee` (Employé), `worker` (Ouvrier), `student` (Étudiant), `trainee` (Stagiaire), `contractor` (Contractant), `freelance` (Travailleur indépendant)
hr_responsible_id	Responsable RH Personne responsable de la validation des contrats de l'employé.	`many2one` → res.users	requis
identification_id	N° d'identification Saisissez le numéro d’identification nationale de l’employé délivré par le gouvernement (par exemple : Aadhaar, NAS, NIN). Il est utilisé pour les dossiers officiels et la conformité légale.	`char`
is_current	Est actuel	`boolean`	calculé
is_custom_job_title	Est un intitulé de poste personnalisé	`boolean`	calculé, stocké
is_flexible	Est Flexible	`boolean`	calculé, stocké
is_fully_flexible	Est totalement flexible	`boolean`	calculé, stocké
is_future	Est futur	`boolean`	calculé
is_in_contract	Est sous contrat	`boolean`	calculé
is_past	Est passé	`boolean`	calculé
job_id	Poste	`many2one` → hr.job
job_title	Titre du poste	`char`	calculé, stocké
km_home_work	Distance domicile - lieu de travail en km	`integer`	calculé, stocké
last_generation_date	Date de dernière génération	`date`	lecture seule ajouté par Prestations (`hr_work_entry`)
last_modified_date	Dernière modification le	`datetime`	requis
last_modified_uid	Dernière modification par	`many2one` → res.users	requis
marital	État civil	`selection`	requis Valeurs calculées dynamiquement
member_of_department	Membre du département Si l'employé est membre du département de l'utilisateur actif ou d'un de ses sous-départements.	`boolean`	calculé
name	Nom	`char`
passport_expiration_date	Date d’expiration du passeport	`date`
passport_id	N° de passeport	`char`
private_city	Ville privé	`char`
private_country_id	Pays privé	`many2one` → res.country
private_state_id	Etat privé	`many2one` → res.country.state
private_street	Rue privée	`char`
private_street2	Rue2 privée	`char`
private_zip	Code postal privé	`char`
resource_calendar_id	Heures de travail	`many2one` → resource.calendar
ruleset_id	Ensemble de règles	`many2one` → hr.attendance.overtime.ruleset	ajouté par Présences (`hr_attendance`)
sex	Genre Il s’agit du sexe légal reconnu par l’État.	`selection`	Valeurs : `male` (Masculin), `female` (Féminin), `other` (Autre)
spouse_birthdate	Date de naissance du conjoint	`date`
spouse_complete_name	Nom légal du conjoint	`char`
ssnid	Numéro de sécurité sociale Numéro de sécurité sociale	`char`
structure_type_id	Type de structure salariale	`many2one` → hr.payroll.structure.type	calculé, stocké
trial_date_end	Fin de la période d'essai Date de fin de la période d'essai (le cas échéant).	`date`
tz	Fuseau horaire	`selection`	related : `employee_id.tz`
wage	Salaire Salaire brut mensuel de l'employé.	`monetary`
work_entry_source	Source de la prestation 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`	requis Valeurs : `calendar` (Horaire de travail) ajouté par Prestations (`hr_work_entry`)
work_entry_source_calendar_invalid	Source de la prestation de travail calendrier invalide	`boolean`	calculé ajouté par Prestations (`hr_work_entry`)
work_location_id	Lieu de travail	`many2one` → hr.work.location
activity_calendar_event_id	Activité suivante de l'événement du calendrier	`many2one` → calendar.event	calculé hérité de mail.activity.mixin
activity_date_deadline	Date limite de l'activité à venir	`date`	lecture seulecalculé hérité de mail.activity.mixin
activity_exception_decoration	Indicateur d’exception d’activité Type d'activité d'exception enregistrée.	`selection`	calculé Valeurs : `warning` (Alerte), `danger` (Erreur) hérité de mail.activity.mixin
activity_exception_icon	Icône Icône pour indiquer une activité d'exception.	`char`	calculé hérité de mail.activity.mixin
activity_ids	Activités	`one2many` → mail.activity	inverse : `res_id` hérité de mail.activity.mixin
activity_state	Statut de l'activité Status based on activities Overdue: Due date is already passed Today: Activity date is today Planned: Future activities.	`selection`	calculé Valeurs : `overdue` (En retard), `today` (Aujourd'hui), `planned` (Planifié) hérité de mail.activity.mixin
activity_summary	Résumé de l'activité suivante	`char`	related : `activity_ids.summary` hérité de mail.activity.mixin
activity_type_icon	Icône de type d'activité	`char`	related : `activity_ids.icon` hérité de mail.activity.mixin
activity_type_id	Type d'activités à venir	`many2one` → mail.activity.type	related : `activity_ids.activity_type_id` hérité de mail.activity.mixin
activity_user_id	Utilisateur responsable	`many2one` → res.users	lecture seulecalculé hérité de mail.activity.mixin
has_message	A un message	`boolean`	calculé hérité de mail.thread
message_attachment_count	Nombre de pièces jointes	`integer`	calculé hérité de mail.thread
message_follower_ids	Abonnés	`one2many` → mail.followers	inverse : `res_id` hérité de mail.thread
message_has_error	Erreur d'envoi du message Si coché, certains messages ont une erreur de livraison.	`boolean`	calculé hérité de mail.thread
message_has_error_counter	Nombre d'erreurs Nombre de messages avec des erreurs d'envoi	`integer`	calculé hérité de mail.thread
message_has_sms_error	Erreur d'envoi SMS Si coché, certains messages ont une erreur de livraison.	`boolean`	calculé hérité de mail.thread
message_ids	Messages	`one2many` → mail.message	inverse : `res_id` hérité de mail.thread
message_is_follower	Est un abonné	`boolean`	calculé hérité de mail.thread
message_needaction	Nécessite une action Si coché, de nouveaux messages demandent votre attention.	`boolean`	calculé hérité de mail.thread
message_needaction_counter	Nombre d'actions Nombre de messages nécessitant une action	`integer`	calculé hérité de mail.thread
message_partner_ids	Abonnés (Partenaires)	`many2many` → res.partner	calculé hérité de mail.thread
my_activity_date_deadline	Échéance de mon activité	`date`	lecture seulecalculé hérité de mail.activity.mixin
rating_ids	Évaluations	`one2many` → rating.rating	inverse : `res_id` hérité de mail.thread
website_message_ids	Messages du site web Historique de communication du site web	`one2many` → mail.message	inverse : `res_id` hérité de mail.thread
create_date	Créé le	`datetime`	lecture seuleautomatique
create_uid	Créé par	`many2one` → res.users	lecture seuleautomatique
id	ID	`integer`	lecture seuleautomatique
write_date	Dernière mise à jour le	`datetime`	lecture seuleautomatique
write_uid	Dernière mise à jour par	`many2one` → res.users	lecture seuleautomatique

Relations

Modèles liés depuis ce modèle

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

Champs d'autres modèles qui pointent ici

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

Lire ce modèle par l'API

Exemple d'appel à l'API JSON-2 d'Odoo 19 : lecture des cinq premiers enregistrements avec des champs réels du modèle. Remplacez l'instance, la base et la clé API par les vôtres.

curl

curl -X POST "https://votre-instance.odoo.com/json/2/hr.version/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: votre-base" \
  -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://votre-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "votre-base"}

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())

L'accès à l'API externe est réservé à la formule Custom d'Odoo.
XML-RPC et JSON-RPC seront retirés dans Odoo 22 (automne 2028) : préférez JSON-2.
Les droits d'accès et règles d'enregistrement de l'utilisateur de la clé s'appliquent.

Citer cet outil

Vous rédigez un tutoriel, une documentation interne ou une réponse sur un forum ? Copiez ce lien pour renvoyer vos lecteurs vers la fiche à jour.

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

Sources

Données vérifiées le 23 septembre 2026 · Odoo 19.0 Community

Vous avez un projet Odoo ou souhaitez exploiter votre ERP avec l'IA ? Échangeons

Intégration, développement de modules, connexion de Claude ou ChatGPT à vos données : décrivez-nous votre contexte, nous vous répondons sous 24 heures ouvrées.

Nous contacter Voir une démo