Odoo 20.0 Community · Persistant

res.users : champs, relations et API

Le modèle res.users (« Utilisateur ») est un modèle persistant déclaré par le module Base, puis enrichi par 52 autres modules. Il expose 191 champs, dont 162 déclarés directement sur le modèle ; 207 champs d'autres modèles pointent vers lui. Retrouvez ci-dessous chaque champ avec son nom technique, son type, son libellé français et ses relations, puis un exemple d'appel à l'API JSON-2 d'Odoo 20.

Fiche d'identité

Nom technique
res.users
Libellé
Utilisateur
Type
Persistant (models.Model)
Table SQL
res_users
Module d'origine
Base (base)
Étendu par
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
Tri par défaut (_order)
name, login
Hérite de (mixins)
bus.listener.mixinmail.threadmail.activity.mixinpos.load.mixin
Délégation (_inherits)
res.partner : les champs de ce modèle sont aussi accessibles, via partner_id

Champs du modèle

162 champs propres, 24 hérités des mixins et 5 champs automatiques de l'ORM. Cliquez sur un nom pour obtenir le lien direct vers le champ.

191 champs affichés sur 191

Nom techniqueLibelléTypeDétails
accesses_count# Droits d'accès

Nombre de droits d'accès qui s'appliquent à l'utilisateur actuel

integer
calculé
action_idAction de la page d'accueil

Si spécifié, cette action sera ouverte à l'ouverture de session pour cet utilisateur, en plus du menu standard.

many2one
activeActifboolean
active_partnerLe partenaire est actifboolean
lecture seule

related : partner_id.active

additional_noteNote additionnelletext

ajouté par Employés (hr)

all_employee_idsEmployés associés de toutes les entreprisesone2many

inverse : user_id

ajouté par Employés (hr)

all_group_idsGroupes et groupes implicitesmany2many
calculé
api_key_idsClés APIone2many

inverse : user_id

auth_passkey_key_idsClé d'authentificationone2many

inverse : create_uid

ajouté par Clés d'accès (auth_passkey)

badge_idsBadgesone2many

inverse : user_id

ajouté par Gamification (gamification)

bank_account_idsCompte bancairemany2many

ajouté par Employés (hr)

barcodeCode-barreschar

ajouté par Employés (hr)

birthdayAnniversairedate

ajouté par Employés (hr)

birthday_public_displayBirthday Public Displayboolean

ajouté par Employés (hr)

bronze_badgeNombre de badges bronzeinteger
calculé

ajouté par Gamification (gamification)

calendar_idsCalendrierone2many
calculé

ajouté par Calendrier (calendar)

calendar_user_idsCalendar Userone2many

inverse : user_id

ajouté par Calendrier (calendar)

can_edit_rolePeut modifier le rôleboolean
calculé

ajouté par Discussion (mail)

category_idsCatégoriemany2many

ajouté par Employés (hr)

cityVillechar

related : partner_id.city

ajouté par Website profile (website_profile)

companies_countNombe de sociétésinteger
calculé
company_idSociété

La société par défaut pour cet utilisateur.

many2one
requis
company_idsSociétésmany2many
country_idPaysmany2one

related : partner_id.country_id

ajouté par Website profile (website_profile)

create_dateDate de créationdatetime
lecture seule

ajouté par Forum (website_forum)

create_employeeChamp technique, s'il faut créer un employéboolean

ajouté par Employés (hr)

create_employee_idChamp technique, lier l'utilisateur à cet employé lors de la créationmany2one

ajouté par Employés (hr)

crm_team_idsÉquipes commercialesmany2many
lecture seulecalculé

ajouté par Équipes commerciales (sales_team)

crm_team_member_idsMembres de l'équipe commercialeone2many

inverse : user_id

ajouté par Équipes commerciales (sales_team)

department_idDépartementmany2one

related : employee_id.department_id

ajouté par Employés (hr)

device_idsPériphériques de l'utilisateurone2many

inverse : user_id

digest_idsDigestsmany2many

ajouté par KPI Digests (digest)

emailE-mailchar

related : partner_id.email

email_domain_placeholderPlaceholder de domaine e-mailchar
calculé
emergency_contactContact d’urgencechar

ajouté par Employés (hr)

emergency_phoneNuméro d’urgencechar

ajouté par Employés (hr)

employee_bank_account_idsEmployee Bank Accountmany2many

ajouté par Employés (hr)

employee_countNombre d'employésinteger
calculé

ajouté par Employés (hr)

employee_idEmployé de la sociétémany2one
lecture seulecalculé

ajouté par Employés (hr)

employee_idsEmployé associéone2many

