Förstå Odoos Lead- och Möjlighetsarkitektur: Modellen crm.lead

Introduktion

I Odoo definierar modeller hur data struktureras och lagras i databasen. Varje del av affärsdata du arbetar med, från försäljningsorder till fakturor till leads, finns i en modell.

Att förstå Odoo-modeller är avgörande för både utvecklare och funktionella konsulter. Modeller är grunden för Odoos dataarkitektur. De definierar Odoo-fält, relationer och affärslogik.

Denna artikel fokuserar på crm.lead-modellen. Den driver försäljningspipeline i Odoo CRM. Oavsett om du bygger anpassade moduler, integrerar externa system eller konfigurerar försäljningsarbetsflöden, kommer du att arbeta med denna modell.

Vad är crm.lead-modellen

crm.lead-modellen representerar leads och möjligheter i Odoo. Det är den centrala platsen där data om försäljningspipeline lagras. En enda modell i Odoo hanterar både tidiga leads och kvalificerade möjligheter.

Denna modell används av CRM-modulen. Försäljnings-, marknadsförings- och webbplatsmoduler utökar eller refererar till den. När en besökare fyller i ett formulär på din webbplats, när en säljare skapar en möjlighet, eller när ett lead konverteras till en kund, arbetar du med crm.lead.

Modellen använder Odoo-modellärv för att lägga till funktionalitet. Den grundläggande CRM-modulen definierar den kärnstruktur. Andra moduler som crm_iap_lead_enrich eller website_crm lägger till fält och beteende. Varje modul utökar vad den behöver utan att duplicera kärnan.

Nyckelfält i modellen

Här är de viktigaste Odoo-fälten i crm.lead-modellen. Att förstå dessa kommer att hjälpa dig att arbeta effektivt med leads och möjligheter.

1. namn

Typ: Char. Detta fält lagrar namnet eller titeln på leadet eller möjligheten. Det är den huvudsakliga identifieraren som visas i listvyer och kanban. För ett lead kan det vara "Förfrågan från webbplats." För en möjlighet kan det vara "Företagsavtal - Acme Corp."

2. kontakt_namn

Typ: Char. Namnet på kontaktpersonen. Används när leadet ännu inte är kopplat till en res.partner. När du konverterar ett lead kopieras ofta detta värde till den nya partnerposten.

3. email_från

Typ: Char. Den primära e-postadressen för leadet. Odoo använder detta för kommunikation innan konvertering. Det är det huvudsakliga sättet att identifiera och avduplicera leads.

4. telefon

Typ: Char. Det huvudsakliga telefonnumret. Visas på leadformuläret och används för samtalsloggning och uppföljningsaktiviteter.

5. mobil

Typ: Char. Mobiltelefonnummer. Används ofta för SMS eller brådskande uppföljning när den skiljer sig från huvudtelefonen.

6. partner_id

Typ: Many2one (res.partner). Länkar till kontakten eller företaget när leadet är kvalificerat eller konverterat. Innan konvertering är detta fält tomt. Efter konvertering länkar det till den skapade eller matchade partnern.

7. user_id

Typ: Many2one (res.users). Den säljare som ansvarar för leadet. Används för tilldelning, rapportering och schemaläggning av aktiviteter. Driver "Mina möjligheter" och teamdashboards.

8. team_id

Typ: Many2one (crm.team). Säljteamet. Organiserar leads efter team för rund-robin tilldelning och team-baserad rapportering.

9. stage_id

Typ: Many2one (crm.stage). Den aktuella fasen i pipeline. Faser definierar tratten: Ny, Kvalificerad, Förslag, Förhandling, Vunnen, Förlorad. Att flytta mellan faser driver automatisering och rapportering.

10. typ

Typ: Val. Indikerar om posten är ett Lead eller en Möjlighet. Leads är i tidigt skede. Möjligheter är kvalificerade och har förväntad intäkt. Typen påverkar vilka vyer och faser som är tillgängliga.

11. förväntad_intäkt

Typ: Flyttal. Den förväntade intäkten om möjligheten vinner. Används för rapportering av pipelinevärde och prognoser. Beräknas ofta utifrån sannolikhet och ett affärsbelopp.

12. sannolikhet

