Odoo 19.0 Community · Persistente

res.users: campos, relaciones y API

El modelo res.users («Usuario») es un modelo persistente declarado por el módulo Base y ampliado por 52 módulos más. Expone 145 campos, 140 de ellos declarados directamente en el modelo; 195 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.

Ficha de identidad

Nombre técnico
res.users
Etiqueta
Usuario
Tipo
Persistente (models.Model)
Tabla SQL
res_users
Módulo de origen
Base (base)
Ampliado por
web, base_setup, bus, web_tour, mail, auth_signup, resource, digest, auth_ldap, auth_oauth, auth_passkey, auth_password_policy, auth_totp, auth_totp_mail, auth_timeout, auth_totp_portal, contacts, phone_validation, base_import, calendar, sales_team, crm, im_livechat, crm_livechat, stock, sale_stock, gamification, google_calendar, google_gmail, hr, hr_attendance, hr_gamification, hr_holidays, hr_homeworking, hr_recruitment, website, website_profile, website_slides, project, point_of_sale, lunch, mail_bot, mass_mailing, mass_mailing_sms, microsoft_account, microsoft_calendar, microsoft_outlook, project_hr_skills, project_todo, web_unsplash, website_forum, website_sale_wishlist
Orden por defecto (_order)
name, login
Hereda de (mixins)
bus.listener.mixinpos.load.mixin
Delegación (_inherits)
res.partner: los campos de este modelo también están disponibles, mediante partner_id

Campos del modelo

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

145 de 145 campos mostrados

Nombre técnicoEtiquetaTipoDetalles
accesses_count# Permisos de acceso

Número de permisos de acceso que se aplican al usuario actual

integer
calculado
action_idAcción inicial

Si se especifica, esta acción será ejecutada cuando este usuario entre en el sistema, en adición al menú estándar.

many2one
activeActivoboolean
active_partnerEl contacto está activoboolean
solo lectura

related: partner_id.active

additional_noteNota adicionaltext

related: employee_id.additional_note

añadido por Empleados (hr)

all_group_idsGrupos y grupos implicadosmany2many
calculado
api_key_idsClaves APIone2many

inverso: user_id

auth_passkey_key_idsClave de acceso de autenticaciónone2many

inverso: create_uid

añadido por Claves de acceso (auth_passkey)

badge_idsInsigniasone2many

inverso: user_id

añadido por Ludificación (gamification)

bank_account_idsCuenta bancariamany2many

related: employee_id.bank_account_ids

añadido por Empleados (hr)

barcodeCódigo de barraschar

related: employee_id.barcode

añadido por Empleados (hr)

bronze_badgeNúmero de insignias de bronceinteger
calculado

añadido por Ludificación (gamification)

calendar_default_privacyPrivacidad del calendario por defectoselection
calculado

Valores: public (Público por defecto), private (Privado por defecto), confidential (Solo para usuarios internos)

añadido por Calendario (calendar)

can_edit_rolePuede editar el rolboolean
calculado

añadido por Conversaciones (mail)

category_idsEtiquetas del empleadomany2many

related: employee_id.category_ids

añadido por Empleados (hr)

companies_countNúmero de compañíasinteger
calculado
company_idCompañía

La compañía por defecto para este usuario.

many2one
obligatorio
company_idsCompañíasmany2many
create_dateFecha de creacióndatetime
solo lectura

añadido por Foro (website_forum)

create_employeeCampo técnico, si se debe crear un empleadoboolean

añadido por Empleados (hr)

create_employee_idCampo técnico, vincula al usuario con este empleado en la creaciónmany2one

añadido por Empleados (hr)

crm_team_idsEquipos de ventasmany2many
solo lecturacalculado

añadido por Equipos de ventas (sales_team)

crm_team_member_idsMiembros del equipo de ventasone2many

inverso: user_id

añadido por Equipos de ventas (sales_team)

device_idsDispositivos de usuariosone2many

inverso: user_id

emailCorreo electrónicochar

related: partner_id.email

email_domain_placeholderEmail Domain Placeholderchar
calculado
emergency_contactContacto de emergenciachar

related: employee_id.emergency_contact

añadido por Empleados (hr)

emergency_phoneTeléfono de emergenciachar

related: employee_id.emergency_phone

añadido por Empleados (hr)

employee_bank_account_idsCuentas bancarias del empleadomany2many

related: employee_id.bank_account_ids

añadido por Empleados (hr)

employee_countNúmero de empleadosinteger
calculado

añadido por Empleados (hr)

employee_idEmpleado de la compañíamany2one
calculado

añadido por Empleados (hr)

