Odoo 20.0 Community · Persistente

hr.employee: campos, relaciones y API

El modelo hr.employee («Empleado») es un modelo persistente declarado por el módulo Empleados y ampliado por 18 módulos más. Expone 226 campos, 205 de ellos declarados directamente en el modelo; 76 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.

Ficha de identidad

Nombre técnico
hr.employee
Etiqueta
Empleado
Tipo
Persistente (models.Model)
Tabla SQL
hr_employee
Módulo de origen
Empleados (hr)
Ampliado por
hr_address_extended, hr_work_entry, hr_attendance, hr_calendar, hr_expense, hr_fleet, hr_gamification, hr_holidays, hr_holidays_attendance, hr_maintenance, hr_presence, hr_recruitment, hr_skills, hr_skills_slides, hr_timesheet, pos_hr, project_timesheet_holidays, sale_timesheet
Orden por defecto (_order)
name, id
Hereda de (mixins)
mail.thread.main.attachmentmail.thread.phonemail.activity.mixinresource.mixinavatar.mixinpos.load.mixin
Delegación (_inherits)
hr.version: los campos de este modelo también están disponibles, mediante version_id

Campos del modelo

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

226 de 226 campos mostrados

Nombre técnicoEtiquetaTipoDetalles
activeActivoboolean

related: resource_id.active

activity_date_deadlineActivity Date Deadlinedate
activity_exception_decorationDecoración de Actividad de Excepciónselection

Valores calculados dinámicamente

activity_exception_iconActivity Exception Iconchar
activity_idsActividadone2many
activity_plans_idsPlanes de actividadesmany2many
activity_stateEstado de la actividadselection

Valores calculados dinámicamente

activity_summaryActivity Summarychar
activity_type_iconIcono de tipo de actividadchar
activity_type_idTipo de actividadmany2one
activity_user_idActivity Usermany2one
additional_noteNota adicionaltext
ageEdadinteger
calculado
allocation_countNúmero total de días asignados.float
calculado

añadido por Ausencias (hr_holidays)

allocation_displayVisualización de asignacioneschar
calculado

añadido por Ausencias (hr_holidays)

allocation_remaining_displayMostrar asignación restantechar
calculado

añadido por Ausencias (hr_holidays)

allocations_countNúmero total de asignacionesinteger
calculado

añadido por Ausencias (hr_holidays)

applicant_idsCandidatosone2many

inverso: employee_id

añadido por Reclutamiento (hr_recruitment)

applicant_nameApplicant Namechar
calculado

añadido por Reclutamiento (hr_recruitment)

attendance_basedAttendance Basedboolean

related: version_id.attendance_based

añadido por Asistencias (hr_attendance)

attendance_idsAsistenciaone2many

inverso: employee_id

añadido por Asistencias (hr_attendance)

attendance_manager_idAprobador de asistencias

El usuario configurado en Asistencias podrá acceder a las asistencias de los empleados a través de la aplicación dedicada y podrá editarlos.

many2one
calculado, almacenado

añadido por Asistencias (hr_attendance)

attendance_stateEstado de asistenciaselection
calculado

Valores: checked_out (Salida registrada), checked_in (Entrada registrada)

añadido por Asistencias (hr_attendance)

badge_idsInsignias del empleado

Todas las insignias del empleado, vinculadas a él ya sea directamente o a través del usuario

one2many
calculado

añadido por HR Gamification (hr_gamification)

bank_account_idsCuentas bancarias

Cuentas bancarias de los empleados para pagar los salarios

many2many
barcodeID de credencial

ID usado para identificación del empleado.

char
birthdayCumpleañosdate
birthday_monthMes de cumpleañosselection
calculado, almacenado

Valores: 0 (Sin especificar), 1 (Enero), 2 (Febrero), 3 (Marzo), 4 (Abril), 5 (Mayo), 6 (Junio), 7 (Julio), 8 (Agosto), 9 (Septiembre), 10 (Octubre), 11 (Noviembre)…

