Odoo 20.0 Community · Persistente

hr.version: campos, relaciones y API

El modelo hr.version («Contrato del empleado») es un modelo persistente declarado por el módulo Empleados y ampliado por 6 módulos más. Expone 96 campos, 67 de ellos declarados directamente en el modelo; 5 campos de otros modelos apuntan a él. A continuación encontrará cada campo con su nombre técnico, tipo, etiqueta en español y relaciones, y un ejemplo de llamada a la API JSON-2 de Odoo 20.

Ver el código fuente Buscar otro modelo

Ficha de identidad

Nombre técnico: hr.version
Etiqueta: Contrato del empleado
Tipo: Persistente (models.Model)
Tabla SQL: hr_version
Módulo de origen: Empleados (hr)
Ampliado por: hr_address_extended, hr_work_entry, hr_attendance, hr_holidays, hr_holidays_attendance, l10n_fr_hr_holidays
Orden por defecto (_order): date_version
Campo mostrado (_rec_name): name
Hereda de (mixins): mail.thread mail.activity.mixin

Campos del modelo

67 campos propios, 24 heredados de mixins y 5 campos automáticos del ORM. Haga clic en un nombre para obtener el enlace directo al campo.

Ocultar los campos heredados

96 de 96 campos mostrados

Nombre técnico	Etiqueta	Tipo	Detalles
active	Activo	`boolean`
active_employee	Empleado activo	`boolean`	related: `employee_id.active`
address_id	Dirección de trabajo	`many2one` → res.partner
allocation_from_working_schedule_id	Allocation from working schedule	`many2one` → hr.leave.allocation	añadido por Ausencias (`hr_holidays`)
allowed_country_state_ids	Estado o país permitido	`many2many` → res.country.state	calculado
attendance_based	Attendance Based When enabled, payslips are computed from badge records rather than the employee's work schedule. Time off is always accounted for.	`boolean`	añadido por Asistencias (`hr_attendance`)
children	Hijos dependientes	`integer`
company_country_id	País de la compañía	`many2one` → res.country	solo lectura related: `company_id.country_id`
company_id	Compañía	`many2one` → res.company	calculado, almacenado
contract_date_end	Fecha de finalización del contrato Fecha de finalización del contrato (si es un contrato por tiempo determinado).	`date`
contract_date_start	Fecha de inicio del contrato	`date`
contract_template_id	Plantilla de contrato Seleccione una plantilla de contrato para rellenar automáticamente el formulario de contrato con los valores predefinidos. Después de aplicar la plantilla puede seguir editando los campos según sea necesario.	`many2one` → hr.version
country_code	Código de país	`char`	solo lectura related: `company_country_id.code`
country_id	Nacionalidad (País)	`many2one` → res.country
currency_id	Moneda	`many2one` → res.currency	solo lectura related: `company_id.currency_id`
date_end	Fecha de finalización	`date`	calculado
date_start	Fecha de inicio	`date`	calculado
date_version	Fecha efectiva	`date`	obligatorio
department_id	Departamento	`many2one` → hr.department
departure_action_date	Departure Action Date	`date`	related: `departure_id.action_date`
departure_apply_date	Departure Apply Date	`date`	related: `departure_id.apply_date`
departure_apply_immediately	Departure Apply Immediately	`boolean`	related: `departure_id.apply_immediately`
departure_date	Fecha de salida	`date`	related: `departure_id.departure_date`
departure_description	Departure Description	`html`	related: `departure_id.departure_description`
departure_id	Salida	`many2one` → hr.employee.departure
departure_reason_id	Motivo de salida	`many2one` → hr.departure.reason	related: `departure_id.departure_reason_id`
dismissal_date	Dismissal Date	`date`	related: `departure_id.dismissal_date`
display_name	Nombre para mostrar	`char`	calculado
distance_home_work	Distancia de la casa al trabajo	`integer`
distance_home_work_unit	Unidad de la distancia de la casa al trabajo	`selection`	obligatorio Valores: `kilometers` (km), `miles` (mi)
employee_id	Empleado	`many2one` → hr.employee
employee_type_id	Tipo de empleado	`many2one` → hr.employee.type
fixed_term	Fixed Term	`boolean`
hr_responsible_id	Responsable de RRHH Persona responsable de validar los contratos del empleado.	`many2one` → res.users	obligatorio
identification_id	Nº de identificación Introduce el número de identificación nacional del empleado emitido por el gobierno (por ejemplo, Aadhaar, SIN, NIN). Se utiliza para registros oficiales y cumplimiento legal.	`char`
is_current	Es actual	`boolean`	calculado
is_custom_job_title	Es un título de trabajo personalizado	`boolean`	calculado, almacenado
is_future	Está en el futuro	`boolean`	calculado
is_in_contract	Está bajo contrato	`boolean`	calculado
is_past	Está en el pasado	`boolean`	calculado
job_id	Empleo	`many2one` → hr.job
job_title	Nombre del puesto	`char`	calculado, almacenado
km_home_work	Distancia de la casa al trabajo en km	`integer`	calculado, almacenado
last_modified_date	Última modificación en	`datetime`	obligatorio
last_modified_uid	Última modificación por	`many2one` → res.users	obligatorio
marital	Estado civil	`selection`	obligatorio Valores calculados dinámicamente
member_of_department	Miembro del departamento Si el empleado es un miembro del departamento del usuario activo o de uno de sus departamentos hijos.	`boolean`	calculado
name	Nombre	`char`
passport_expiration_date	Fecha de caducidad del pasaporte	`date`
passport_id	Número de pasaporte	`char`
private_city	Ciudad privada	`char`
private_city_id	Private City ID	`many2one` → res.city	calculado, almacenado añadido por HR Address Extended (`hr_address_extended`)
private_country_enforce_cities	Private Country Enforce Cities	`boolean`	solo lectura related: `private_country_id.enforce_cities` añadido por HR Address Extended (`hr_address_extended`)
private_country_id	País privado	`many2one` → res.country
private_state_id	Provincia privada	`many2one` → res.country.state
private_street	Calle privada	`char`
private_street2	Calle2 privada	`char`
private_zip	Código Postal privado	`char`
resource_calendar_id	Horas laborables	`many2one` → resource.calendar	obligatorio
sex	Sex This is the legal sex as recognized by the state, used for official and statutory purposes.	`selection`	Valores: `male` (Masculino), `female` (Femenino)
spouse_birthdate	Fecha de nacimiento del cónyuge	`date`
spouse_complete_name	Nombre legal del cónyuge	`char`
structure_type_id	Tipo de estructura salarial	`many2one` → hr.payroll.structure.type	calculado, almacenado
trial_date_end	Fin del periodo de prueba Fecha de finalización del periodo de prueba (si existe).	`date`
tz	Zona horaria	`selection`	obligatorio Valores calculados dinámicamente
wage	Salario Salario bruto mensual por empleado.	`monetary`
work_location_id	Ubicación de trabajo	`many2one` → hr.work.location
activity_calendar_event_id	Siguiente evento en el calendario de actividades.	`many2one` → calendar.event	calculado heredado de mail.activity.mixin
activity_date_deadline	Fecha límite de la siguiente actividad	`date`	solo lecturacalculado heredado de mail.activity.mixin
activity_exception_decoration	Decoración de Actividad de Excepción Tipo de actividad de excepción en el registro.	`selection`	calculado Valores: `warning` (Alerta), `danger` (Error) heredado de mail.activity.mixin
activity_exception_icon	Icono Icono para indicar una actividad de excepción.	`char`	calculado heredado de mail.activity.mixin
activity_ids	Actividades	`one2many` → mail.activity	inverso: `res_id` heredado de mail.activity.mixin
activity_plans_ids	Planes de actividades	`many2many` → mail.activity.plan	calculado heredado de mail.activity.mixin
activity_state	Estado de la actividad Status based on activities Overdue: Due date is already passed Today: Activity date is today Planned: Future activities.	`selection`	calculado Valores: `overdue` (De retraso), `today` (Hoy), `planned` (Planificado) heredado de mail.activity.mixin
activity_summary	Resumen de la siguiente actividad	`char`	related: `activity_ids.summary` heredado de mail.activity.mixin
activity_type_icon	Icono de tipo de actividad	`char`	related: `activity_ids.icon` heredado de mail.activity.mixin
activity_type_id	Tipo de la siguiente actividad	`many2one` → mail.activity.type	related: `activity_ids.activity_type_id` heredado de mail.activity.mixin
activity_user_id	Usuario responsable	`many2one` → res.users	solo lecturacalculado heredado de mail.activity.mixin
has_message	Tiene un mensaje	`boolean`	calculado heredado de mail.thread
message_attachment_count	Número de archivos adjuntos	`integer`	calculado heredado de mail.thread
message_follower_ids	Seguidores	`one2many` → mail.followers	inverso: `res_id` heredado de mail.thread
message_has_error	Error de envío de mensaje Si está marcada, algunos mensajes tienen error de envío.	`boolean`	calculado heredado de mail.thread
message_has_error_counter	Número de errores Número de mensajes con error de envío	`integer`	calculado heredado de mail.thread
message_has_sms_error	Error de envío del SMS Si está marcada, algunos mensajes tienen error de envío.	`boolean`	calculado heredado de mail.thread
message_ids	Mensajes	`one2many` → mail.message	inverso: `res_id` heredado de mail.thread
message_is_follower	Es un seguidor	`boolean`	calculado heredado de mail.thread
message_needaction	Acción requerida Si está marcada, hay nuevos mensajes que requieren su atención.	`boolean`	calculado heredado de mail.thread
message_needaction_counter	Número de acciones Número de mensajes que requieren una acción	`integer`	calculado heredado de mail.thread
message_partner_ids	Seguidores (Contactos)	`many2many` → res.partner	calculado heredado de mail.thread
my_activity_date_deadline	Fecha límite de mi actividad	`date`	solo lecturacalculado heredado de mail.activity.mixin
rating_ids	Calificaciones	`one2many` → rating.rating	inverso: `res_id` heredado de mail.thread
create_date	Creado el	`datetime`	solo lecturaautomático
create_uid	Creado por	`many2one` → res.users	solo lecturaautomático
id	ID	`integer`	solo lecturaautomático
write_date	Última actualización el	`datetime`	solo lecturaautomático
write_uid	Última actualización por	`many2one` → res.users	solo lecturaautomático

