Odoo 20.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 191 campos, 162 de ellos declarados directamente en el modelo; 207 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
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, phone_validation, base_import, calendar, contacts, sales_team, crm, im_livechat, crm_livechat, project, gamification, google_calendar, google_gmail, hr, hr_attendance, hr_calendar_google, hr_gamification, hr_holidays, hr_recruitment, website, website_profile, website_slides, point_of_sale, lunch, mail_bot, mass_mailing, mass_mailing_sms, microsoft_account, microsoft_calendar, microsoft_outlook, stock, sale_stock, project_hr_skills, project_todo, website_sale, web_unsplash, website_forum
Orden por defecto (_order)
name, login
Hereda de (mixins)
bus.listener.mixinmail.threadmail.activity.mixinpos.load.mixin
Delegación (_inherits)
res.partner: los campos de este modelo también están disponibles, mediante partner_id

Campos del modelo

162 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.

191 de 191 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

añadido por Empleados (hr)

all_employee_idsRelated employees from all companiesone2many

inverso: user_id

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

bank_account_idsCuenta bancariamany2many

añadido por Empleados (hr)

barcodeCódigo de barraschar

añadido por Empleados (hr)

birthdayCumpleañosdate

añadido por Empleados (hr)

birthday_public_displayBirthday Public Displayboolean

añadido por Empleados (hr)

bronze_badgeNúmero de insignias de bronceinteger
calculado

añadido por Gamification (gamification)

calendar_idsCalendarioone2many
calculado

añadido por Calendario (calendar)

calendar_user_idsCalendar Userone2many

inverso: user_id

añadido por Calendario (calendar)

can_edit_rolePuede editar el rolboolean
calculado

añadido por Conversaciones (mail)

category_idsCategoríamany2many

añadido por Empleados (hr)

cityCiudadchar

related: partner_id.city

añadido por Website profile (website_profile)

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

La compañía por defecto para este usuario.

many2one
obligatorio
company_idsCompañíasmany2many
country_idPaísmany2one

related: partner_id.country_id

añadido por Website profile (website_profile)

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)

department_idDepartamentomany2one

related: employee_id.department_id

añadido por Empleados (hr)

device_idsDispositivos de usuariosone2many

inverso: user_id

digest_idsDigestsmany2many

añadido por KPI Digests (digest)

emailCorreo electrónicochar

related: partner_id.email

email_domain_placeholderEmail Domain Placeholderchar
calculado
emergency_contactContacto de emergenciachar

añadido por Empleados (hr)

emergency_phoneTeléfono de emergenciachar

añadido por Empleados (hr)

employee_bank_account_idsEmployee Bank Accountmany2many

añadido por Empleados (hr)

employee_countNúmero de empleadosinteger
calculado

añadido por Empleados (hr)

employee_idEmpleado de la compañíamany2one
solo lecturacalculado

añadido por Empleados (hr)

employee_idsEmpleado relacionadoone2many

inverso: user_id

añadido por Empleados (hr)

employee_public_idsRelated employee (public)one2many
solo lectura

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 Project - Skills (project_hr_skills)

favorite_lunch_product_idsProducto de comida favoritomany2many

añadido por Comida (lunch)

favorite_project_idsProyectos favoritosmany2many

añadido por Proyecto (project)

followed_project_idsFollowed Projectmany2many

añadido por Proyecto (project)

friday_location_idFriday Locationmany2one

añadido por Empleados (hr)

goal_idsMetaone2many

inverso: user_id

añadido por HR Gamification (hr_gamification)

gold_badgeNúmero de insignias de orointeger
calculado

añadido por Gamification (gamification)

google_account_emailGoogle Account Emailchar

related: res_users_settings_id.google_account_email

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 OAuth2 Authentication (auth_oauth)

im_statusEstado de mensajería instantaneaselection
calculado

Valores: online (En línea), away (Ausente), busy (No molestar), offline (Desconectado)

añadido por Conversaciones (mail)

image_1920Imagen 1920binary

related: partner_id.image_1920

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

añadido por Empleados (hr)

karmaKarmainteger
calculado, almacenado

añadido por Gamification (gamification)

karma_tracking_idsCambios de karmaone2many

inverso: user_id

añadido por Gamification (gamification)

km_home_workKm Home Workinteger

añadido por Empleados (hr)

langIdiomaselection

related: partner_id.lang

last_lunch_location_idLugar de la última comidamany2one

añadido por Comida (lunch)

leave_date_toFecha de finalización del permisodate

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

loginInicio de sesión

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_account_emailMicrosoft Account Emailchar

related: res_users_settings_id.microsoft_account_email

añadido por Calendario de Outlook (microsoft_calendar)

microsoft_calendar_rtokenToken de actualización de Microsoftchar

