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 145 champs, dont 140 déclarés directement sur le modèle ; 195 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 19.
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, 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
- Tri par défaut (_order)
name, login- Hérite de (mixins)
- bus.listener.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
140 champs propres, 0 hérités des mixins et 5 champs automatiques de l'ORM. Cliquez sur un nom pour obtenir le lien direct vers le champ.
145 champs affichés sur 145
| Nom technique | Libellé | Type | Détails |
|---|---|---|---|
| accesses_count | # Droits d'accès Nombre de droits d'accès qui s'appliquent à l'utilisateur actuel | integer | calculé |
| action_id | Action 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 | |
| active | Actif | boolean | |
| active_partner | Le partenaire est actif | boolean | lecture seule related : |
| additional_note | Note additionnelle | text | related : ajouté par Employés ( |
| all_group_ids | Groupes et groupes implicites | many2many | calculé |
| api_key_ids | Clés API | one2many | inverse : |
| auth_passkey_key_ids | Clé d'authentification | one2many | inverse : ajouté par Clés d'accès ( |
| badge_ids | Badges | one2many | inverse : ajouté par Ludification ( |
| bank_account_ids | Compte bancaire | many2many | related : ajouté par Employés ( |
| barcode | Code-barres | char | related : ajouté par Employés ( |
| bronze_badge | Nombre de badges bronze | integer | calculé ajouté par Ludification ( |
| calendar_default_privacy | Confidentialité par défaut du calendrier | selection | calculé Valeurs : ajouté par Calendrier ( |
| can_edit_role | Peut modifier le rôle | boolean | calculé ajouté par Discussion ( |
| category_ids | Étiquettes d'employé | many2many | related : ajouté par Employés ( |
| companies_count | Nombe de sociétés | integer | calculé |
| company_id | Société La société par défaut pour cet utilisateur. | many2one | requis |
| company_ids | Sociétés | many2many | |
| create_date | Date de création | datetime | lecture seule ajouté par Forum ( |
| create_employee | Champ technique, s'il faut créer un employé | boolean | ajouté par Employés ( |
| create_employee_id | Champ technique, lier l'utilisateur à cet employé lors de la création | many2one | ajouté par Employés ( |
| crm_team_ids | Équipes commerciales | many2many→ crm.team | lecture seulecalculé ajouté par Équipes commerciales ( |
| crm_team_member_ids | Membres de l'équipe commerciale | one2many | inverse : ajouté par Équipes commerciales ( |
| device_ids | Périphériques de l'utilisateur | one2many | inverse : |
char | related : | ||
| email_domain_placeholder | Placeholder de domaine e-mail | char | calculé |
| emergency_contact | Contact d’urgence | char | related : ajouté par Employés ( |
| emergency_phone | Numéro d’urgence | char | related : ajouté par Employés ( |
| employee_bank_account_ids | Comptes bancaires de l’employé | many2many | related : ajouté par Employés ( |
| employee_count | Nombre d'employés | integer | calculé ajouté par Employés ( |
| employee_id | Employé de la société | many2one | calculé ajouté par Employés ( |
| employee_ids | Employé associé | one2many | inverse : ajouté par Employés ( |
| employee_resource_calendar_id | Horaire de l'employé | many2one | lecture seule related : ajouté par Employés ( |
| employee_skill_ids | Employee Skill | one2many | related : ajouté par Projet - Compétences ( |
| favorite_lunch_product_ids | Produit de lunch favori | many2many | ajouté par Lunch ( |
| favorite_project_ids | Projets favoris | many2many | ajouté par Projet ( |
| friday_location_id | Vendredi | many2one | related : ajouté par Télétravail ( |
| goal_ids | Objectif | one2many | inverse : ajouté par Ludification RH ( |
| gold_badge | Nombre de badges d'or | integer | calculé ajouté par Ludification ( |
| google_calendar_cal_id | Google Calendar Cal | char | related : ajouté par Google Agenda ( |
| google_calendar_rtoken | Google Calendar Rtoken | char | related : ajouté par Google Agenda ( |
| google_calendar_sync_token | Google Calendar Sync Token | char | related : ajouté par Google Agenda ( |
| google_calendar_token | Google Calendar Token | char | related : ajouté par Google Agenda ( |
| google_calendar_token_validity | Google Calendar Token Validity | datetime | related : ajouté par Google Agenda ( |
| google_synchronization_stopped | Google Synchronization Stopped | boolean | related : ajouté par Google Agenda ( |
| group_ids | Groupes Groupes explicitement assignés à l’utilisateur | many2many | |
| groups_count | # Groupes Nombre de groupes qui s'appliquent à l'utilisateur actuel | integer | calculé |
| has_access_livechat | A accès au live chat | boolean | lecture seulecalculé ajouté par Live Chat ( |
| has_external_mail_server | A un serveur de messagerie externe | boolean | calculé ajouté par Discussion ( |
| has_oauth_access_token | Possède un jeton d'accès OAuth | boolean | calculé ajouté par Authentification OAuth2 ( |
| im_status | Statut IM | char | calculé ajouté par Discussion ( |
| is_hr_user | Est utilisateur RH | boolean | calculé ajouté par Employés ( |
| is_in_call | Est en appel | boolean | related : ajouté par Discussion ( |
| is_out_of_office | Absent | boolean | calculé ajouté par Discussion ( |
| is_system | Est lié au système | boolean | calculé ajouté par Employés ( |
| job_title | Titre du poste | char | related : ajouté par Employés ( |
| karma | Karma | integer | calculé, stocké ajouté par Ludification ( |
| karma_tracking_ids | Changements Karma | one2many | inverse : ajouté par Ludification ( |
| km_home_work | Km Home Work | integer | related : ajouté par Employés ( |
| last_lunch_location_id | Lieu du dernier lunch | many2one | ajouté par Lunch ( |
| leave_date_to | Date de fin du congé | date | related : ajouté par Congés ( |
| livechat_channel_ids | Canal de Live Chat | many2many | ajouté par Live Chat ( |
| livechat_expertise_ids | Expertise 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 ( |
| livechat_is_in_call | Live 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 ( |
| livechat_lang_ids | Langues du live chat | many2many→ res.lang | calculé ajouté par Live Chat ( |
| livechat_ongoing_session_count | Nombre de sessions en cours | integer | calculé ajouté par Live Chat ( |
| livechat_username | Nom d'utilisateur Live Chat | char | calculé ajouté par Live Chat ( |
| log_ids | Entrées du journal utilisateur | one2many | inverse : |
| login | Se connecter Utilisé pour se connecter au système | char | requis |
| login_date | Dernière connexion | datetime | related : |
| manual_im_status | Statut de messagerie instantanée défini manuellement par l’utilisateur | selection | Valeurs : ajouté par Discussion ( |
| microsoft_calendar_rtoken | Actualiser le jeton Microsoft | char | ajouté par Utilisateurs Microsoft ( |
| microsoft_calendar_sync_token | Microsoft Calendar Sync Token | char | related : ajouté par Calendrier Outlook ( |
| microsoft_calendar_token | Jeton d'utilisateur Microsoft | char | ajouté par Utilisateurs Microsoft ( |
| microsoft_calendar_token_validity | Validité du jeton Microsoft | datetime | ajouté par Utilisateurs Microsoft ( |
| microsoft_last_sync_date | Microsoft Last Sync Date | datetime | related : ajouté par Calendrier Outlook ( |
| microsoft_synchronization_stopped | Microsoft Synchronization Stopped | boolean | related : ajouté par Calendrier Outlook ( |
| mobile_phone | Téléphone mobile | char | related : ajouté par Employés ( |
| monday_location_id | Lundi | many2one | related : ajouté par Télétravail ( |
| name | Nom | char | related : |
| new_password | Dé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_id | Prochain rang | many2one | ajouté par Ludification ( |
| notification_type | Notifications 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 | requiscalculé, stocké Valeurs : ajouté par Discussion ( |
| oauth_access_token | Stockage du jeton d'accès OAuth | char | lecture seule ajouté par Authentification OAuth2 ( |
| oauth_provider_id | Fournisseur OAuth | many2one | ajouté par Authentification OAuth2 ( |
| oauth_uid | ID utilisateur OAuth user_id du fournisseur OAuth | char | ajouté par Authentification OAuth2 ( |
| odoobot_failed | Échec de l'Odoobot | boolean | lecture seule ajouté par OdooBot ( |
| odoobot_state | Statut OdooBot | selection | lecture seule Valeurs : ajouté par OdooBot ( |
| out_of_office_from | Absent à partir du | datetime | ajouté par Discussion ( |
| out_of_office_message | Répondeur d’absence | html | ajouté par Discussion ( |
| out_of_office_to | Absent jusqu’au | datetime | ajouté par Discussion ( |
| outgoing_mail_server_id | Serveur de messagerie sortant | many2one | calculé ajouté par Discussion ( |
| outgoing_mail_server_type | Type de serveur de messagerie sortant | selection | requiscalculé Valeurs : ajouté par Discussion ( |
| partner_id | Partenaire associé Données relatives aux partenaires de l'utilisateur | many2one | requis |
| password | Mot de passe Laissez vide si vous ne souhaitez pas que l'utilisateur puisse se connecter au système | char | calculé |
| phone | Téléphone | char | related : |
| pin | Épingler | char | related : ajouté par Employés ( |
| presence_ids | Présences | one2many | inverse : ajouté par Discussion ( |
| private_city | Ville privé | char | related : ajouté par Employés ( |
| private_country_id | Pays privé | many2one | related : ajouté par Employés ( |
| private_email | Adresse e-mail privée | char | related : ajouté par Employés ( |
| private_phone | Numéro de téléphone privé | char | related : ajouté par Employés ( |
| private_state_id | Etat privé | many2one | related : ajouté par Employés ( |
| private_street | Rue privée | char | related : ajouté par Employés ( |
| private_street2 | Rue2 privée | char | related : ajouté par Employés ( |
| private_zip | Code postal privé | char | related : ajouté par Employés ( |
| property_warehouse_id | Entrepôt par défaut | many2one | dépend de la société ajouté par Gestion des ventes et des entrepôts ( |
| rank_id | Rang | many2one | ajouté par Ludification ( |
| res_users_settings_id | Paramètres | many2one | calculé |
| res_users_settings_ids | Paramètres res utilisateurs | one2many | inverse : |
| resource_calendar_id | Heures de travail par défaut | many2one | related : ajouté par Ressource ( |
| resource_ids | Ressources | one2many | inverse : ajouté par Ressource ( |
| role | Rôle | selection | calculé Valeurs : |
| role_ids | Rôles utilisateurs Les utilisateurs sont notifiés chaque fois que l’un de leurs rôles est mentionné avec @ dans une conversation. | many2many→ res.role | ajouté par Discussion ( |
| rules_count | # Règles d'enregistrement Nombre de règles d'enregistrement qui s'appliquent à l'utilisateur actuel | integer | calculé |
| 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→ crm.team | lecture seulecalculé, stocké ajouté par Équipes commerciales ( |
| saturday_location_id | Samedi | many2one | related : ajouté par Télétravail ( |
| share | Partager l'utilisateur Utilisateur externe possédant un accès limité, créé uniquement dans le but de partager des données. | boolean | calculé, stocké |
| signature | Signature e-mail | html | calculé, stocké |
| silver_badge | Nombre des badges d'argent | integer | calculé ajouté par Ludification ( |
| state | Statut | selection | calculé Valeurs : ajouté par Inscription ( |
| sunday_location_id | Dimanche | many2one | related : ajouté par Télétravail ( |
| thursday_location_id | Jeudi | many2one | related : ajouté par Télétravail ( |
| totp_enabled | Authentification à deux facteurs | boolean | calculé ajouté par Authentification à deux facteurs (TOTP) ( |
| totp_last_counter | Dernier compteur TOPT | integer | ajouté par Authentification à deux facteurs (TOTP) ( |
| totp_secret | Totp Secret | char | calculé ajouté par Authentification à deux facteurs (TOTP) ( |
| totp_trusted_device_ids | Appareils de confiance | one2many | inverse : ajouté par Authentification à deux facteurs (TOTP) ( |
| tour_enabled | Parcours d'intégration | boolean | calculé, stocké ajouté par Visites ( |
| tuesday_location_id | Mardi | many2one | related : ajouté par Télétravail ( |
| tz_offset | Décalage horaire | char | calculé |
| view_group_hierarchy | Champ technique pour paramètre de groupe utilisateur | json | |
| visa_expire | Visa Expire | date | related : ajouté par Employés ( |
| website_id | Site Web | many2one→ website | related : ajouté par Site Web ( |
| wednesday_location_id | Mercredi | many2one | related : ajouté par Télétravail ( |
| work_contact_id | Contact de travail | many2one | related : ajouté par Employés ( |
| work_email | Adresse e-mail professionnelle | char | related : ajouté par Employés ( |
| work_location_id | Lieu de travail | many2one | related : ajouté par Employés ( |
| work_location_name | Nom du lieu de travail | char | related : ajouté par Employés ( |
| work_location_type | Type de lieu de travail | selection | related : ajouté par Employés ( |
| work_phone | Téléphone professionnel | char | related : ajouté par Employés ( |
| create_uid | Créé par | many2one | lecture seuleautomatique |
| display_name | Nom affiché | char | lecture seulecalculéautomatique |
| id | ID | integer | lecture seuleautomatique |
| write_date | Dernière mise à jour le | datetime | lecture seuleautomatique |
| write_uid | Dernière mise à jour par | many2one | lecture seuleautomatique |
Relations
Modèles liés depuis ce modèle
- 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
Champs d'autres modèles qui pointent ici
- 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
- et 111 autres
Lire ce modèle par l'API
Exemple d'appel à l'API JSON-2 d'Odoo 19 : 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 -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}'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 19.0)</a>Sources
- Code source du modèle sur GitHub
- Documentation Odoo 19 : ORM API
- Documentation Odoo 19 : API externe JSON-2
Données vérifiées le 23 septembre 2026 · Odoo 19.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.