employee_idsEmpleado relacionadoone2many

inverso: user_id

añadido por Empleados (hr)

employee_resource_calendar_idHoras laborables del empleadomany2one
solo lectura

related: employee_id.resource_calendar_id

añadido por Empleados (hr)

employee_skill_idsEmployee Skillone2many

related: employee_id.employee_skill_ids

añadido por Proyecto - Habilidades (project_hr_skills)

favorite_lunch_product_idsProducto de comida favoritomany2many

añadido por Comida (lunch)

favorite_project_idsProyectos favoritosmany2many

añadido por Proyecto (project)

friday_location_idViernesmany2one

related: employee_id.friday_location_id

añadido por Teletrabajo (hr_homeworking)

goal_idsMetaone2many

inverso: user_id

añadido por Ludificación en RR. HH. (hr_gamification)

gold_badgeNúmero de insignias de orointeger
calculado

añadido por Ludificación (gamification)

google_calendar_cal_idGoogle Calendar Calchar

related: res_users_settings_id.google_calendar_cal_id

añadido por Google Calendar (google_calendar)

google_calendar_rtokenGoogle Calendar Rtokenchar

related: res_users_settings_id.google_calendar_rtoken

añadido por Google Calendar (google_calendar)

google_calendar_sync_tokenGoogle Calendar Sync Tokenchar

related: res_users_settings_id.google_calendar_sync_token

añadido por Google Calendar (google_calendar)

google_calendar_tokenGoogle Calendar Tokenchar

related: res_users_settings_id.google_calendar_token

añadido por Google Calendar (google_calendar)

google_calendar_token_validityGoogle Calendar Token Validitydatetime

related: res_users_settings_id.google_calendar_token_validity

añadido por Google Calendar (google_calendar)

google_synchronization_stoppedGoogle Synchronization Stoppedboolean

related: res_users_settings_id.google_synchronization_stopped

añadido por Google Calendar (google_calendar)

group_idsGrupos

Grupos asignados explícitamente al usuario

many2many
groups_countN.° de grupos

Número de grupos que se aplican al usuario actual.

integer
calculado
has_access_livechatTiene acceso al chat en directoboolean
solo lecturacalculado

añadido por Chat en directo (im_livechat)

has_external_mail_serverTiene un servidor externo de correo electrónicoboolean
calculado

añadido por Conversaciones (mail)

has_oauth_access_tokenTiene token de acceso OAuthboolean
calculado

añadido por Autentificación OAuth2 (auth_oauth)

im_statusEstado de mensajería instantaneachar
calculado

añadido por Conversaciones (mail)

is_hr_userEs usuario de RR. HH.boolean
calculado

añadido por Empleados (hr)

is_in_callEstá en una llamadaboolean

related: partner_id.is_in_call

añadido por Conversaciones (mail)

is_out_of_officeFuera de la oficinaboolean
calculado

añadido por Conversaciones (mail)

is_systemEs un sistemaboolean
calculado

añadido por Empleados (hr)

job_titleNombre del puestochar

related: employee_id.job_title

añadido por Empleados (hr)

karmaKarmainteger
calculado, almacenado

añadido por Ludificación (gamification)

karma_tracking_idsCambios de karmaone2many

inverso: user_id

añadido por Ludificación (gamification)

km_home_workKm Home Workinteger

related: employee_id.km_home_work

añadido por Empleados (hr)

last_lunch_location_idLugar de la última comidamany2one

añadido por Comida (lunch)

leave_date_toFecha de finalización del permisodate

related: employee_id.leave_date_to

añadido por Ausencias (hr_holidays)

livechat_channel_idsCanal de chat en directomany2many

añadido por Chat en directo (im_livechat)

livechat_expertise_idsConocimientos en chat en directo

Al redirigir conversaciones de chat en directo, el chatbot dará prioridad a los usuarios con conocimientos coincidentes.

many2many
calculado

añadido por Chat en directo (im_livechat)

livechat_is_in_callEl chat en directo está en una llamada

Si el usuario está en una llamada. Solo está disponible si el usuario es un agente de chat en directo

boolean
calculado

añadido por Chat en directo (im_livechat)

livechat_lang_idsIdiomas del chat en directomany2many
calculado

añadido por Chat en directo (im_livechat)

livechat_ongoing_session_countNúmero de sesiones en cursointeger
calculado

añadido por Chat en directo (im_livechat)

livechat_usernameNombre de usuario del chat en directochar
calculado

añadido por Chat en directo (im_livechat)

log_idsRegistros de entrada de usuariosone2many

inverso: create_uid