birthday_public_displayShow Birthday To Employeesboolean
birthday_public_display_stringFecha de nacimiento públicachar
calculado
car_idsVehículos (privado)one2many

inverso: driver_employee_id

añadido por Fleet History (hr_fleet)

category_idsEtiquetasmany2many
certificateNivel de certificadoselection

Valores calculados dinámicamente

certification_idsCertificaciónone2many
calculado

añadido por Gestión de habilidades (hr_skills)

child_all_countNúmero de subordinados indirectosinteger
calculado
child_countDirect Subordinates Countinteger
calculado
child_idsSubordinados directosone2many

inverso: parent_id

coach_idMentor

Select the "Employee" who is the coach of this employee. The "Coach" has no specific rights or responsibilities by default.

many2one
calculado, almacenado
colorÍndice de Coloresinteger
company_country_codeCódigo de país de la empresachar
solo lectura

related: company_country_id.code

company_country_idPaís de la compañíamany2one
solo lectura

related: company_id.country_id

company_idCompañíamany2one
obligatorio
contract_date_endContract Date Enddate

related: version_id.contract_date_end

contract_date_startContract Date Startdate

related: version_id.contract_date_start

contract_template_idPlantilla de contratomany2one
country_of_birthPaís de nacimientomany2one
courses_completion_textTexto de finalización de cursoschar
calculado

añadido por Skills e-learning (hr_skills_slides)

currency_idMonedamany2one
solo lectura

related: company_id.currency_id

current_date_versionCurrent Date Employee Recorddate

related: current_version_id.date_version

current_employee_skill_idsHabilidad del empleado actualone2many
calculado

añadido por Gestión de habilidades (hr_skills)

current_leave_stateEstado de ausencias actualselection
calculado

Valores: confirm (En espera de aprobación), refuse (Rechazado), validate1 (En espera de segunda aprobación), validate (Aprobado), cancel (Cancelado)

añadido por Ausencias (hr_holidays)

current_version_idCurrent Employee Recordmany2one
calculado, almacenado
current_work_entry_type_idCurrent Time Typemany2one
calculado

añadido por Ausencias (hr_holidays)

date_endFecha de finalizacióndate

related: version_id.date_end

date_startFecha de iniciodate

related: version_id.date_start

department_colorDepartment Colorinteger

related: department_id.color

departure_action_dateDeparture Action Datedate

related: version_id.departure_action_date

departure_apply_dateDeparture Apply Datedate

related: version_id.departure_apply_date

departure_apply_immediatelyDeparture Apply Immediatelyboolean

related: version_id.departure_apply_immediately

departure_dateFecha de salidadate

related: version_id.departure_date

departure_descriptionDeparture Descriptionhtml

related: version_id.departure_description

departure_idSalidamany2one

related: version_id.departure_id

departure_reason_idMotivo de salidamany2one

related: version_id.departure_reason_id

direct_badge_idsInsignia directa

Insignias directamente relacionadas con el empleado

one2many

inverso: employee_id

añadido por HR Gamification (hr_gamification)

dismissal_dateDismissal Datedate

related: version_id.dismissal_date

display_attendancesDisplay Attendancesboolean
calculado

añadido por Asistencias (hr_attendance)

display_certification_pageMostrar página de certificaciónboolean
calculado

añadido por Gestión de habilidades (hr_skills)

driving_licensePermiso de conducirbinary
driving_license_nameDriving License Namechar
emailCorreo electrónicochar

related: user_id.email

email_sentCorreo electrónico enviadoboolean

añadido por Employee Presence Control (hr_presence)

emergency_contactContacto de emergenciachar
emergency_phoneTeléfono de emergenciachar
emergency_phone_formattedEmergency Phone Formattedchar
calculado
emergency_phone_sanitizedEmergency Phone Sanitizedchar
calculado
employee_cars_countCochesinteger
calculado

añadido por Fleet History (hr_fleet)

employee_propertiesPropiedadesproperties
employee_skill_idsHabilidadesone2many