inverse : user_id

ajouté par Employés (hr)

employee_public_idsEmployé lié (public)one2many
lecture seule

inverse : user_id

ajouté par Employés (hr)

employee_resource_calendar_idHoraire de l'employémany2one
lecture seule

related : employee_id.resource_calendar_id

ajouté par Employés (hr)

employee_skill_idsEmployee Skillone2many

related : employee_id.employee_skill_ids

ajouté par Project - Skills (project_hr_skills)

favorite_lunch_product_idsProduit de déjeuner favorimany2many

ajouté par Déjeuner (lunch)

favorite_project_idsProjets favorismany2many

ajouté par Projet (project)

followed_project_idsFollowed Projectmany2many

ajouté par Projet (project)

friday_location_idFriday Locationmany2one

ajouté par Employés (hr)

goal_idsObjectifone2many

inverse : user_id

ajouté par HR Gamification (hr_gamification)

gold_badgeNombre de badges d'orinteger
calculé

ajouté par Gamification (gamification)

google_account_emailGoogle Account Emailchar

related : res_users_settings_id.google_account_email

ajouté par Google Agenda (google_calendar)

google_calendar_rtokenGoogle Calendar Rtokenchar

related : res_users_settings_id.google_calendar_rtoken

ajouté par Google Agenda (google_calendar)

google_calendar_sync_tokenGoogle Calendar Sync Tokenchar

related : res_users_settings_id.google_calendar_sync_token

ajouté par Google Agenda (google_calendar)

google_calendar_tokenGoogle Calendar Tokenchar

related : res_users_settings_id.google_calendar_token

ajouté par Google Agenda (google_calendar)

google_calendar_token_validityGoogle Calendar Token Validitydatetime

related : res_users_settings_id.google_calendar_token_validity

ajouté par Google Agenda (google_calendar)

google_synchronization_stoppedGoogle Synchronization Stoppedboolean

related : res_users_settings_id.google_synchronization_stopped

ajouté par Google Agenda (google_calendar)

group_idsGroupes

Groupes explicitement assignés à l’utilisateur

many2many
groups_count# Groupes

Nombre de groupes qui s'appliquent à l'utilisateur actuel

integer
calculé
has_access_livechatA accès au live chatboolean
lecture seulecalculé

ajouté par Live Chat (im_livechat)

has_external_mail_serverA un serveur de messagerie externeboolean
calculé

ajouté par Discussion (mail)

has_oauth_access_tokenPossède un jeton d'accès OAuthboolean
calculé

ajouté par OAuth2 Authentication (auth_oauth)

im_statusStatut de messagerie instantanéeselection
calculé

Valeurs : online (En ligne), away (Absent), busy (Ne pas déranger), offline (Hors ligne)

ajouté par Discussion (mail)

image_1920Image 1920binary

related : partner_id.image_1920

is_hr_userEst utilisateur RHboolean
calculé

ajouté par Employés (hr)

is_in_callEst en appelboolean

related : partner_id.is_in_call

ajouté par Discussion (mail)

is_out_of_officeAbsentboolean
calculé

ajouté par Discussion (mail)

is_systemEst lié au systèmeboolean
calculé

ajouté par Employés (hr)

job_titleTitre du postechar

ajouté par Employés (hr)

karmaKarmainteger
calculé, stocké

ajouté par Gamification (gamification)

karma_tracking_idsChangements Karmaone2many

inverse : user_id

ajouté par Gamification (gamification)

km_home_workKm Home Workinteger

ajouté par Employés (hr)

langLangselection

related : partner_id.lang

last_lunch_location_idLieu du dernier déjeunermany2one

ajouté par Déjeuner (lunch)

leave_date_toDate de fin du congédate

ajouté par Congés (hr_holidays)

livechat_channel_idsCanal de Live Chatmany2many

ajouté par Live Chat (im_livechat)

livechat_expertise_idsExpertise en Live Chat

Lors du transfert des conversations live chat, le chatbot priorisera les utilisateurs ayant une expertise correspondante.

many2many
calculé

ajouté par Live Chat (im_livechat)

livechat_is_in_callLive chat en appel

Indique si l’utilisateur est en appel, uniquement disponible si l’utilisateur est un agent live chat

boolean
calculé

ajouté par Live Chat (im_livechat)

livechat_lang_idsLangues du live chatmany2many
calculé

ajouté par Live Chat (im_livechat)

livechat_ongoing_session_countNombre de sessions en coursinteger
calculé

ajouté par Live Chat (im_livechat)

livechat_usernameNom d'utilisateur Live Chatchar
calculé

ajouté par Live Chat (im_livechat)