Relaciones

Modelos enlazados desde este modelo

hr.department: department_id
hr.departure.reason: departure_reason_id
hr.employee: employee_id
hr.employee.departure: departure_id
hr.employee.type: employee_type_id
hr.job: job_id
hr.leave.allocation: allocation_from_working_schedule_id
hr.payroll.structure.type: structure_type_id
hr.version: contract_template_id
hr.work.location: work_location_id
res.city: private_city_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

Campos de otros modelos que apuntan aquí

hr.employee: contract_template_id, current_version_id, version_id
hr.export.work.entries.employee: version_ids
hr.version: contract_template_id

Leer este modelo por la API

Ejemplo de llamada a la API JSON-2 de Odoo 20: lectura de los cinco primeros registros con campos reales del modelo. Sustituya la instancia, la base y la clave API por las suyas.

curl

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

Python (requests)

import requests

BASE_URL = "https://su-instancia.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "su-base"}

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

El acceso a la API externa está reservado al plan Custom de Odoo.
XML-RPC y JSON-RPC se retirarán en Odoo 22 (otoño de 2028): use JSON-2.
Se aplican los permisos de acceso y las reglas de registro del usuario de la clave.

Citar esta herramienta

¿Escribe un tutorial, una documentación interna o una respuesta en un foro? Copie este enlace para dirigir a sus lectores a la ficha actualizada.

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

Fuentes

Datos verificados el 25 de septiembre de 2026 · Odoo 20.0 Community

¿Tiene un proyecto Odoo o quiere aprovechar su ERP con la IA? Hablemos

Implantación, desarrollo de módulos, conexión de Claude o ChatGPT a sus datos: cuéntenos su contexto y le responderemos en 24 horas laborables.

Contactarnos Ver una demo