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écnico | Etiqueta | Tipo | Detalles |
|---|---|---|---|
| accesses_count | # Permisos de acceso Número de permisos de acceso que se aplican al usuario actual | integer | calculado |
| action_id | Acció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 | |
| active | Activo | boolean | |
| active_partner | El contacto está activo | boolean | solo lectura related: |
| additional_note | Nota adicional | text | related: añadido por Empleados ( |
| all_group_ids | Grupos y grupos implicados | many2many | calculado |
| api_key_ids | Claves API | one2many | inverso: |
| auth_passkey_key_ids | Clave de acceso de autenticación | one2many | inverso: añadido por Claves de acceso ( |
| badge_ids | Insignias | one2many | inverso: añadido por Ludificación ( |
| bank_account_ids | Cuenta bancaria | many2many | related: añadido por Empleados ( |
| barcode | Código de barras | char | related: añadido por Empleados ( |
| bronze_badge | Número de insignias de bronce | integer | calculado añadido por Ludificación ( |
| calendar_default_privacy | Privacidad del calendario por defecto | selection | calculado Valores: añadido por Calendario ( |
| can_edit_role | Puede editar el rol | boolean | calculado añadido por Conversaciones ( |
| category_ids | Etiquetas del empleado | many2many | related: añadido por Empleados ( |
| companies_count | Número de compañías | integer | calculado |
| company_id | Compañía La compañía por defecto para este usuario. | many2one | obligatorio |
| company_ids | Compañías | many2many | |
| create_date | Fecha de creación | datetime | solo lectura añadido por Foro ( |
| create_employee | Campo técnico, si se debe crear un empleado | boolean | añadido por Empleados ( |
| create_employee_id | Campo técnico, vincula al usuario con este empleado en la creación | many2one | añadido por Empleados ( |
| crm_team_ids | Equipos de ventas | many2many→ crm.team | solo lecturacalculado añadido por Equipos de ventas ( |
| crm_team_member_ids | Miembros del equipo de ventas | one2many | inverso: añadido por Equipos de ventas ( |
| device_ids | Dispositivos de usuarios | one2many | inverso: |
| Correo electrónico | char | related: | |
| email_domain_placeholder | Email Domain Placeholder | char | calculado |
| emergency_contact | Contacto de emergencia | char | related: añadido por Empleados ( |
| emergency_phone | Teléfono de emergencia | char | related: añadido por Empleados ( |
| employee_bank_account_ids | Cuentas bancarias del empleado | many2many | related: añadido por Empleados ( |
| employee_count | Número de empleados | integer | calculado añadido por Empleados ( |
| employee_id | Empleado de la compañía | many2one | calculado añadido por Empleados ( |
| employee_ids | Empleado relacionado | one2many | inverso: añadido por Empleados ( |
| employee_resource_calendar_id | Horas laborables del empleado | many2one | solo lectura related: añadido por Empleados ( |
| employee_skill_ids | Employee Skill | one2many | related: añadido por Proyecto - Habilidades ( |
| favorite_lunch_product_ids | Producto de comida favorito | many2many | añadido por Comida ( |
| favorite_project_ids | Proyectos favoritos | many2many | añadido por Proyecto ( |
| friday_location_id | Viernes | many2one | related: añadido por Teletrabajo ( |
| goal_ids | Meta | one2many | inverso: añadido por Ludificación en RR. HH. ( |
| gold_badge | Número de insignias de oro | integer | calculado añadido por Ludificación ( |
| google_calendar_cal_id | Google Calendar Cal | char | related: añadido por Google Calendar ( |
| google_calendar_rtoken | Google Calendar Rtoken | char | related: añadido por Google Calendar ( |
| google_calendar_sync_token | Google Calendar Sync Token | char | related: añadido por Google Calendar ( |
| google_calendar_token | Google Calendar Token | char | related: añadido por Google Calendar ( |
| google_calendar_token_validity | Google Calendar Token Validity | datetime | related: añadido por Google Calendar ( |
| google_synchronization_stopped | Google Synchronization Stopped | boolean | related: añadido por Google Calendar ( |
| group_ids | Grupos Grupos asignados explícitamente al usuario | many2many | |
| groups_count | N.° de grupos Número de grupos que se aplican al usuario actual. | integer | calculado |
| has_access_livechat | Tiene acceso al chat en directo | boolean | solo lecturacalculado añadido por Chat en directo ( |
| has_external_mail_server | Tiene un servidor externo de correo electrónico | boolean | calculado añadido por Conversaciones ( |
| has_oauth_access_token | Tiene token de acceso OAuth | boolean | calculado añadido por Autentificación OAuth2 ( |
| im_status | Estado de mensajería instantanea | char | calculado añadido por Conversaciones ( |
| is_hr_user | Es usuario de RR. HH. | boolean | calculado añadido por Empleados ( |
| is_in_call | Está en una llamada | boolean | related: añadido por Conversaciones ( |
| is_out_of_office | Fuera de la oficina | boolean | calculado añadido por Conversaciones ( |
| is_system | Es un sistema | boolean | calculado añadido por Empleados ( |
| job_title | Nombre del puesto | char | related: añadido por Empleados ( |
| karma | Karma | integer | calculado, almacenado añadido por Ludificación ( |
| karma_tracking_ids | Cambios de karma | one2many | inverso: añadido por Ludificación ( |
| km_home_work | Km Home Work | integer | related: añadido por Empleados ( |
| last_lunch_location_id | Lugar de la última comida | many2one | añadido por Comida ( |
| leave_date_to | Fecha de finalización del permiso | date | related: añadido por Ausencias ( |
| livechat_channel_ids | Canal de chat en directo | many2many | añadido por Chat en directo ( |
| livechat_expertise_ids | Conocimientos 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 ( |
| livechat_is_in_call | El 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 ( |
| livechat_lang_ids | Idiomas del chat en directo | many2many→ res.lang | calculado añadido por Chat en directo ( |
| livechat_ongoing_session_count | Número de sesiones en curso | integer | calculado añadido por Chat en directo ( |
| livechat_username | Nombre de usuario del chat en directo | char | calculado añadido por Chat en directo ( |
| log_ids | Registros de entrada de usuarios | one2many | inverso: |
| login | Usuario Utilizado para conectarse al sistema | char | obligatorio |
| login_date | Última autenticación | datetime | related: |
| manual_im_status | Estado de mensajería instantánea establecido manualmente por el usuario | selection | Valores: añadido por Conversaciones ( |
| microsoft_calendar_rtoken | Token de actualización de Microsoft | char | añadido por Usuarios de Microsoft ( |
| microsoft_calendar_sync_token | Microsoft Calendar Sync Token | char | related: añadido por Calendario de Outlook ( |
| microsoft_calendar_token | Token de usuario de Microsoft | char | añadido por Usuarios de Microsoft ( |
| microsoft_calendar_token_validity | Validez del token de Microsoft | datetime | añadido por Usuarios de Microsoft ( |
| microsoft_last_sync_date | Microsoft Last Sync Date | datetime | related: añadido por Calendario de Outlook ( |
| microsoft_synchronization_stopped | Microsoft Synchronization Stopped | boolean | related: añadido por Calendario de Outlook ( |
| mobile_phone | Teléfono móvil | char | related: añadido por Empleados ( |
| monday_location_id | Lunes | many2one | related: añadido por Teletrabajo ( |
| name | Nombre | char | related: |
| new_password | Establecer 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_id | Siguiente rango | many2one | añadido por Ludificación ( |
| notification_type | Notificació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: añadido por Conversaciones ( |
| oauth_access_token | Almacenamiento de token de acceso OAuth | char | solo lectura añadido por Autentificación OAuth2 ( |
| oauth_provider_id | Proveedor OAuth | many2one | añadido por Autentificación OAuth2 ( |
| oauth_uid | Identificación de usuario OAuth user_id del proveedor OAuth | char | añadido por Autentificación OAuth2 ( |
| odoobot_failed | Odoobot falló | boolean | solo lectura añadido por OdooBot ( |
| odoobot_state | Estado de OdooBot | selection | solo lectura Valores: añadido por OdooBot ( |
| out_of_office_from | Fuera de la oficina a partir del | datetime | añadido por Conversaciones ( |
| out_of_office_message | Respuesta automática para cuando estés de vacaciones | html | añadido por Conversaciones ( |
| out_of_office_to | Fuera de la oficina hasta | datetime | añadido por Conversaciones ( |
| outgoing_mail_server_id | Servidor de correo de salida | many2one | calculado añadido por Conversaciones ( |
| outgoing_mail_server_type | Tipo de servidor de correo saliente | selection | obligatoriocalculado Valores: añadido por Conversaciones ( |
| partner_id | Contacto relacionado Datos de contacto del usuario | many2one | obligatorio |
| password | Contraseña Mantenga vacío si no quiere que el usuario sea capaz de conectarse al sistema. | char | calculado |
| phone | Teléfono | char | related: |
| pin | Fijar | char | related: añadido por Empleados ( |
| presence_ids | Presencia | one2many | inverso: añadido por Conversaciones ( |
| private_city | Ciudad privada | char | related: añadido por Empleados ( |
| private_country_id | País privado | many2one | related: añadido por Empleados ( |
| private_email | Correo electrónico privado | char | related: añadido por Empleados ( |
| private_phone | Teléfono privado | char | related: añadido por Empleados ( |
| private_state_id | Provincia privada | many2one | related: añadido por Empleados ( |
| private_street | Calle privada | char | related: añadido por Empleados ( |
| private_street2 | Calle2 privada | char | related: añadido por Empleados ( |
| private_zip | Código Postal privado | char | related: añadido por Empleados ( |
| property_warehouse_id | Almacén por defecto | many2one | depende de la empresa añadido por Gestión de Ventas y Almacén ( |
| rank_id | Rango | many2one | añadido por Ludificación ( |
| res_users_settings_id | Ajustes | many2one | calculado |
| res_users_settings_ids | Ajustes del recurso del usuario | one2many | inverso: |
| resource_calendar_id | Horas laborables por defecto | many2one | related: añadido por Recurso ( |
| resource_ids | Recursos | one2many | inverso: añadido por Recurso ( |
| role | Rol | selection | calculado Valores: |
| role_ids | Roles de usuarios Los usuarios reciben una notificación cuando se usa “@” para mencionar uno de sus roles en una conversación. | many2many→ res.role | añadido por Conversaciones ( |
| rules_count | # Reglas de registro Número de reglas de registro que se aplican al usuario actual | integer | calculado |
| sale_team_id | Equipo 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→ crm.team | solo lecturacalculado, almacenado añadido por Equipos de ventas ( |
| saturday_location_id | Sábados | many2one | related: añadido por Teletrabajo ( |
| share | Compartir usuario Usuario externo con acceso limitado, creado sólamente con el propósito de compartir datos. | boolean | calculado, almacenado |
| signature | Firma de correo electrónico | html | calculado, almacenado |
| silver_badge | Número de insignias de plata | integer | calculado añadido por Ludificación ( |
| state | Estado | selection | calculado Valores: añadido por Registro ( |
| sunday_location_id | Domingos | many2one | related: añadido por Teletrabajo ( |
| thursday_location_id | Jueves | many2one | related: añadido por Teletrabajo ( |
| totp_enabled | Autenticación de dos factores | boolean | calculado añadido por Autenticación de dos factores (TOTP) ( |
| totp_last_counter | Último contador TOTP | integer | añadido por Autenticación de dos factores (TOTP) ( |
| totp_secret | Secreto TOTP | char | calculado añadido por Autenticación de dos factores (TOTP) ( |
| totp_trusted_device_ids | Dispositivos de confianza | one2many | inverso: añadido por Autenticación de dos factores (TOTP) ( |
| tour_enabled | Incorporación | boolean | calculado, almacenado añadido por Recorridos ( |
| tuesday_location_id | Martes | many2one | related: añadido por Teletrabajo ( |
| tz_offset | Compensación de zona horaria | char | calculado |
| view_group_hierarchy | Campo técnico para la configuración del grupo de usuarios | json | |
| visa_expire | Visa Expire | date | related: añadido por Empleados ( |
| website_id | Sitio web | many2one→ website | related: añadido por Sitio web ( |
| wednesday_location_id | Miércoles | many2one | related: añadido por Teletrabajo ( |
| work_contact_id | Contacto de trabajo | many2one | related: añadido por Empleados ( |
| work_email | Correo electrónico de trabajo | char | related: añadido por Empleados ( |
| work_location_id | Ubicación de trabajo | many2one | related: añadido por Empleados ( |
| work_location_name | Nombre de la ubicación de trabajo | char | related: añadido por Empleados ( |
| work_location_type | Tipo de la ubicación de trabajo | selection | related: añadido por Empleados ( |
| work_phone | Teléfono del trabajo | char | related: añadido por Empleados ( |
| create_uid | Creado por | many2one | solo lecturaautomático |
| display_name | Nombre mostrado | char | solo lecturacalculadoautomático |
| id | ID | integer | solo lecturaautomático |
| write_date | Última actualización el | datetime | solo lecturaautomático |
| write_uid | Última actualización por | many2one | solo lecturaautomático |
Relaciones
Modelos enlazados desde este modelo
- auth_totp.device: totp_trusted_device_ids
- auth.oauth.provider: oauth_provider_id
- auth.passkey.key: auth_passkey_key_ids
- crm.team: crm_team_ids, sale_team_id
- crm.team.member: crm_team_member_ids
- gamification.badge.user: badge_ids
- gamification.goal: goal_ids
- gamification.karma.rank: next_rank_id, rank_id
- gamification.karma.tracking: karma_tracking_ids
- hr.employee: create_employee_id, employee_id, employee_ids
- hr.employee.category: category_ids
- hr.employee.skill: employee_skill_ids
- hr.work.location: friday_location_id, monday_location_id, saturday_location_id, sunday_location_id, thursday_location_id, tuesday_location_id, wednesday_location_id, work_location_id
- im_livechat.channel: livechat_channel_ids
- im_livechat.expertise: livechat_expertise_ids
- ir.actions.actions: action_id
- ir.mail_server: outgoing_mail_server_id
- lunch.location: last_lunch_location_id
- lunch.product: favorite_lunch_product_ids
- mail.presence: presence_ids
- project.project: favorite_project_ids
- res.company: company_id, company_ids
- res.country: private_country_id
- res.country.state: private_state_id
- res.device: device_ids
- res.groups: all_group_ids, group_ids
- res.lang: livechat_lang_ids
- res.partner: partner_id, work_contact_id
- res.partner.bank: bank_account_ids, employee_bank_account_ids
- res.role: role_ids
- res.users.apikeys: api_key_ids
- res.users.log: log_ids
- res.users.settings: res_users_settings_id, res_users_settings_ids
- resource.calendar: resource_calendar_id
- resource.resource: resource_ids
- stock.warehouse: property_warehouse_id
- website: website_id
Campos de otros modelos que apuntan aquí
- account.analytic.line: user_id
- account.analytic.line.calendar.employee: user_id
- account.invoice.report: invoice_user_id
- account.lock_exception: user_id
- account.move: invoice_user_id, user_id
- auth_totp.wizard: user_id
- auth.passkey.key: create_uid
- auth.totp.rate.limit.log: user_id
- base.module.install.request: user_id, user_ids
- blog.post: create_uid, write_uid
- calendar.event: user_id
- calendar.filters: user_id
- card.campaign: user_id
- change.password.user: user_id
- crm.activity.report: user_id
- crm.iap.lead.mining.request: user_id
- crm.lead: user_id
- crm.lead2opportunity.partner: user_id
- crm.lead2opportunity.partner.mass: user_ids
- crm.merge.opportunity: user_id
- crm.partner.report.assign: user_id
- crm.reveal.rule: user_id
- crm.team: favorite_user_ids, member_ids, user_id
- crm.team.member: user_id, user_in_teams_ids
- data_recycle.model: notify_user_ids
- digest.digest: user_ids
- digest.tip: user_ids
- event.event: user_id
- event.lead.rule: lead_user_id
- event.registration: event_user_id
- event.sale.report: sale_order_user_id
- event.track: user_id
- fleet.vehicle: manager_id
- fleet.vehicle.log.contract: user_id
- fleet.vehicle.log.services: manager_id
- forum.post: closed_uid, create_uid, favourite_ids, flag_user_id, moderator_id, write_uid
- forum.post.vote: recipient_id, user_id
- gamification.badge: rule_auth_user_ids, unique_owner_ids
- gamification.badge.user: sender_id, user_id
- gamification.badge.user.wizard: user_id
- y 111 más
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 -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}'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
- Código fuente del modelo en GitHub
- Documentación de Odoo 19: ORM API
- Documentación de Odoo 19: API externa JSON-2
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.