log_idsEntrées du journal utilisateurone2many

inverse : create_uid

loginSe connecter

Utilisé pour se connecter au système

char
requis
login_dateDernière connexiondatetime

related : log_ids.create_date

manual_im_statusStatut de messagerie instantanée défini manuellement par l’utilisateurselection

Valeurs : away (Absent), busy (Ne pas déranger), offline (Hors ligne)

ajouté par Discussion (mail)

microsoft_account_emailMicrosoft Account Emailchar

related : res_users_settings_id.microsoft_account_email

ajouté par Calendrier Outlook (microsoft_calendar)

microsoft_calendar_rtokenActualiser le jeton Microsoftchar

ajouté par Microsoft Users (microsoft_account)

microsoft_calendar_sync_tokenMicrosoft Calendar Sync Tokenchar

related : res_users_settings_id.microsoft_calendar_sync_token

ajouté par Calendrier Outlook (microsoft_calendar)

microsoft_calendar_tokenJeton d'utilisateur Microsoftchar

ajouté par Microsoft Users (microsoft_account)

microsoft_calendar_token_validityValidité du jeton Microsoftdatetime

ajouté par Microsoft Users (microsoft_account)

microsoft_last_sync_dateMicrosoft Last Sync Datedatetime

related : res_users_settings_id.microsoft_last_sync_date

ajouté par Calendrier Outlook (microsoft_calendar)

microsoft_synchronization_stoppedMicrosoft Synchronization Stoppedboolean

related : res_users_settings_id.microsoft_synchronization_stopped

ajouté par Calendrier Outlook (microsoft_calendar)

mobile_phoneTéléphone mobilechar

ajouté par Employés (hr)

monday_location_idMonday Locationmany2one

ajouté par Employés (hr)

nameNomchar

related : partner_id.name

new_passwordDéfinir le mot de passe

Indiquez une valeur uniquement lors de la création d'un utilisateur ou lors du changement de mot de passe de l'utilisateur, sinon laissez vide. Après un changement de mot de passe, l'utilisateur doit se reconnecter.

char
calculé
next_rank_idProchain rangmany2one

ajouté par Gamification (gamification)

notification_typeNotifications

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
requiscalculé, stocké

Valeurs : email (Par e-mails), inbox (Dans Odoo)

ajouté par Discussion (mail)

oauth_access_tokenStockage du jeton d'accès OAuthchar
lecture seule

ajouté par OAuth2 Authentication (auth_oauth)

oauth_provider_idFournisseur OAuthmany2one

ajouté par OAuth2 Authentication (auth_oauth)

oauth_uidID utilisateur OAuth

user_id du fournisseur OAuth

char

ajouté par OAuth2 Authentication (auth_oauth)

odoobot_failedÉchec de l'Odoobotboolean
lecture seule

ajouté par OdooBot (mail_bot)

odoobot_stateStatut OdooBotselection
lecture seule