añadido por Microsoft Users (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 Microsoft Users (microsoft_account)

microsoft_calendar_token_validityValidez del token de Microsoftdatetime

añadido por Microsoft Users (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

añadido por Empleados (hr)

monday_location_idMonday Locationmany2one

añadido por Empleados (hr)

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

notification_typeNotificación

How notifications for document messages and system updates are delivered: - By email: 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 OAuth2 Authentication (auth_oauth)

oauth_provider_idProveedor OAuthmany2one

añadido por OAuth2 Authentication (auth_oauth)

oauth_uidIdentificación de usuario OAuth

user_id del proveedor OAuth

char

añadido por OAuth2 Authentication (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)

offline_sinceDesconectado desdedatetime
calculado

añadido por Conversaciones (mail)

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)

owned_calendar_idsOwned Calendarone2many
calculado

añadido por Calendario (calendar)

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

añadido por Empleados (hr)

presence_idsPresenciaone2many

inverso: user_id

añadido por Conversaciones (mail)

primary_calendar_idPrimary Calendarmany2one
calculado, almacenado

añadido por Calendario (calendar)

private_cityCiudad privadachar

añadido por Empleados (hr)

private_country_idPaís privadomany2one

añadido por Empleados (hr)

private_emailCorreo electrónico privadochar

añadido por Empleados (hr)

private_phoneTeléfono privadochar

añadido por Empleados (hr)

private_state_idProvincia privadamany2one

añadido por Empleados (hr)

private_streetCalle privadachar

añadido por Empleados (hr)

private_street2Calle2 privadachar

añadido por Empleados (hr)

private_zipCódigo Postal privadochar

añadido por Empleados (hr)

project_role_idsRoles del proyectomany2many

añadido por Proyecto (project)

property_warehouse_idAlmacén por defectomany2one
depende de la empresa

añadido por Sales and Warehouse Management (sale_stock)

rank_idRangomany2one

añadido por Gamification (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: light_user (Claro), regular_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)

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_idSaturday Locationmany2one

añadido por Empleados (hr)

session_idsUser sessionsone2many

inverso: user_id

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

stateEstadoselection
calculado

Valores: new (Invitado), active (Confirmado), inactive (Inactivo)

añadido por Signup (auth_signup)

sunday_location_idSunday Locationmany2one

añadido por Empleados (hr)

thursday_location_idThursday Locationmany2one

añadido por Empleados (hr)

totp_enabledAutenticación de dos factoresboolean
calculado

añadido por Two-Factor Authentication (TOTP) (auth_totp)

totp_last_counterÚltimo contador TOTPinteger

añadido por Two-Factor Authentication (TOTP) (auth_totp)

totp_secretSecreto TOTPchar
calculado

añadido por Two-Factor Authentication (TOTP) (auth_totp)

totp_trusted_device_idsDispositivos de confianzaone2many

inverso: user_id

añadido por Two-Factor Authentication (TOTP) (auth_totp)

tour_enabledIncorporaciónboolean
calculado, almacenado

añadido por Recorridos (web_tour)

tuesday_location_idTuesday Locationmany2one

añadido por Empleados (hr)

tzZona horariaselection

related: partner_id.tz

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

añadido por Empleados (hr)

websiteSitio webchar

related: partner_id.website

añadido por Website profile (website_profile)

website_descriptionWebsite Descriptionhtml

related: partner_id.website_description

añadido por Website profile (website_profile)

website_idSitio webmany2one

related: partner_id.website_id

añadido por Sitio web (website)

website_publishedWebsite Publishedboolean

related: partner_id.website_published

añadido por Website profile (website_profile)

wednesday_location_idWednesday Locationmany2one

añadido por Empleados (hr)

work_contact_idContacto de trabajomany2one

añadido por Empleados (hr)

work_emailCorreo electrónico de trabajochar

añadido por Empleados (hr)

work_location_idUbicación de trabajomany2one

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

añadido por Empleados (hr)

writable_calendar_idsWritable Calendarone2many
calculado

añadido por Calendario (calendar)

activity_calendar_event_idSiguiente evento en el calendario de actividades.many2one
calculado

heredado de mail.activity.mixin

activity_date_deadlineFecha límite de la siguiente actividaddate
solo lecturacalculado

heredado de mail.activity.mixin

activity_exception_decorationDecoració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_iconIcono

Icono para indicar una actividad de excepción.

char
calculado

heredado de mail.activity.mixin

activity_idsActividadesone2many

inverso: res_id

heredado de mail.activity.mixin

activity_plans_idsPlanes de actividadesmany2many
calculado

heredado de mail.activity.mixin

activity_stateEstado 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_summaryResumen de la siguiente actividadchar

related: activity_ids.summary

heredado de mail.activity.mixin

activity_type_iconIcono de tipo de actividadchar

related: activity_ids.icon

heredado de mail.activity.mixin

activity_type_idTipo de la siguiente actividadmany2one

related: activity_ids.activity_type_id

heredado de mail.activity.mixin

activity_user_idUsuario responsablemany2one
solo lecturacalculado

heredado de mail.activity.mixin

has_messageTiene un mensajeboolean
calculado

heredado de mail.thread

message_attachment_countNúmero de archivos adjuntosinteger
calculado

heredado de mail.thread

message_follower_idsSeguidoresone2many

inverso: res_id

heredado de mail.thread

message_has_errorError de envío de mensaje

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

boolean
calculado

heredado de mail.thread

message_has_error_counterNúmero de errores

Número de mensajes con error de envío

integer
calculado

heredado de mail.thread

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

message_idsMensajesone2many

inverso: res_id

heredado de mail.thread

message_is_followerEs un seguidorboolean
calculado

heredado de mail.thread

message_needactionAcción requerida

Si está marcada, hay nuevos mensajes que requieren su atención.

boolean
calculado

heredado de mail.thread

message_needaction_counterNúmero de acciones

Número de mensajes que requieren una acción

integer
calculado

heredado de mail.thread

message_partner_idsSeguidores (Contactos)many2many
calculado

heredado de mail.thread

my_activity_date_deadlineFecha límite de mi actividaddate
solo lecturacalculado

heredado de mail.activity.mixin

rating_idsCalificacionesone2many

inverso: res_id

heredado de mail.thread

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/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 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.