inverso: employee_id

añadido por Gestión de habilidades (hr_skills)

employee_type_idTipo de empleadomany2one

related: version_id.employee_type_id

equipment_countNúmero de equiposinteger
calculado

añadido por Maintenance - HR (hr_maintenance)

equipment_idsEquipoone2many

inverso: employee_id

añadido por Maintenance - HR (hr_maintenance)

exceptional_location_idActual

This is the exceptional, non-weekly, location set for today.

many2one
calculado
expense_manager_idAprobador de gastos

Select the user responsible for approving "Expenses" of this employee. If empty, the approval is done by an Administrator or Approver (determined in settings/users).

many2one
calculado, almacenado

añadido por Gastos (hr_expense)

external_codeCódigo externo

Utilice este código para exportar sus datos a terceros.

char

añadido por Work Entries (hr_work_entry)

filter_for_expenseFiltro para gastoboolean

añadido por Gastos (hr_expense)

first_contract_dateFecha del primer contrato

The date of the first contract of the employee in the company.

date
calculado, almacenado
fixed_termFixed Termboolean

related: version_id.fixed_term

friday_location_idViernesmany2one
goal_idsMetas de RR. HH. del empleadoone2many
calculado

añadido por HR Gamification (hr_gamification)

has_badgesTiene insigniasboolean
calculado

añadido por HR Gamification (hr_gamification)

has_messageTiene un mensajeboolean
has_multiple_bank_accountsTiene varias cuentas bancariasboolean
calculado
has_subscribed_coursesTiene suscripción a cursosboolean
calculado

añadido por Skills e-learning (hr_skills_slides)

has_timesheetTiene partes de horasboolean
calculado

añadido por Registros de tareas (hr_timesheet)

has_work_permitPermiso de trabajobinary
hourly_costCoste por horamonetary
hours_last_monthHoras del mes pasadofloat
calculado

añadido por Asistencias (hr_attendance)

hours_last_month_displayVisualización de horas del mes pasadochar
calculado

añadido por Asistencias (hr_attendance)

hours_last_month_overtimeNúmero de horas extra del mes pasadofloat
calculado

añadido por Asistencias (hr_attendance)

hours_previously_todayHoras previas de hoyfloat
calculado

añadido por Asistencias (hr_attendance)

hours_todayHoras de hoyfloat
calculado

añadido por Asistencias (hr_attendance)

hr_icon_displayVisualización del icono RR. HH.selection
calculado

Valores: presence_present (Presente), presence_out_of_working_hour (Fuera del horario laboral), presence_absent (Ausente), presence_home (En casa), presence_office (At Office), presence_other (At Other), presence_undetermined (Indeterminado)

hr_presence_stateEstado de presencia de RR. HH.selection
calculado

Valores: present (Presente), absent (Ausente), out_of_working_hour (Fuera del horario laboral)

hr_responsible_idHr Responsiblemany2one

related: version_id.hr_responsible_id

id_cardCopia de la tarjeta de identificaciónbinary
id_card_nameId Card Namechar
ip_connectedIp conectadoboolean

añadido por Employee Presence Control (hr_presence)

is_absentAusente hoyboolean
calculado

añadido por Ausencias (hr_holidays)

is_currentEs actualboolean

related: version_id.is_current

is_futureEstá en el futuroboolean

related: version_id.is_future

is_in_contractEstá bajo contratoboolean

related: version_id.is_in_contract

is_pastEstá en el pasadoboolean

related: version_id.is_past

is_subordinateEs subordinadoboolean
calculado
is_trusted_bank_accountEs una cuenta bancaria fiableboolean
calculado
langIdiomaselection

Valores calculados dinámicamente

last_activityÚltima actividaddate
calculado
last_activity_timeÚltimo tiempo de actividadchar
calculado
last_attendance_idÚltima asistenciamany2one
calculado, almacenado

añadido por Asistencias (hr_attendance)

last_attendance_worked_hoursHoras trabajadas en la última asistenciafloat
calculado