loginUsuario

Utilizado para conectarse al sistema

char
obligatorio
login_dateÚltima autenticacióndatetime

related: log_ids.create_date

manual_im_statusEstado de mensajería instantánea establecido manualmente por el usuarioselection

Valores: away (Ausente), busy (No molestar), offline (Desconectado)

añadido por Conversaciones (mail)

microsoft_calendar_rtokenToken de actualización de Microsoftchar

añadido por Usuarios de Microsoft (microsoft_account)

microsoft_calendar_sync_tokenMicrosoft Calendar Sync Tokenchar

related: res_users_settings_id.microsoft_calendar_sync_token

añadido por Calendario de Outlook (microsoft_calendar)

microsoft_calendar_tokenToken de usuario de Microsoftchar

añadido por Usuarios de Microsoft (microsoft_account)

microsoft_calendar_token_validityValidez del token de Microsoftdatetime

añadido por Usuarios de Microsoft (microsoft_account)

microsoft_last_sync_dateMicrosoft Last Sync Datedatetime

related: res_users_settings_id.microsoft_last_sync_date

añadido por Calendario de Outlook (microsoft_calendar)

microsoft_synchronization_stoppedMicrosoft Synchronization Stoppedboolean

related: res_users_settings_id.microsoft_synchronization_stopped

añadido por Calendario de Outlook (microsoft_calendar)

mobile_phoneTeléfono móvilchar

related: employee_id.mobile_phone

añadido por Empleados (hr)

monday_location_idLunesmany2one

related: employee_id.monday_location_id

añadido por Teletrabajo (hr_homeworking)

nameNombrechar

related: partner_id.name

new_passwordEstablecer contraseña

Especifique un valor sólo cuando esté creando un usuario o si está cambiando la contraseña del mismo. En otro caso déjelo vacío. Después de un cambio de contraseña, el usuario debe iniciar sesión de nuevo.

char
calculado
next_rank_idSiguiente rangomany2one

añadido por Ludificación (gamification)

notification_typeNotificación

Policy on how to handle Chatter notifications: - By Emails: notifications are sent to your email address - In Odoo: notifications appear in your Odoo Inbox

selection
obligatoriocalculado, almacenado

Valores: email (Por correo electrónico), inbox (En Odoo)

añadido por Conversaciones (mail)

oauth_access_tokenAlmacenamiento de token de acceso OAuthchar
solo lectura

añadido por Autentificación OAuth2 (auth_oauth)

oauth_provider_idProveedor OAuthmany2one

añadido por Autentificación OAuth2 (auth_oauth)

oauth_uidIdentificación de usuario OAuth

user_id del proveedor OAuth

char

añadido por Autentificación OAuth2 (auth_oauth)

odoobot_failedOdoobot fallóboolean
solo lectura

añadido por OdooBot (mail_bot)

odoobot_stateEstado de OdooBotselection
solo lectura

Valores: not_initialized (No inicializado), onboarding_emoji (Emoji de incorporación), onboarding_attachement (Archivo adjunto de incorporación), onboarding_command (Mando de incorporación), onboarding_ping (Ping de incorporación), onboarding_canned (Incorporación predefinida), idle (Inactivo), disabled (Deshabilitado)

añadido por OdooBot (mail_bot)

out_of_office_fromFuera de la oficina a partir deldatetime

añadido por Conversaciones (mail)

out_of_office_messageRespuesta automática para cuando estés de vacacioneshtml

añadido por Conversaciones (mail)

out_of_office_toFuera de la oficina hastadatetime

añadido por Conversaciones (mail)

outgoing_mail_server_idServidor de correo de salidamany2one
calculado

añadido por Conversaciones (mail)

outgoing_mail_server_typeTipo de servidor de correo salienteselection
obligatoriocalculado

Valores: default (Por defecto)

añadido por Conversaciones (mail)

partner_idContacto relacionado

Datos de contacto del usuario

many2one
obligatorio
passwordContraseña

Mantenga vacío si no quiere que el usuario sea capaz de conectarse al sistema.

char
calculado
phoneTeléfonochar

related: partner_id.phone

pinFijarchar

related: employee_id.pin

añadido por Empleados (hr)

presence_idsPresenciaone2many

inverso: user_id

añadido por Conversaciones (mail)

private_cityCiudad privadachar

related: employee_id.private_city

añadido por Empleados (hr)

private_country_idPaís privadomany2one

related: employee_id.private_country_id

añadido por Empleados (hr)

private_emailCorreo electrónico privadochar

related: employee_id.private_email

añadido por Empleados (hr)

