Introduction
En Odoo, los modelos definen cómo se estructura y almacena la información en la base de datos. Cada pieza de datos comerciales con la que trabajas, desde pedidos de venta hasta facturas y oportunidades, reside en un modelo.
Entender los modelos de Odoo es esencial tanto para desarrolladores como para consultores funcionales. Los modelos son la base de la arquitectura de datos de Odoo. Definen los campos de Odoo, las relaciones y la lógica empresarial.
Este artículo se centra en el modelo crm.lead. Este modelo impulsa el embudo de ventas en Odoo CRM. Ya sea que estés construyendo módulos personalizados, integrando sistemas externos o configurando flujos de trabajo de ventas, trabajarás con este modelo.
What is the crm.lead Model
El modelo crm.lead representa leads y oportunidades en Odoo. Es el lugar central donde se almacenan los datos del pipeline de ventas. Un solo modelo en Odoo maneja tanto leads en etapas tempranas como oportunidades calificadas.
Este modelo es utilizado por el módulo de CRM. Los módulos de ventas, marketing y sitio web lo extienden o hacen referencia a él. Cuando un visitante completa un formulario en su sitio web, cuando un vendedor crea una oportunidad o cuando un lead se convierte en cliente, está trabajando con crm.lead.
El modelo utiliza la herencia de modelos de Odoo para agregar funcionalidad. El módulo base de CRM define la estructura central. Otros módulos como crm_iap_lead_enrich o website_crm añaden campos y comportamiento. Cada módulo extiende lo que necesita sin duplicar el núcleo.
Key Fields in the Model
Aquí están los campos más importantes de Odoo en el modelo crm.lead. Comprender estos ayudará a trabajar de manera efectiva con leads y oportunidades.
1. nombre
Tipo: Char. Este campo almacena el nombre o título del lead o la oportunidad. Es el identificador principal que se muestra en las vistas de lista y kanban. Para un lead, podría ser "Consulta desde el sitio web." Para una oportunidad, podría ser "Acuerdo empresarial - Acme Corp."
2. nombre_contacto
Tipo: Char. El nombre de la persona de contacto. Se utiliza cuando el lead aún no está vinculado a un res.partner. Cuando convierte un lead, este valor a menudo se copia al nuevo registro de socio.
3. email_de
Tipo: Char. La dirección de correo electrónico principal del lead. Odoo utiliza esto para las comunicaciones antes de la conversión. Es la principal forma de identificar y desduplicar leads.
4. teléfono
Tipo: Char. El número de teléfono principal. Se muestra en el formulario del lead y se utiliza para el registro de llamadas y actividades de seguimiento.
5. móvil
Tipo: Char. Número de teléfono móvil. A menudo se utiliza para SMS o seguimiento urgente cuando es diferente del teléfono principal.
6. partner_id
Tipo: Many2one (res.partner). Se vincula al contacto o empresa cuando el lead está calificado o convertido. Antes de la conversión, este campo está vacío. Después de la conversión, se vincula al socio creado o coincidente.
7. user_id
Tipo: Many2one (res.users). El vendedor responsable del lead. Se utiliza para la asignación, informes y programación de actividades. Impulsa los paneles de "Mis Oportunidades" y del equipo.
8. team_id
Tipo: Many2one (crm.team). El equipo de ventas. Organiza los leads por equipo para la asignación rotativa y la elaboración de informes basada en el equipo.
9. stage_id
Tipo: Many2one (crm.stage). La etapa actual en el embudo. Las etapas definen el embudo: Nuevo, Calificado, Propuesta, Negociación, Ganado, Perdido. Moverse entre etapas impulsa la automatización y los informes.
10. tipo
Tipo: Selección. Indica si el registro es un Lead o una Oportunidad. Los Leads están en una etapa temprana. Las Oportunidades están calificadas y tienen ingresos esperados. El tipo afecta qué vistas y etapas están disponibles.
11. ingresos_esperados
Tipo: Flotante. Los ingresos esperados si la oportunidad se gana. Se utiliza para informes de valor de pipeline y pronósticos. A menudo se calcula a partir de la probabilidad y un monto de trato.
12. probabilidad
Tipo: Flotante. La probabilidad de ganar como un porcentaje (0 a 100). Se utiliza en cálculos de pipeline ponderados. Puede ser manual o automatizada según la etapa.
13. company_id
Tipo: Many2one (res.company). En configuraciones de múltiples empresas, esto indica a qué empresa de Odoo pertenece el lead. Afecta la visibilidad de los registros y la moneda.
14. descripción
Tipo: Texto. Notas y descripción del lead u oportunidad. Se utiliza para notas internas, resúmenes de reuniones y contexto que los vendedores necesitan al hacer seguimiento.
15. fecha_creación
Tipo: Fecha y hora. Almacena la fecha y hora en que se creó el registro. Gestionado automáticamente por Odoo. Útil para informes de antigüedad de leads y análisis de tiempo de conversión.
16. fecha_modificación
Tipo: Fecha y hora. Almacena la fecha y hora de la última modificación. También gestionado automáticamente. Ayuda a rastrear cuándo se actualizó por última vez el lead.
17. date_open
Tipo: Fecha y hora. Cuando el lead fue asignado por primera vez a un usuario. Se establece cuando se completa user_id. Se utiliza para medir el tiempo hasta el primer contacto y la velocidad de asignación.
18. date_closed
Tipo: Fecha y hora. Cuando el lead fue cerrado (ganado o perdido). Se establece cuando la etapa pasa a una etapa cerrada. Se utiliza para el análisis de conversión y la duración del ciclo de ventas.
19. date_deadline
Tipo: Fecha. La fecha de cierre esperada. Se utiliza para pronósticos y planificación de actividades. Los vendedores establecen esto para rastrear cuándo esperan cerrar el trato.
20. active
Tipo: Booleano. Indicador de eliminación suave. Cuando es Falso, el registro se archiva y se oculta de las vistas predeterminadas. Los leads perdidos o fusionados a menudo se archivan en lugar de eliminarse.
21. street, street2, city, zip
Tipo: Carácter. Campos de dirección. Se utilizan cuando el lead tiene una dirección antes de la conversión. Se copian al socio cuando el lead se convierte.
22. country_id
Tipo: Many2one (res.country). El país. Se utiliza para informes regionales y formateo de direcciones. Filtrar leads por país ayuda con la gestión de territorios.
23. state_id
Tipo: Many2one (res.country.state). El estado o provincia. El dominio se filtra por país. Se utiliza para la segmentación regional.
24. source_id
Tipo: Many2one (utm.source). La fuente del lead. Rastrear de dónde proviene el lead: Sitio web, Referencia, Campaña, etc. Importante para la atribución de marketing.
25. campaign_id
Tipo: Many2one (utm.campaign). La campaña de marketing. Vincula el lead a una campaña específica para el análisis de ROI. Se utiliza cuando los leads provienen de campañas de correo electrónico o anuncios.
26. activity_ids
Tipo: One2many (mail.activity). Las actividades programadas. Tareas, llamadas y reuniones vinculadas al lead. Impulsa el widget de actividad y los recordatorios de seguimiento.
27. color
Tipo: Integer. Índice de color para vistas kanban y de lista. Se utiliza para distinguir visualmente los leads por prioridad, fuente o criterios personalizados.
28. message_ids
Tipo: One2many (mail.message). El chatter. Notas internas, correos electrónicos e historial de actividades. Odoo almacena toda la comunicación en el chatter para un contexto completo.
Cómo se utiliza este modelo en los flujos de trabajo empresariales
1. Captura de Leads en el Sitio Web
Cuando un visitante envía un formulario de contacto en su sitio web de Odoo, se crea un nuevo registro crm.lead. El email_from, contact_name y description se completan a partir del formulario. El lead aparece en el pipeline de CRM para que el equipo de ventas lo siga.
2. Calificación y Conversión de Leads
Los vendedores mueven los leads a través de las etapas. Cuando un lead es calificado, cambian el tipo a Oportunidad y establecen expected_revenue. Cuando se gana el trato, convierten el lead. Odoo crea o vincula un res.partner y opcionalmente una sale.order.
3. Informes del Pipeline de Ventas
Los gerentes utilizan los datos de crm.lead para informes de pipeline. Los ingresos esperados, la probabilidad y la etapa impulsan el valor ponderado del pipeline. Los filtros por user_id y team_id muestran el rendimiento por vendedor y equipo.
4. Atribución de Marketing
Los campos source_id y campaign_id vinculan los leads a los esfuerzos de marketing. Cuando los leads provienen de campañas de correo electrónico o anuncios, los parámetros UTM completan estos campos. Los equipos de marketing utilizan esto para medir la efectividad de la campaña.
5. Gestión de Actividades y Seguimiento
Los vendedores programan actividades en los leads. El campo activity_ids almacena llamadas, reuniones y tareas. La activity_date_deadline impulsa la columna "Próxima Actividad" en las vistas de lista y recuerda a los usuarios que deben hacer seguimiento.
Cómo los desarrolladores amplían este modelo
Los desarrolladores extienden crm.lead utilizando varios patrones. La herencia de modelos de Odoo es el principal mecanismo.
Herencia de Modelos
Utiliza _inherit = 'crm.lead' para extender el modelo. Agrega nuevos campos de Odoo, sobrescribe métodos o añade restricciones. El modelo heredado en Odoo mantiene tus cambios en un módulo separado para facilitar las actualizaciones.
Añadiendo Campos
Define nuevos campos de Odoo en tu modelo heredado. Usa el tipo de campo correcto: Char, Many2one, Boolean, Integer, Text, Selection. Las adiciones comunes incluyen fuentes de leads personalizadas, interés en productos o industria. Considera campos dependientes de la empresa para multiempresa.
Extensiones de Python
Sobrescribe create, write o el método action_convert para añadir lógica. Usa super() para llamar al original. Ten cuidado con los cambios de etapa y la lógica de conversión. Los decoradores del modelo api en Odoo (@api.depends, @api.onchange) ayudan con campos computados y comportamiento de la interfaz de usuario.
Odoo Studio
Odoo Studio te permite añadir campos sin código. Es bueno para personalizaciones rápidas como menús desplegables adicionales o campos de texto. Para lógica compleja, automatización de etapas o actualizaciones, los módulos personalizados son más mantenibles.
Mejores prácticas
- Configura etapas para que coincidan con tu proceso de ventas. Usa secuencias de etapas separadas para leads y oportunidades si es necesario.
- Establece source_id y campaign_id a partir de parámetros UTM en formularios web. Esto habilita la atribución de marketing.
- Utiliza team_id para asignación en ronda o basada en territorios. Define reglas de asignación en crm.team.
- Al construir integraciones API, utiliza la API XML-RPC o JSON-RPC. El modelo crm.lead está completamente expuesto. Mapea los IDs de CRM externos a un campo personalizado como ref para la sincronización.
- Para campos personalizados, utiliza el prefijo
x_o un prefijo de módulo para evitar conflictos con futuras versiones de Odoo.
Errores Comunes
- Crear duplicados de leads en lugar de buscar por
email_from. Utiliceemail_normalizedo una verificación de duplicados antes de crear. - Confundir tipo (Lead vs Oportunidad) y stage_id. El tipo determina el tipo de registro. El stage determina la posición en el embudo. Ambos son importantes para los informes.
- Olvidar establecer user_id o team_id. Los leads no asignados se pierden. Configure la asignación automática o asegúrese de la asignación manual.
- Sobrescribir la lógica de conversión sin llamar a super(). El método action_convert realiza un trabajo importante. Extiéndalo, no lo reemplace ciegamente.
- Agregar campos personalizados requeridos sin valores predeterminados. Los leads existentes fallarán en la validación cuando actualice el módulo.
Conclusión
El modelo crm.lead es central en Odoo CRM. Almacena leads y oportunidades y impulsa el embudo de ventas. Comprender sus campos y cómo los módulos lo extienden le ayudará a configurar, personalizar e integrar Odoo de manera efectiva.
Ya sea que sea un consultor funcional mapeando procesos de ventas o un desarrollador construyendo módulos CRM personalizados, un sólido conocimiento de crm.lead le ahorrará tiempo y evitará errores.
¿Necesitas ayuda con tu implementación de Odoo?
Dasolo ayuda a las empresas a implementar, personalizar y optimizar Odoo. Nos especializamos en integraciones de API y desarrollo de Odoo. Nuestro equipo tiene una profunda experiencia con la arquitectura de datos de Odoo y modelos como crm.lead.
Si necesita ayuda con su implementación de Odoo, módulos CRM personalizados o integraciones, estamos aquí para ayudar. Reserve una demostración para discutir su proyecto.