Odoo 19.0 Community · Persistente

crm.lead: campos, relaciones y API

El modelo crm.lead («Lead») es un modelo persistente declarado por el módulo CRM y ampliado por 13 módulos más. Expone 134 campos, 95 de ellos declarados directamente en el modelo; 15 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.

Ver el código fuente Buscar otro modelo

Ficha de identidad

Nombre técnico: crm.lead
Etiqueta: Lead
Tipo: Persistente (models.Model)
Tabla SQL: crm_lead
Módulo de origen: CRM (crm)
Ampliado por: iap_crm, crm_iap_enrich, crm_iap_mine, crm_livechat, crm_mail_plugin, event_crm, sale_crm, mass_mailing_crm, survey_crm, website_crm, website_crm_iap_reveal, website_crm_livechat, website_crm_partner_assign
Orden por defecto (_order): priority desc, id desc
Hereda de (mixins): mail.thread.cc mail.thread.blacklist mail.thread.phone mail.activity.mixin utm.mixin format.address.mixin mail.tracking.duration.mixin

Campos del modelo

95 campos propios, 33 heredados de mixins y 6 campos automáticos del ORM. Haga clic en un nombre para obtener el enlace directo al campo.

Ocultar los campos heredados

134 de 134 campos mostrados

Nombre técnico	Etiqueta	Tipo	Detalles
active	Activo	`boolean`
automated_probability	Probabilidad automatizada	`float`	solo lecturacalculado, almacenado
calendar_event_ids	Reuniones	`one2many` → calendar.event	inverso: `opportunity_id`
campaign_id	Campaña	`many2one` → utm.campaign
city	Ciudad	`char`	calculado, almacenado
color	Índice de Colores	`integer`
commercial_partner_id	Empresa del cliente	`many2one` → res.partner	calculado
company_currency	Moneda	`many2one` → res.currency	calculado
company_id	Compañía	`many2one` → res.company	calculado, almacenado
contact_name	Nombre del contacto	`char`	calculado, almacenado
country_id	País	`many2one` → res.country	calculado, almacenado
date_automation_last	Última acción	`datetime`	solo lectura
date_closed	Fecha de cierre	`datetime`	solo lectura
date_conversion	Fecha de conversión	`datetime`	solo lectura
date_deadline	Cierre previsto Fecha estimada en la que la oportunidad será ganada.	`date`
date_last_stage_update	Última actualización de la etapa	`datetime`	solo lecturacalculado, almacenado
date_open	Fecha de asignación	`datetime`	solo lecturacalculado, almacenado
date_partner_assign	Fecha de asignación del socio Última fecha en la que este caso fue enviado/asignado a un partner	`date`	calculado, almacenado añadido por Distribuidores (`website_crm_partner_assign`)
day_close	Días para cerrar	`float`	calculado, almacenado
day_open	Dias para asignar	`float`	calculado, almacenado
description	Notas	`html`
duplicate_lead_count	Número de leads potencialmente duplicados	`integer`	calculado
duplicate_lead_ids	Lead potencialmente duplicado	`many2many` → crm.lead	calculado
email_domain_criterion	Critero de dominio de correo electrónico	`char`	calculado, almacenado
email_from	Correo electrónico	`char`	calculado, almacenado
email_normalized	Email Normalized	`char`
email_state	Calidad de correo electrónico	`selection`	calculado, almacenado Valores: `correct` (Correcto), `incorrect` (Incorrecto)
event_id	Evento de origen Eventos que activan la regla que creó este lead	`many2one` → event.event	añadido por Evento CRM (`event_crm`)
event_lead_rule_id	Regla de inscripción Norma que ha credo este lead	`many2one` → event.lead.rule	añadido por Evento CRM (`event_crm`)
expected_revenue	Ingresos esperados	`monetary`
function	Puesto de trabajo	`char`	calculado, almacenado
iap_enrich_done	Enriquecimiento hecho Si se ha enriquecido este lead usando el servicio de enriquecimiento de leads IAP basado en dirección de correo.	`boolean`	añadido por Enriquecimiento de leads (`crm_iap_enrich`)
is_automated_probability	¿La probabilidad es automatizada?	`boolean`	calculado
is_partner_visible	El partner es visible	`boolean`	calculado
lang_active_count	Número de idiomas activos	`integer`	calculado
lang_code	Lang Code	`char`	related: `lang_id.code`
lang_id	Idioma	`many2one` → res.lang	calculado, almacenado
lead_mining_request_id	Solicitud de minería de leads	`many2one` → crm.iap.lead.mining.request	añadido por Generación de leads (`crm_iap_mine`)
lead_properties	Propiedades	`properties`
lost_reason_id	Razón de pérdida	`many2one` → crm.lost.reason
medium_id	Medio	`many2one` → utm.medium
meeting_display_date	Mostrar fecha de la reunión	`date`	calculado
meeting_display_label	Mostrar etiqueta de la reunión	`char`	calculado
name	Oportunidad	`char`	obligatoriocalculado, almacenado
order_ids	Pedidos	`one2many` → sale.order	inverso: `opportunity_id` añadido por Oportunidad a presupuesto (`sale_crm`)
origin_channel_id	Chat en directo desde el que se ha creado el lead	`many2one` → discuss.channel	solo lectura añadido por Chat en directo CRM (`crm_livechat`)
origin_survey_id	Encuesta	`many2one` → survey.survey	añadido por Survey CRM (`survey_crm`)
partner_assigned_id	Partner asignado	`many2one` → res.partner	añadido por Distribuidores (`website_crm_partner_assign`)
partner_declined_ids	Socio no interesado	`many2many` → res.partner	añadido por Distribuidores (`website_crm_partner_assign`)
partner_email_update	Se actualizará el correo electrónico del contacto	`boolean`	calculado
partner_id	Contacto Contacto vinculado (opcional). Usualmente se crea al convertir el lead. Puede encontrar un contacto por su nombre, identificación fiscal, correo electrónico o referencia interna.	`many2one` → res.partner
partner_is_blacklisted	Contacto en la lista negra	`boolean`	solo lectura related: `partner_id.is_blacklisted`
partner_latitude	Latitud geográfica	`float`	añadido por Distribuidores (`website_crm_partner_assign`)
partner_longitude	Longitud geográfica	`float`	añadido por Distribuidores (`website_crm_partner_assign`)
partner_name	Nombre de la empresa El nombre de la empresa del futuro contacto será creada al convertir el lead en oportunidad.	`char`	calculado, almacenado
partner_phone_update	Se actualizará el teléfono del contacto	`boolean`	calculado
phone	Teléfono	`char`	calculado, almacenado
phone_sanitized	Phone Sanitized	`char`
phone_state	Calidad del número de teléfono	`selection`	calculado, almacenado Valores: `correct` (Correcto), `incorrect` (Incorrecto)
priority	Prioridad	`selection`	Valores: `0` (Baja), `1` (Medio), `2` (Alta), `3` (Muy alta)
probability	Probabilidad	`float`	calculado, almacenado
prorated_revenue	Ingresos prorrateados	`monetary`	calculado, almacenado
quotation_count	Número de presupuestos	`integer`	calculado añadido por Oportunidad a presupuesto (`sale_crm`)
recurring_plan	Plan recurrente	`many2one` → crm.recurring.plan
recurring_revenue	Ingresos recurrentes	`monetary`
recurring_revenue_monthly	MMR esperado	`monetary`	calculado, almacenado
recurring_revenue_monthly_prorated	MRR prorrateado	`monetary`	calculado, almacenado
recurring_revenue_prorated	Ingresos recurrentes prorrateados	`monetary`	calculado, almacenado
referred	Referido por	`char`
registration_count	N.° de inscripciones Número de inscripciones vinculadas a este lead	`integer`	calculado añadido por Evento CRM (`event_crm`)
registration_ids	Inscripciones de origen Inscripciones que activaron la regla que creó esta oportunidad	`many2many` → event.registration	añadido por Evento CRM (`event_crm`)
reveal_iap_credits	Créditos IAP	`integer`	añadido por Generación de leads desde las visitas a la página web (`website_crm_iap_reveal`)
reveal_id	Revelar ID	`char`	añadido por IAP / CRM (`iap_crm`)
reveal_ip	Dirección IP	`char`	añadido por Generación de leads desde las visitas a la página web (`website_crm_iap_reveal`)
reveal_rule_id	Regla de generación de leads	`many2one` → crm.reveal.rule	añadido por Generación de leads desde las visitas a la página web (`website_crm_iap_reveal`)
sale_amount_total	Suma de pedidos Importe base de los pedidos confirmados	`monetary`	calculado añadido por Oportunidad a presupuesto (`sale_crm`)
sale_order_count	Número de pedidos de venta	`integer`	calculado añadido por Oportunidad a presupuesto (`sale_crm`)
show_enrich_button	Permitir enriquecimiento manual	`boolean`	calculado añadido por Enriquecimiento de leads (`crm_iap_enrich`)
source_id	Origen	`many2one` → utm.source
stage_id	Etapa	`many2one` → crm.stage	calculado, almacenado
stage_id_color	Stage Color	`integer`	related: `stage_id.color`
state_id	Estado	`many2one` → res.country.state	calculado, almacenado
street	Calle	`char`	calculado, almacenado
street2	Calle2	`char`	calculado, almacenado
tag_ids	Etiquetas Clasifique y analice sus categorías de leads/oportunidades como: formación, servicio	`many2many` → crm.tag
team_id	Equipo de ventas	`many2one` → crm.team	calculado, almacenado
type	Tipo	`selection`	obligatorio Valores: `lead` (Lead), `opportunity` (Oportunidad)
user_company_ids	Compañía del usuario Experiencia del usuario: limitar a la empresa del lead o a todas si no hay empresa.	`many2many` → res.company	calculado
user_id	Comercial	`many2one` → res.users
visitor_ids	Visitantes de la web	`many2many` → website.visitor	añadido por Formulario de contacto (`website_crm`)
visitor_page_count	N.° de visitas a la página	`integer`	calculado añadido por Formulario de contacto (`website_crm`)
visitor_sessions_count	N.° de sesiones	`integer`	calculado añadido por Lead Sesiones en vivo (`website_crm_livechat`)
website	Sitio web Sitio web del contacto	`char`	calculado, almacenado
won_status	Ganado/Perdido	`selection`	calculado, almacenado Valores: `won` (Ganado), `lost` (Perdido), `pending` (Pendiente)
zip	C.P.	`char`	calculado, almacenado
activity_calendar_event_id	Siguiente evento en el calendario de actividades.	`many2one` → calendar.event	calculado heredado de mail.activity.mixin
activity_date_deadline	Fecha límite de la siguiente actividad	`date`	solo lecturacalculado heredado de mail.activity.mixin
activity_exception_decoration	Decoració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_icon	Icono Icono para indicar una actividad de excepción.	`char`	calculado heredado de mail.activity.mixin
activity_ids	Actividades	`one2many` → mail.activity	inverso: `res_id` heredado de mail.activity.mixin
activity_state	Estado 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_summary	Resumen de la siguiente actividad	`char`	related: `activity_ids.summary` heredado de mail.activity.mixin
activity_type_icon	Icono de tipo de actividad	`char`	related: `activity_ids.icon` heredado de mail.activity.mixin
activity_type_id	Tipo de la siguiente actividad	`many2one` → mail.activity.type	related: `activity_ids.activity_type_id` heredado de mail.activity.mixin
activity_user_id	Usuario responsable	`many2one` → res.users	solo lecturacalculado heredado de mail.activity.mixin
duration_tracking	Tiempo del estado JSON que mapea IDs de un campo many2one a segundos utilizados	`json`	calculado heredado de mail.tracking.duration.mixin
email_cc	CC del correo electrónico	`char`	heredado de mail.thread.cc
has_message	Tiene un mensaje	`boolean`	calculado heredado de mail.thread
is_blacklisted	Lista negra Si la dirección de correo electrónico está en la lista negra, el contacto ya no recibirá más envíos masivos desde ninguna lista	`boolean`	calculado heredado de mail.thread.blacklist
is_rotting	En espera/estancado	`boolean`	calculado heredado de mail.tracking.duration.mixin
message_attachment_count	Número de archivos adjuntos	`integer`	calculado heredado de mail.thread
message_bounce	Rebotado Contador del número de correos electrónicos rebotados de este contacto	`integer`	heredado de mail.thread.blacklist
message_follower_ids	Seguidores	`one2many` → mail.followers	inverso: `res_id` heredado de mail.thread
message_has_error	Error de envío de mensaje Si está marcada, algunos mensajes tienen error de envío.	`boolean`	calculado heredado de mail.thread
message_has_error_counter	Número de errores Número de mensajes con error de envío	`integer`	calculado heredado de mail.thread
message_has_sms_error	Error de envío del SMS Si está marcada, algunos mensajes tienen error de envío.	`boolean`	calculado heredado de mail.thread
message_ids	Mensajes	`one2many` → mail.message	inverso: `res_id` heredado de mail.thread
message_is_follower	Es un seguidor	`boolean`	calculado heredado de mail.thread
message_needaction	Acción requerida Si está marcada, hay nuevos mensajes que requieren su atención.	`boolean`	calculado heredado de mail.thread
message_needaction_counter	Número de acciones Número de mensajes que requieren una acción	`integer`	calculado heredado de mail.thread
message_partner_ids	Seguidores (Contactos)	`many2many` → res.partner	calculado heredado de mail.thread
my_activity_date_deadline	Fecha límite de mi actividad	`date`	solo lecturacalculado heredado de mail.activity.mixin
phone_blacklisted	El teléfono en la lista negra es un teléfono 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`	calculado heredado de mail.thread.phone
phone_mobile_search	Número de teléfono	`char`	heredado de mail.thread.phone
phone_sanitized_blacklisted	Teléfono en la lista negra Si el teléfono está en la lista negra, el contacto ya no recibirá correo masivo de sms de ninguna lista.	`boolean`	calculado heredado de mail.thread.phone
rating_ids	Calificaciones	`one2many` → rating.rating	inverso: `res_id` heredado de mail.thread
rotting_days	Días en espera Número de días desde la última actualización de este recurso	`integer`	calculado heredado de mail.tracking.duration.mixin
website_message_ids	Mensajes del sitio web Historial de comunicación del sitio web	`one2many` → mail.message	inverso: `res_id` heredado de mail.thread
create_date	Creado el	`datetime`	solo lecturaautomático
create_uid	Creado por	`many2one` → res.users	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` → res.users	solo lecturaautomático

Relaciones

Modelos enlazados desde este modelo

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
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: commercial_partner_id, partner_assigned_id, partner_declined_ids, partner_id
res.users: user_id
sale.order: order_ids
survey.survey: origin_survey_id
utm.campaign: campaign_id
utm.medium: medium_id
utm.source: source_id
website.visitor: visitor_ids

Campos de otros modelos que apuntan aquí

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: duplicated_lead_ids, lead_id
crm.lead2opportunity.partner.mass: lead_id, lead_tomerge_ids
crm.merge.opportunity: opportunity_ids
crm.quotation.partner: lead_id
event.registration: lead_ids
sale.order: opportunity_id
survey.user_input: lead_id
website.visitor: lead_ids

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

curl -X POST "https://su-instancia.odoo.com/json/2/crm.lead/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: su-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://su-instancia.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "su-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())

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/crm-lead">crm.lead (Odoo 19.0)</a>

Fuentes

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.

Contactarnos Ver una demo