Valeurs : not_initialized (Pas initialisé), onboarding_emoji (Emoji Parcours d'intégration), onboarding_attachement (Pièce jointe Parcours d'intégration), onboarding_command (Commande d'intégration), onboarding_ping (Ping d'intégration), onboarding_canned (Parcours d'intégration enregistré), idle (Inactif), disabled (Désactivé)

ajouté par OdooBot (mail_bot)

offline_sinceHors ligne depuisdatetime
calculé

ajouté par Discussion (mail)

out_of_office_fromAbsent à partir dudatetime

ajouté par Discussion (mail)

out_of_office_messageRépondeur d’absencehtml

ajouté par Discussion (mail)

out_of_office_toAbsent jusqu’audatetime

ajouté par Discussion (mail)

outgoing_mail_server_idServeur de messagerie sortantmany2one
calculé

ajouté par Discussion (mail)

outgoing_mail_server_typeType de serveur de messagerie sortantselection
requiscalculé

Valeurs : default (Par défaut)

ajouté par Discussion (mail)

owned_calendar_idsOwned Calendarone2many
calculé

ajouté par Calendrier (calendar)

partner_idPartenaire associé

Données relatives aux partenaires de l'utilisateur

many2one
requis
passwordMot de passe

Laissez vide si vous ne souhaitez pas que l'utilisateur puisse se connecter au système

char
calculé
phoneTéléphonechar

related : partner_id.phone

pinÉpinglerchar

ajouté par Employés (hr)

presence_idsPrésencesone2many

inverse : user_id

ajouté par Discussion (mail)

primary_calendar_idPrimary Calendarmany2one
calculé, stocké

ajouté par Calendrier (calendar)

private_cityVille privéchar

ajouté par Employés (hr)

private_country_idPays privémany2one

ajouté par Employés (hr)

private_emailAdresse e-mail privéechar

ajouté par Employés (hr)

private_phoneNuméro de téléphone privéchar

ajouté par Employés (hr)

private_state_idEtat privémany2one

ajouté par Employés (hr)

private_streetRue privéechar

ajouté par Employés (hr)

private_street2Rue2 privéechar

ajouté par Employés (hr)

private_zipCode postal privéchar

ajouté par Employés (hr)

project_role_idsRôles de projetmany2many

ajouté par Projet (project)

property_warehouse_idEntrepôt par défautmany2one
dépend de la société

ajouté par Sales and Warehouse Management (sale_stock)

rank_idRangmany2one

ajouté par Gamification (gamification)

res_users_settings_idParamètresmany2one
calculé
res_users_settings_idsParamètres res utilisateursone2many

inverse : user_id

resource_calendar_idHeures de travail par défautmany2one

related : resource_ids.calendar_id

ajouté par Ressource (resource)

resource_idsRessourcesone2many

inverse : user_id

ajouté par Ressource (resource)

roleRôleselection
calculé

Valeurs : light_user (Clair), regular_user (Utilisateur), group_system (Administrateur)

role_idsRôles utilisateurs

Les utilisateurs sont notifiés chaque fois que l’un de leurs rôles est mentionné avec @ dans une conversation.

many2many

ajouté par Discussion (mail)

sale_team_idÉquipe commerciale de l'utilisateur

Principale équipe commerciale de l'utilisateur. Utilisé notamment pour le pipeline ou pour configurer l'équipe commerciale dans la facturation ou l'abonnement.

many2one
lecture seulecalculé, stocké

ajouté par Équipes commerciales (sales_team)

saturday_location_idSaturday Locationmany2one

ajouté par Employés (hr)

session_idsSessions utilisateurone2many

inverse : user_id

sharePartager l'utilisateur

Utilisateur externe possédant un accès limité, créé uniquement dans le but de partager des données.

boolean
calculé, stocké
signatureSignature e-mailhtml
calculé, stocké
silver_badgeNombre des badges d'argentinteger
calculé

ajouté par Gamification (gamification)

stateStatutselection
calculé

Valeurs : new (Invité), active (Confirmé), inactive (Inactif)

ajouté par Signup (auth_signup)

sunday_location_idSunday Locationmany2one

ajouté par Employés (hr)

thursday_location_idThursday Locationmany2one

ajouté par Employés (hr)

totp_enabledAuthentification à deux facteursboolean
calculé

ajouté par Two-Factor Authentication (TOTP) (auth_totp)

totp_last_counterDernier compteur TOPTinteger

ajouté par Two-Factor Authentication (TOTP) (auth_totp)

totp_secretTotp Secretchar
calculé

ajouté par Two-Factor Authentication (TOTP) (auth_totp)

totp_trusted_device_idsAppareils de confianceone2many

inverse : user_id

ajouté par Two-Factor Authentication (TOTP) (auth_totp)

tour_enabledParcours d'intégrationboolean
calculé, stocké

ajouté par Visites (web_tour)

tuesday_location_idTuesday Locationmany2one

ajouté par Employés (hr)

tzFuseau horaireselection

related : partner_id.tz

tz_offsetDécalage horairechar
calculé
view_group_hierarchyChamp technique pour paramètre de groupe utilisateurjson
visa_expireVisa Expiredate

ajouté par Employés (hr)

websiteSite Webchar

related : partner_id.website

ajouté par Website profile (website_profile)

website_descriptionWebsite Descriptionhtml

related : partner_id.website_description

ajouté par Website profile (website_profile)

website_idSite Webmany2one

related : partner_id.website_id

ajouté par Site Web (website)

website_publishedWebsite Publishedboolean

related : partner_id.website_published

ajouté par Website profile (website_profile)

wednesday_location_idWednesday Locationmany2one

ajouté par Employés (hr)

work_contact_idContact de travailmany2one

ajouté par Employés (hr)

work_emailAdresse e-mail professionnellechar

ajouté par Employés (hr)

work_location_idLieu de travailmany2one

ajouté par Employés (hr)

work_location_nameNom du lieu de travailchar

related : employee_id.work_location_name

ajouté par Employés (hr)

work_location_typeType de lieu de travailselection

related : employee_id.work_location_type

ajouté par Employés (hr)

work_phoneTéléphone professionnelchar

ajouté par Employés (hr)

writable_calendar_idsWritable Calendarone2many
calculé

ajouté par Calendrier (calendar)

activity_calendar_event_idActivité suivante de l'événement du calendriermany2one
calculé

hérité de mail.activity.mixin

activity_date_deadlineDate limite de l'activité à venirdate
lecture seulecalculé

hérité de mail.activity.mixin

activity_exception_decorationIndicateur d’exception d’activité

Type d'activité d'exception enregistrée.

selection
calculé

Valeurs : warning (Alerte), danger (Erreur)

hérité de mail.activity.mixin

activity_exception_iconIcône

Icône pour indiquer une activité d'exception.

char
calculé

hérité de mail.activity.mixin

activity_idsActivitésone2many

inverse : res_id

hérité de mail.activity.mixin

activity_plans_idsPlans d'activitémany2many
calculé

hérité de mail.activity.mixin

activity_stateStatut de l'activité

Status based on activities Overdue: Due date is already passed Today: Activity date is today Planned: Future activities.

selection
calculé

Valeurs : overdue (En retard), today (Aujourd'hui), planned (Planifié)

hérité de mail.activity.mixin

activity_summaryRésumé de l'activité suivantechar

related : activity_ids.summary

hérité de mail.activity.mixin

activity_type_iconIcône de type d'activitéchar

related : activity_ids.icon

hérité de mail.activity.mixin

activity_type_idType d'activités à venirmany2one

related : activity_ids.activity_type_id

hérité de mail.activity.mixin

activity_user_idUtilisateur responsablemany2one
lecture seulecalculé

hérité de mail.activity.mixin

has_messageA un messageboolean
calculé

hérité de mail.thread

message_attachment_countNombre de pièces jointesinteger
calculé

hérité de mail.thread

message_follower_idsAbonnésone2many

inverse : res_id

hérité de mail.thread

message_has_errorErreur d'envoi du message

Si coché, certains messages ont une erreur de livraison.

boolean
calculé

hérité de mail.thread

message_has_error_counterNombre d'erreurs

Nombre de messages avec des erreurs d'envoi

integer
calculé

hérité de mail.thread

message_has_sms_errorErreur d'envoi SMS

Si coché, certains messages ont une erreur de livraison.

boolean
calculé

hérité de mail.thread

message_idsMessagesone2many

inverse : res_id

hérité de mail.thread

message_is_followerEst un abonnéboolean
calculé

hérité de mail.thread

message_needactionNécessite une action

Si coché, de nouveaux messages demandent votre attention.

boolean
calculé

hérité de mail.thread

message_needaction_counterNombre d'actions

Nombre de messages nécessitant une action

integer
calculé

hérité de mail.thread

message_partner_idsAbonnés (Partenaires)many2many
calculé

hérité de mail.thread

my_activity_date_deadlineÉchéance de mon activitédate
lecture seulecalculé

hérité de mail.activity.mixin

rating_idsÉvaluationsone2many

inverse : res_id

hérité de mail.thread

create_uidCréé parmany2one
lecture seuleautomatique
display_nameNom affichéchar
lecture seulecalculéautomatique
idIDinteger
lecture seuleautomatique
write_dateDernière mise à jour ledatetime
lecture seuleautomatique
write_uidDernière mise à jour parmany2one
lecture seuleautomatique

Relations

Modèles liés depuis ce modèle

Champs d'autres modèles qui pointent ici

Lire ce modèle par l'API

Exemple d'appel à l'API JSON-2 d'Odoo 20 : lecture des cinq premiers enregistrements avec des champs réels du modèle. Remplacez l'instance, la base et la clé API par les vôtres.

curl
curl -X POST "https://votre-instance.odoo.com/json/2/res.users/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: votre-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://votre-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "votre-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())
  • L'accès à l'API externe est réservé à la formule Custom d'Odoo.
  • XML-RPC et JSON-RPC seront retirés dans Odoo 22 (automne 2028) : préférez JSON-2.
  • Les droits d'accès et règles d'enregistrement de l'utilisateur de la clé s'appliquent.

Citer cet outil

Vous rédigez un tutoriel, une documentation interne ou une réponse sur un forum ? Copiez ce lien pour renvoyer vos lecteurs vers la fiche à jour.

<a href="https://aidoo.ai/fr/outils/explorateur-modeles-odoo/res-users">res.users (Odoo 20.0)</a>

Sources

Données vérifiées le 25 septembre 2026 · Odoo 20.0 Community

Vous avez un projet Odoo ou souhaitez exploiter votre ERP avec l'IA ? Échangeons

Intégration, développement de modules, connexion de Claude ou ChatGPT à vos données : décrivez-nous votre contexte, nous vous répondons sous 24 heures ouvrées.