añadido por Asistencias (hr_attendance)

last_check_inLast Check Indatetime

related: last_attendance_id.check_in

añadido por Asistencias (hr_attendance)

last_check_outLast Check Outdatetime

related: last_attendance_id.check_out

añadido por Asistencias (hr_attendance)

leave_date_fromDesde la fechadate
calculado

añadido por Ausencias (hr_holidays)

leave_date_toHasta la fechadate
calculado

añadido por Ausencias (hr_holidays)

leave_idsAbandonarone2many

inverso: employee_id

añadido por Ausencias (hr_holidays)

leave_manager_idAprobador de ausencias

Select the user responsible for approving "Time Off" of this employee. If empty, the approval is done by an Administrator or Approver (determined in settings/users).

many2one
calculado, almacenado

añadido por Ausencias (hr_holidays)

license_plateMatrículachar
calculado

añadido por Fleet History (hr_fleet)

manually_set_presenceEstablecer asistencia manualmenteboolean

añadido por Employee Presence Control (hr_presence)

manually_set_presentEstablecer manualmente la presenciaboolean

añadido por Employee Presence Control (hr_presence)

member_of_departmentMember of Departmentboolean
calculado

añadido por Ausencias (hr_holidays)

message_attachment_countMessage Attachment Countinteger
message_follower_idsMessage Followerone2many
message_has_errorMessage Has Errorboolean
message_has_error_counterMessage Has Error Counterinteger
message_idsMensajeone2many
message_is_followerMessage Is Followerboolean
message_main_attachment_idMessage Main Attachmentmany2one
message_needactionMessage Needactionboolean
message_needaction_counterMessage Needaction Counterinteger
message_partner_idsContacto del mensajemany2many
mobile_phoneMóvil de trabajochar
mobile_phone_formattedMobile Phone Formattedchar
calculado
mobile_phone_sanitizedMobile Phone Sanitizedchar
calculado
monday_location_idLunesmany2one
my_activity_date_deadlineMy Activity Date Deadlinedate
nameNombre del empleadochar

related: resource_id.name

nationality_country_codeNacionalidadchar

related: version_id.country_id.code

newly_hiredRecién contratadoboolean
calculado
parent_company_idCompañía padremany2one
solo lectura

related: company_id.parent_id

parent_idGerentemany2one
permit_noNúmero de permiso de trabajochar
phoneTeléfonochar

related: user_id.phone

phone_blacklistedTeléfono en la lista negraboolean
phone_sanitized_blacklistedPhone Sanitized Blacklistedboolean
pinPIN

PIN que se utiliza para el registro de entrada/salida en el modo quiosco de la aplicación Asistencias (si se habilita en Configuración) y para cambiar el cajero en la aplicación Punto de venta.

char
place_of_birthLugar de nacimientochar
primary_bank_account_idCuenta bancaria principalmany2one
calculado
private_emailCorreo electrónico privadochar
private_phoneTeléfono privadochar
private_phone_formattedPrivate Phone Formattedchar
calculado
private_phone_sanitizedPrivate Phone Sanitizedchar
calculado
resource_calendar_idCalendario de recursosmany2one

related: version_id.resource_calendar_id

resource_idRecursomany2one
obligatorio
resume_line_idsLíneas del currículumone2many

inverso: employee_id

añadido por Gestión de habilidades (hr_skills)

salary_distributionDistribución salarialjson
calculado, almacenado
saturday_location_idSábadomany2one
shareCompartirboolean

related: user_id.share

show_hr_icon_displayMostrar icono de RR. HH.boolean
calculado
show_leavesPuede ver el tiempo de ausencia restanteboolean
calculado

añadido por Ausencias (hr_holidays)

skill_idsHabilidadmany2many
calculado, almacenado

añadido por Gestión de habilidades (hr_skills)

structure_type_idStructure Typemany2one

related: version_id.structure_type_id

study_fieldCampo de estudiochar
subordinate_idsSubordinados

Direct and indirect subordinates