Typ: Flyttal. Vinstsannolikheten som en procentandel (0 till 100). Används i viktade pipelineberäkningar. Kan vara manuell eller automatiserad baserat på steg.

13. företag_id

Typ: Many2one (res.company). I flerföretagsinställningar anger detta vilken Odoo-företag ledningen tillhör. Påverkar postens synlighet och valuta.

14. beskrivning

Typ: Text. Anteckningar och beskrivning av ledningen eller möjligheten. Används för interna anteckningar, mötes sammanfattningar och kontext som säljare behöver när de följer upp.

15. skapad_datum

Typ: Datetime. Lagrar datum och tid när posten skapades. Hanteras automatiskt av Odoo. Användbart för rapportering av ledningens ålder och analys av konverteringstid.

16. ändrad_datum

Typ: Datetime. Lagrar datum och tid för den senaste ändringen. Hanteras också automatiskt. Hjälper till att spåra när ledningen senast uppdaterades.

17. date_open

Typ: Datum och tid. När leaden först tilldelades en användare. Sätts när user_id är ifyllt. Används för att mäta tid till första kontakt och tilldelningshastighet.

18. date_closed

Typ: Datum och tid. När leaden stängdes (vunnen eller förlorad). Sätts när steget flyttas till ett stängt steg. Används för konverteringsanalys och längd på försäljningscykeln.

19. date_deadline

Typ: Datum. Det förväntade stängningsdatumet. Används för prognostisering och aktivitetsplanering. Säljare sätter detta för att spåra när de förväntar sig att stänga affären.

20. active

Typ: Boolean. Mjuk raderingsflagga. När False, arkiveras posten och döljs från standardvyer. Förlorade eller sammanslagna leads arkiveras ofta istället för att raderas.

21. street, street2, city, zip

Typ: Char. Adressfält. Används när leaden har en adress före konvertering. Kopieras till partnern när leaden konverteras.

22. country_id

Typ: Many2one (res.country). Landet. Används för regional rapportering och adressformattering. Att filtrera leads efter land hjälper med territoriehantering.

23. state_id

Typ: Many2one (res.country.state). Staten eller provinsen. Domänen filtreras efter land. Används för regional segmentering.

24. source_id

Typ: Many2one (utm.source). Leadkällan. Spårar varifrån leadet kom: Webbplats, Referens, Kampanj, etc. Viktigt för marknadsföringsattribution.

25. campaign_id

Typ: Many2one (utm.campaign). Marknadsföringskampanjen. Kopplar leadet till en specifik kampanj för ROI-analys. Används när leads kommer från e-post eller annonskampanjer.

26. activity_ids

Typ: One2many (mail.activity). De schemalagda aktiviteterna. Uppgifter, samtal och möten kopplade till leadet. Driver aktivitetswidgeten och påminnelser för uppföljning.

27. color

Typ: Heltal. Färgindex för kanban- och listvyer. Används för att visuellt särskilja leads efter prioritet, källa eller anpassade kriterier.

28. message_ids

Typ: One2many (mail.message). Chattaren. Interna anteckningar, e-post och aktivitetslogg. Odoo lagrar all kommunikation i chattaren för fullständig kontext.

Hur denna modell används i affärsarbetsflöden

1. Webbplatsens Lead Capture

När en besökare skickar ett kontaktformulär på din Odoo-webbplats skapas en ny crm.lead-post. email_from, contact_name och description fylls i från formuläret. Leadet visas i CRM-pipelinen för att säljteamet ska kunna följa upp.

2. Lead Kvalificering och Konvertering

Säljare flyttar leads genom olika faser. När ett lead är kvalificerat ändrar de typen till Möjlighet och anger expected_revenue. När affären är vunnen konverterar de leadet. Odoo skapar eller kopplar en res.partner och valfritt en sale.order.

3. Försäljningspipeline Rapportering

Chefer använder crm.lead-data för pipeline-rapporter. Förväntad intäkt, sannolikhet och fas driver det viktade pipeline-värdet. Filter efter user_id och team_id visar prestationer per säljare och team.

4. Marknadsföringsattribution

Fälten source_id och campaign_id kopplar leads till marknadsföringsinsatser. När leads kommer från e-postkampanjer eller annonser, fylls dessa fält med UTM-parametrar. Marknadsföringsteam använder detta för att mäta kampanjens effektivitet.