private_phoneTeléfono privadochar

related: employee_id.private_phone

añadido por Empleados (hr)

private_state_idProvincia privadamany2one

related: employee_id.private_state_id

añadido por Empleados (hr)

private_streetCalle privadachar

related: employee_id.private_street

añadido por Empleados (hr)

private_street2Calle2 privadachar

related: employee_id.private_street2

añadido por Empleados (hr)

private_zipCódigo Postal privadochar

related: employee_id.private_zip

añadido por Empleados (hr)

property_warehouse_idAlmacén por defectomany2one
depende de la empresa

añadido por Gestión de Ventas y Almacén (sale_stock)

rank_idRangomany2one

añadido por Ludificación (gamification)

res_users_settings_idAjustesmany2one
calculado
res_users_settings_idsAjustes del recurso del usuarioone2many

inverso: user_id

resource_calendar_idHoras laborables por defectomany2one

related: resource_ids.calendar_id

añadido por Recurso (resource)

resource_idsRecursosone2many

inverso: user_id

añadido por Recurso (resource)

roleRolselection
calculado

Valores: group_user (Usuario), group_system (Administrador)

role_idsRoles de usuarios

Los usuarios reciben una notificación cuando se usa “@” para mencionar uno de sus roles en una conversación.

many2many

añadido por Conversaciones (mail)

rules_count# Reglas de registro

Número de reglas de registro que se aplican al usuario actual

integer
calculado
sale_team_idEquipo de ventas del usuario

Usuario principal del equipo de ventas. Se utiliza especialmente para el flujo de trabajo, o para establecer el equipo de ventas en la facturación o suscripción.

many2one
solo lecturacalculado, almacenado

añadido por Equipos de ventas (sales_team)

saturday_location_idSábadosmany2one

related: employee_id.saturday_location_id

añadido por Teletrabajo (hr_homeworking)

shareCompartir usuario

Usuario externo con acceso limitado, creado sólamente con el propósito de compartir datos.

boolean
calculado, almacenado
signatureFirma de correo electrónicohtml
calculado, almacenado
silver_badgeNúmero de insignias de platainteger
calculado

añadido por Ludificación (gamification)

stateEstadoselection
calculado

Valores: new (Invitado), active (Confirmado)

añadido por Registro (auth_signup)

sunday_location_idDomingosmany2one

related: employee_id.sunday_location_id

añadido por Teletrabajo (hr_homeworking)

thursday_location_idJuevesmany2one

related: employee_id.thursday_location_id

añadido por Teletrabajo (hr_homeworking)

totp_enabledAutenticación de dos factoresboolean
calculado

añadido por Autenticación de dos factores (TOTP) (auth_totp)

totp_last_counterÚltimo contador TOTPinteger

añadido por Autenticación de dos factores (TOTP) (auth_totp)

totp_secretSecreto TOTPchar
calculado

añadido por Autenticación de dos factores (TOTP) (auth_totp)

totp_trusted_device_idsDispositivos de confianzaone2many

inverso: user_id

añadido por Autenticación de dos factores (TOTP) (auth_totp)

tour_enabledIncorporaciónboolean
calculado, almacenado

añadido por Recorridos (web_tour)

tuesday_location_idMartesmany2one

related: employee_id.tuesday_location_id

añadido por Teletrabajo (hr_homeworking)

tz_offsetCompensación de zona horariachar
calculado
view_group_hierarchyCampo técnico para la configuración del grupo de usuariosjson
visa_expireVisa Expiredate

related: employee_id.visa_expire

añadido por Empleados (hr)

website_idSitio webmany2one

related: partner_id.website_id

añadido por Sitio web (website)

wednesday_location_idMiércolesmany2one

related: employee_id.wednesday_location_id

añadido por Teletrabajo (hr_homeworking)

work_contact_idContacto de trabajomany2one

related: employee_id.work_contact_id

añadido por Empleados (hr)

work_emailCorreo electrónico de trabajochar

related: employee_id.work_email

añadido por Empleados (hr)

work_location_idUbicación de trabajomany2one

related: employee_id.work_location_id

añadido por Empleados (hr)

work_location_nameNombre de la ubicación de trabajochar

related: employee_id.work_location_name

añadido por Empleados (hr)

work_location_typeTipo de la ubicación de trabajoselection

related: employee_id.work_location_type

añadido por Empleados (hr)

work_phoneTeléfono del trabajochar

related: employee_id.work_phone

añadido por Empleados (hr)

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 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/res.users/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","login","notification_type","partner_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}/res.users/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","company_id","login","notification_type","partner_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/res-users">res.users (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.