one2many
calculado
subscribed_coursesSubscribed Coursesmany2many

related: user_partner_id.slide_channel_ids

añadido por Skills e-learning (hr_skills_slides)

sunday_location_idDomingomany2one
thursday_location_idJuevesmany2one
today_attendance_idsToday Attendancemany2many
calculado

añadido por Asistencias (hr_attendance)

today_location_nameToday Location Namechar
total_overtimeTotal de horas extraordinariasfloat
calculado

añadido por Asistencias (hr_attendance)

trial_date_endTrial Date Enddate

related: version_id.trial_date_end

tuesday_location_idMartesmany2one
tzZona horariaselection

related: version_id.tz

user_idUsuariomany2one

related: resource_id.user_id

user_partner_idContacto del usuariomany2one

related: user_id.partner_id

user_stateUser Statusselection

related: user_id.state

version_idRegistro del empleadomany2one
obligatoriocalculado
version_idsRegistros de empleadosone2many
obligatorio

inverso: employee_id

version_revisionVersion Revisionchar
calculado
versions_countEmployee Records Countinteger
calculado
visa_expireFecha de expiración del visadodate
visa_noNúmero del visadochar
wednesday_location_idMiércolesmany2one
work_contact_idContacto de trabajomany2one
work_emailCorreo electrónico de trabajochar
calculado, almacenado
work_location_nameNombre de la ubicación de trabajochar
calculado
work_location_typeTipo de la ubicación de trabajoselection
calculado

Valores: home (Inicio), office (Oficina), other (Otro)

work_permit_expiration_dateFecha de vencimiento del permiso de trabajodate
work_permit_namework_permit_namechar
calculado
work_permit_scheduled_activityActividad programada del permiso de trabajoboolean
work_phoneTeléfono del trabajochar
calculado, almacenado
work_phone_formattedWork Phone Formattedchar
calculado
work_phone_sanitizedWork Phone Sanitizedchar
calculado
activity_calendar_event_idSiguiente evento en el calendario de actividades.many2one
calculado

heredado de mail.activity.mixin

avatar_1024Avatar 1024image
calculado

heredado de avatar.mixin

avatar_128Avatar 128image
calculado

heredado de avatar.mixin

avatar_1920Avatarimage
calculado

heredado de avatar.mixin

avatar_256Avatar 256image
calculado

heredado de avatar.mixin

avatar_512Avatar 512image
calculado

heredado de avatar.mixin

image_1024Imagen 1024image

related: image_1920

heredado de image.mixin

image_128Imagen 128image

related: image_1920

heredado de image.mixin

image_1920Imagenimage

heredado de image.mixin

image_256Imagen 256image

related: image_1920

heredado de image.mixin

image_512Imagen 512image

related: image_1920

heredado de image.mixin

message_has_sms_errorError de envío del SMS

Si está marcada, algunos mensajes tienen error de envío.

boolean
calculado

heredado de mail.thread

phone_formattedFormatted Numberchar
calculado

heredado de mail.thread.phone

phone_sanitizedNúmero depurado

Campo utilizado para almacenar el número de teléfono depurado. Ayuda a acelerar las búsquedas y las comparaciones.

char
calculado, almacenado

heredado de mail.thread.phone

rating_idsCalificacionesone2many

inverso: res_id

heredado de mail.thread

create_dateCreado eldatetime
solo lecturaautomático
create_uidCreado pormany2one
solo lecturaautomático
display_nameNombre mostradochar
solo lecturacalculadoautomático
idIDinteger
solo lecturaautomático
write_dateÚltima actualización eldatetime
solo lecturaautomático
write_uidÚltima actualización pormany2one
solo lecturaautomático

Relaciones

Modelos enlazados desde este modelo

Campos de otros modelos que apuntan aquí

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.employee/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: su-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","company_id","resource_id","activity_type_id","activity_user_id"],"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.employee/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","company_id","resource_id","activity_type_id","activity_user_id"], "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-employee">hr.employee (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.