Odoo 19.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 5 módulos más. Expone 98 campos, 69 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 19.

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_attendance, hr_holidays, hr_work_entry, hr_work_entry_holidays, l10n_fr_hr_work_entry_holidays
Orden por defecto (_order): date_version
Campo mostrado (_rec_name): name
Hereda de (mixins): mail.thread mail.activity.mixin

Campos del modelo

69 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

98 de 98 campos mostrados

Nombre técnico	Etiqueta	Tipo	Detalles
active	Activo	`boolean`
active_employee	Empleado activo	`boolean`	related: `employee_id.active`
additional_note	Nota adicional	`text`
address_id	Dirección de trabajo	`many2one` → res.partner
allowed_country_state_ids	Estado o país permitido	`many2many` → res.country.state	calculado
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
contract_type_id	Tipo de contrato	`many2one` → hr.contract.type
contract_wage	Salario del contrato	`monetary`	calculado
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_generated_from	Generado desde	`datetime`	obligatoriosolo lectura añadido por Entradas de trabajo (`hr_work_entry`)
date_generated_to	Generado hasta	`datetime`	obligatoriosolo lectura añadido por Entradas de trabajo (`hr_work_entry`)
date_start	Fecha de inicio	`date`	calculado
date_version	Versión de la fecha	`date`	obligatorio
department_id	Departamento	`many2one` → hr.department
departure_date	Fecha de salida	`date`
departure_description	Información adicional	`html`
departure_reason_id	Motivo de salida	`many2one` → hr.departure.reason
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	Tipo de empleado	`selection`	obligatorio Valores: `employee` (Empleado), `worker` (Trabajador), `student` (Estudiante), `trainee` (Aprendiz), `contractor` (Contratista), `freelance` (Autónomo)
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_flexible	Es flexible	`boolean`	calculado, almacenado
is_fully_flexible	Es completamente flexible	`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_generation_date	Fecha de la última generación	`date`	solo lectura añadido por Entradas de trabajo (`hr_work_entry`)
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_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
ruleset_id	Conjunto de reglas	`many2one` → hr.attendance.overtime.ruleset	añadido por Asistencias (`hr_attendance`)
sex	Género Este es el sexo legal reconocido por el estado.	`selection`	Valores: `male` (Masculino), `female` (Femenino), `other` (Otro)
spouse_birthdate	Fecha de nacimiento del cónyuge	`date`
spouse_complete_name	Nombre legal del cónyuge	`char`
ssnid	Número de seguridad social Número de seguridad social	`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`	related: `employee_id.tz`
wage	Salario Salario bruto mensual por empleado.	`monetary`
work_entry_source	Origen de entrada de trabajo 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`	obligatorio Valores: `calendar` (Horario de trabajo) añadido por Entradas de trabajo (`hr_work_entry`)
work_entry_source_calendar_invalid	El origen de la entrada de trabajo del calendario no es válido	`boolean`	calculado añadido por Entradas de trabajo (`hr_work_entry`)
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_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
website_message_ids	Mensajes del sitio web Historial de comunicación del sitio web	`one2many` → mail.message	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.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

Campos de otros modelos que apuntan aquí

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

Leer este modelo por la API

Ejemplo de llamada a la API JSON-2 de Odoo 19: 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_generated_from","date_generated_to","date_version","distance_home_work_unit"],"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_generated_from","date_generated_to","date_version","distance_home_work_unit"], "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 19.0)</a>

Fuentes

Datos verificados el 23 de septiembre de 2026 · Odoo 19.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