5. Aktivitet och Uppföljningshantering

Säljare schemalägger aktiviteter på leads. Fältet activity_ids lagrar samtal, möten och uppgifter. activity_date_deadline driver kolumnen "Nästa Aktivitet" i listvyer och påminner användare att följa upp.

Hur utvecklare utökar denna modell

Utvecklare utökar crm.lead med flera mönster. Odoo-modellarv är den huvudsakliga mekanismen.

Modellarv

Använd _inherit = 'crm.lead' för att utöka modellen. Lägg till nya Odoo-fält, åsidosätt metoder eller lägg till begränsningar. Den ärvda modellen i Odoo håller dina ändringar i en separat modul för enkla uppgraderingar.

Lägga till fält

Definiera nya Odoo-fält i din ärvda modell. Använd rätt fälttyp: Char, Many2one, Boolean, Integer, Text, Selection. Vanliga tillägg inkluderar anpassade leadkällor, produktintresse eller bransch. Överväg företagsberoende fält för flera företag.

Python-tillägg

Åsidosätt create, write eller action_convert-metoden för att lägga till logik. Använd super() för att anropa den ursprungliga. Var försiktig med stadieändringar och konverteringslogik. Odoo-dekoratörerna för api-modellen (@api.depends, @api.onchange) hjälper till med beräknade fält och UI-beteende.

Odoo Studio

Odoo Studio låter dig lägga till fält utan kod. Bra för snabba anpassningar som extra rullgardinsmenyer eller textfält. För komplex logik, stadieautomatisering eller uppgraderingar är anpassade moduler mer underhållbara.

Bästa praxis

• Konfigurera stadier för att matcha din försäljningsprocess. Använd separata stadiesevenemang för leads och möjligheter om det behövs.
• Ställ in source_id och campaign_id från UTM-parametrar på webbplatsformulär. Detta möjliggör marknadsföringsattribution.
• Använd team_id för rund-robin eller territoriebaserad tilldelning. Definiera tilldelningsregler i crm.team.
• När du bygger API-integrationer, använd XML-RPC eller JSON-RPC API. crm.lead-modellen är helt exponerad. Karta externa CRM-ID till ett anpassat fält som ref för synkronisering.
• För anpassade fält, använd x_-prefixet eller ett modulprefix för att undvika konflikter med framtida Odoo-versioner.

Vanliga misstag

• Skapar duplicerade leads istället för att söka efter email_from. Använd email_normalized eller en dedupliceringskontroll innan du skapar.
• Blandar ihop typ (Lead vs Opportunity) och stage_id. Typen bestämmer posttypen. Steget bestämmer positionen i tratten. Båda är viktiga för rapportering.
• Glömmer att ställa in user_id eller team_id. Oassignerade leads går förlorade. Konfigurera automatisk tilldelning eller säkerställ manuell tilldelning.
• Överskrider konverteringslogik utan att kalla på super(). Metoden action_convert gör viktigt arbete. Utöka den, ersätt den inte blint.
• Lägger till obligatoriska anpassade fält utan standardvärden. Befintliga leads kommer att misslyckas med valideringen när du uppgraderar modulen.

Slutsats

Modellen crm.lead är central för Odoo CRM. Den lagrar leads och möjligheter och driver försäljningspipen. Att förstå dess fält och hur moduler utökar den kommer att hjälpa dig att konfigurera, anpassa och integrera Odoo effektivt.

Oavsett om du är en funktionell konsult som kartlägger försäljningsprocesser eller en utvecklare som bygger anpassade CRM-moduler, kommer en solid förståelse av crm.lead att spara tid och förhindra fel.

Behöver du hjälp med din Odoo-implementering?

Dasolo hjälper företag att implementera, anpassa och optimera Odoo. Vi specialiserar oss på API-integrationer och Odoo-utveckling. Vårt team har djup erfarenhet av Odoo:s dataarkitektur och modeller som crm.lead.

Om du behöver hjälp med din Odoo-implementering, anpassade CRM-moduler eller integrationer, är vi här för att hjälpa till. Boka en demo för att diskutera ditt projekt.