Odoo 20.0 Community · Persistant

crm.lead : champs, relations et API

Le modèle crm.lead (« Piste ») est un modèle persistant déclaré par le module CRM, puis enrichi par 12 autres modules. Il expose 134 champs, dont 94 déclarés directement sur le modèle ; 15 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.

Voir le code source Rechercher un autre modèle

Fiche d'identité

Nom technique: crm.lead
Libellé: Piste
Type: Persistant (models.Model)
Table SQL: crm_lead
Module d'origine: CRM (crm)
Étendu par: iap_crm, crm_iap_enrich, crm_iap_mine, crm_livechat, crm_sale_project, event_crm, sale_crm, mass_mailing_crm, website_crm, website_crm_iap_reveal, website_crm_livechat, website_crm_partner_assign
Tri par défaut (_order): priority desc, id desc
Hérite de (mixins): mail.thread.subject.suggested mail.thread.blacklist mail.thread.phone mail.activity.mixin utm.mixin format.address.mixin mail.tracking.duration.mixin

Champs du modèle

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

Masquer les champs hérités

134 champs affichés sur 134

Nom technique	Libellé	Type	Détails
active	Actif	`boolean`
automated_probability	Probabilité automatisée	`float`	lecture seulecalculé, stocké
calendar_event_ids	Réunions	`one2many` → calendar.event	inverse : `opportunity_id`
campaign_id	Campagne	`many2one` → utm.campaign
city	Ville	`char`	calculé, stocké
color	Couleur	`integer`
company_currency	Devise	`many2one` → res.currency	calculé
company_id	Société	`many2one` → res.company	calculé, stocké
contact_name	Nom du contact	`char`	calculé, stocké
country_id	Pays	`many2one` → res.country	calculé, stocké
date_automation_last	Dernière action	`datetime`	lecture seule
date_closed	Date de clôture	`datetime`	lecture seule
date_conversion	Date de conversion	`datetime`	lecture seule
date_deadline	Date de clôture prévue Estimation de la date à laquelle l'opportunité sera gagnée.	`date`
date_last_stage_update	Dernière mise à jour de l'étape	`datetime`	lecture seulecalculé, stocké
date_open	Date d'attribution	`datetime`	lecture seulecalculé, stocké
date_partner_assign	Date d'assignation du partenaire Dernière date à laquelle ce cas a été transmis/assigné à un partenaire	`date`	calculé, stocké ajouté par Revendeurs (`website_crm_partner_assign`)
day_close	Jours pour clôturer	`float`	calculé, stocké
day_open	Jours pour assigner	`float`	calculé, stocké
description	Notes	`html`
duplicate_lead_count	Nombre de pistes potentiellement dupliquées	`integer`	calculé
duplicate_lead_ids	Piste potentiellement dupliquée	`many2many` → crm.lead	calculé
email_domain_criterion	Critère du domaine de l'e-mail	`char`	calculé, stocké
email_from	E-mail	`char`	calculé, stocké
email_normalized	Email Normalized	`char`
email_state	Qualité de l'e-mail	`selection`	calculé, stocké Valeurs : `correct` (Bonne réponse), `incorrect` (Mauvaise réponse)
event_id	Evénement source Événement générant la règle qui a créé cette piste	`many2one` → event.event	ajouté par Event CRM (`event_crm`)
event_lead_rule_id	Règle d'inscription Règle qui a créé cette piste	`many2one` → event.lead.rule	ajouté par Event CRM (`event_crm`)
expected_revenue	Revenu attendu	`monetary`
function	Poste	`char`	calculé, stocké
iap_enrich_done	Enrichissement effectué Si le service IAP pour l'enrichissement des pistes à partir de l'e-mail a été effectué pour cette piste.	`boolean`	ajouté par Enrichissement de pistes (`crm_iap_enrich`)
is_automated_probability	Est une probabilité automatisée ?	`boolean`	calculé
lang_active_count	Nombre de langues actives	`integer`	calculé
lang_code	Lang Code	`char`	related : `lang_id.code`
lang_id	Langue	`many2one` → res.lang	calculé, stocké
lead_mining_request_id	Demande de prospection de pistes	`many2one` → crm.iap.lead.mining.request	ajouté par Génération de pistes (`crm_iap_mine`)
lead_properties	Propriétés	`properties`
lost_reason_id	Motif de perte	`many2one` → crm.lost.reason
medium_id	Médium	`many2one` → utm.medium
meeting_display_date	Date d'affichage de la réunion	`date`	calculé
meeting_display_label	Étiquette d'affichage de la réunion	`char`	calculé
name	Opportunité	`char`	requiscalculé, stocké
order_ids	Commandes	`one2many` → sale.order	inverse : `opportunity_id` ajouté par Opportunity to Quotation (`sale_crm`)
origin_channel_id	Live Chat à l'origine de la création de la piste	`many2one` → discuss.channel	lecture seule ajouté par CRM Livechat (`crm_livechat`)
partner_assigned_id	Partenaire assigné	`many2one` → res.partner	ajouté par Revendeurs (`website_crm_partner_assign`)
partner_declined_ids	Partenaire pas intéressé	`many2many` → res.partner	ajouté par Revendeurs (`website_crm_partner_assign`)
partner_email_update	L'e-mail du partenaire sera mis à jour	`boolean`	calculé
partner_id	Contact Partenaire lié (optionnel). Généralement créé en convertissant la piste. Vous pouvez trouver un partenaire par son Nom, TIN, e-mail ou Référence Interne.	`many2one` → res.partner
partner_is_blacklisted	Le partenaire est sur liste noire	`boolean`	lecture seule related : `partner_id.is_blacklisted`
partner_latitude	Latitude	`float`	ajouté par Revendeurs (`website_crm_partner_assign`)
partner_longitude	Longitude	`float`	ajouté par Revendeurs (`website_crm_partner_assign`)
partner_name	Nom de la société Le nom de la future société partenaire qui sera créée quand la piste sera convertie en opportunité	`char`	calculé, stocké
partner_phone_update	Le numéro de téléphone du partenaire sera mis à jour	`boolean`	calculé
phone	Téléphone	`char`	calculé, stocké
phone_sanitized	Phone Sanitized	`char`
phone_state	Qualité du téléphone	`selection`	calculé, stocké Valeurs : `correct` (Bonne réponse), `incorrect` (Mauvaise réponse)
priority	Priorité	`selection`	Valeurs : `0` (Basse), `1` (Médium), `2` (Haute), `3` (Très élevé)
probability	Probabilité	`float`	calculé, stocké
project_count	Project Count	`integer`	calculé ajouté par CRM - Project (`crm_sale_project`)
project_ids	Projet	`one2many` → project.project	inverse : `lead_id` ajouté par CRM - Project (`crm_sale_project`)
prorated_revenue	Revenu au prorata	`monetary`	calculé, stocké
quotation_count	Nombre de devis	`integer`	calculé ajouté par Opportunity to Quotation (`sale_crm`)
recurring_plan	Récurrence	`many2one` → crm.recurring.plan
recurring_revenue	Revenus récurrents	`monetary`
recurring_revenue_monthly	MRR attendu	`monetary`	calculé, stocké
recurring_revenue_monthly_prorated	MRR au prorata	`monetary`	calculé, stocké
recurring_revenue_prorated	Revenus récurrents proratisés	`monetary`	calculé, stocké
referred	Recommandé par	`char`
registration_count	# Inscriptions Compteur pour les enregistrements liés à cette piste	`integer`	calculé ajouté par Event CRM (`event_crm`)
registration_ids	Inscription source Les inscriptions déclenchent la règle qui a créé cette piste	`many2many` → event.registration	ajouté par Event CRM (`event_crm`)
reveal_iap_credits	Crédits IAP	`integer`	ajouté par Lead Generation From Website Visits (`website_crm_iap_reveal`)
reveal_id	Afficher l'identifiant	`char`	ajouté par IAP / CRM (`iap_crm`)
reveal_ip	Adresse IP	`char`	ajouté par Lead Generation From Website Visits (`website_crm_iap_reveal`)
reveal_rule_id	Règle de génération de pistes	`many2one` → crm.reveal.rule	ajouté par Lead Generation From Website Visits (`website_crm_iap_reveal`)
sale_amount_total	Total des commandes Total of Confirmed Orders	`monetary`	calculé ajouté par Opportunity to Quotation (`sale_crm`)
sale_order_count	Nombre de commandes clients	`integer`	calculé ajouté par Opportunity to Quotation (`sale_crm`)
show_enrich_button	Autoriser l'enrichissement manuel	`boolean`	calculé ajouté par Enrichissement de pistes (`crm_iap_enrich`)
source_id	Source	`many2one` → utm.source
stage_id	Étape	`many2one` → crm.stage	calculé, stocké
state_id	Statut	`many2one` → res.country.state	calculé, stocké
street	Rue	`char`	calculé, stocké
street2	Rue 2	`char`	calculé, stocké
tag_ids	Étiquettes Classez et analysez vos catégories de pistes/opportunités. Exemples : Formation, Service	`many2many` → crm.tag
task_count	Task Count	`integer`	calculé ajouté par CRM - Project (`crm_sale_project`)
team_id	Équipe commerciale	`many2one` → crm.team	calculé, stocké
type	Type	`selection`	requis Valeurs : `lead` (Piste), `opportunity` (Opportunité)
user_company_ids	Entreprise utilisatrice UX : Limiter à la société principale ou à tous si aucune entreprise	`many2many` → res.company	calculé
user_id	Vendeur	`many2one` → res.users
visitor_ids	Visiteurs web	`many2many` → website.visitor	ajouté par Contact Form (`website_crm`)
visitor_page_count	# Pages Vues	`integer`	calculé ajouté par Contact Form (`website_crm`)
visitor_sessions_count	# Sessions	`integer`	calculé ajouté par Lead Livechat Sessions (`website_crm_livechat`)
website	Site Web Site web du contact	`char`	calculé, stocké
won_status	Gagnée/Perdue	`selection`	calculé, stocké Valeurs : `won` (Gagné), `lost` (Perdu), `pending` (En attente)
zip	Code postal	`char`	calculé, stocké
activity_calendar_event_id	Activité suivante de l'événement du calendrier	`many2one` → calendar.event	calculé hérité de mail.activity.mixin
activity_date_deadline	Date limite de l'activité à venir	`date`	lecture seulecalculé hérité de mail.activity.mixin
activity_exception_decoration	Indicateur 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_icon	Icône Icône pour indiquer une activité d'exception.	`char`	calculé hérité de mail.activity.mixin
activity_ids	Activités	`one2many` → mail.activity	inverse : `res_id` hérité de mail.activity.mixin
activity_plans_ids	Plans d'activité	`many2many` → mail.activity.plan	calculé hérité de mail.activity.mixin
activity_state	Statut 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_summary	Résumé de l'activité suivante	`char`	related : `activity_ids.summary` hérité de mail.activity.mixin
activity_type_icon	Icône de type d'activité	`char`	related : `activity_ids.icon` hérité de mail.activity.mixin
activity_type_id	Type d'activités à venir	`many2one` → mail.activity.type	related : `activity_ids.activity_type_id` hérité de mail.activity.mixin
activity_user_id	Utilisateur responsable	`many2one` → res.users	lecture seulecalculé hérité de mail.activity.mixin
duration_tracking	Durée du statut JSON qui associe les identifiants d'un champ many2one aux secondes passées	`json`	calculé, stocké hérité de mail.tracking.duration.mixin
has_message	A un message	`boolean`	calculé hérité de mail.thread
is_blacklisted	Liste noire Si l'adresse e-mail est sur liste noire, le contact ne recevra plus de massmail d'aucune liste	`boolean`	calculé hérité de mail.thread.blacklist
is_rotting	Inactivité	`boolean`	calculé hérité de mail.tracking.duration.mixin
message_attachment_count	Nombre de pièces jointes	`integer`	calculé hérité de mail.thread
message_bounce	Rebond Le compteur du nombre de mails rebondis pour ce contact	`integer`	hérité de mail.thread.blacklist
message_follower_ids	Abonnés	`one2many` → mail.followers	inverse : `res_id` hérité de mail.thread
message_has_error	Erreur d'envoi du message Si coché, certains messages ont une erreur de livraison.	`boolean`	calculé hérité de mail.thread
message_has_error_counter	Nombre d'erreurs Nombre de messages avec des erreurs d'envoi	`integer`	calculé hérité de mail.thread
message_has_sms_error	Erreur d'envoi SMS Si coché, certains messages ont une erreur de livraison.	`boolean`	calculé hérité de mail.thread
message_ids	Messages	`one2many` → mail.message	inverse : `res_id` hérité de mail.thread
message_is_follower	Est un abonné	`boolean`	calculé hérité de mail.thread
message_needaction	Nécessite une action Si coché, de nouveaux messages demandent votre attention.	`boolean`	calculé hérité de mail.thread
message_needaction_counter	Nombre d'actions Nombre de messages nécessitant une action	`integer`	calculé hérité de mail.thread
message_partner_ids	Abonnés (Partenaires)	`many2many` → res.partner	calculé hérité de mail.thread
my_activity_date_deadline	Échéance de mon activité	`date`	lecture seulecalculé hérité de mail.activity.mixin
phone_blacklisted	Le téléphone sur liste noire est fixe Indicates if a blacklisted sanitized phone number is a phone number. Helps distinguish which number is blacklisted when there is both a mobile and phone field in a model.	`boolean`	calculé hérité de mail.thread.phone
phone_formatted	Formatted Number	`char`	calculé hérité de mail.thread.phone
phone_mobile_search	Numéro de téléphone	`char`	hérité de mail.thread.phone
phone_sanitized_blacklisted	Téléphone sur liste noire Si le numéro de téléphone nettoyé est sur liste noire, le contact ne recevra plus de campagnes de mail, d'aucunes listes.	`boolean`	calculé hérité de mail.thread.phone
rating_ids	Évaluations	`one2many` → rating.rating	inverse : `res_id` hérité de mail.thread
rotting_days	Jours d’inactivité Nombre de jours depuis la dernière mise à jour de cette ressource	`integer`	calculé hérité de mail.tracking.duration.mixin
utm_reference	Référence UTM	`reference`	hérité de utm.mixin
create_date	Créé le	`datetime`	lecture seuleautomatique
create_uid	Créé par	`many2one` → res.users	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` → res.users	lecture seuleautomatique

Relations

Modèles liés depuis ce modèle

calendar.event : calendar_event_ids
crm.iap.lead.mining.request : lead_mining_request_id
crm.lead : duplicate_lead_ids
crm.lost.reason : lost_reason_id
crm.recurring.plan : recurring_plan
crm.reveal.rule : reveal_rule_id
crm.stage : stage_id
crm.tag : tag_ids
crm.team : team_id
discuss.channel : origin_channel_id
event.event : event_id
event.lead.rule : event_lead_rule_id
event.registration : registration_ids
project.project : project_ids
res.company : company_id, user_company_ids
res.country : country_id
res.country.state : state_id
res.currency : company_currency
res.lang : lang_id
res.partner : partner_assigned_id, partner_declined_ids, partner_id
res.users : user_id
sale.order : order_ids
utm.campaign : campaign_id
utm.medium : medium_id
utm.source : source_id
website.visitor : visitor_ids

Champs d'autres modèles qui pointent ici

calendar.event : opportunity_id
crm.activity.report : lead_id
crm.lead : duplicate_lead_ids
crm.lead.assignation : lead_id
crm.lead.lost : lead_ids
crm.lead2opportunity.partner.mass : duplicated_lead_ids, duplicated_lead_ids_domain, lead_tomerge_ids
crm.merge.opportunity : opportunity_ids
crm.quotation.partner : lead_id
event.registration : lead_ids
project.project : lead_id
sale.order : opportunity_id
survey.user_input : lead_id
website.visitor : lead_ids

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/crm.lead/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: votre-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","type","campaign_id","company_id","country_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}/crm.lead/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","type","campaign_id","company_id","country_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/crm-lead">crm.lead (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.

Nous contacter Voir une démo