This is the documentation for older versions of Odoo (formerly OpenERP).

See the new Odoo user documentation.

See the new Odoo technical documentation.

Managing your Leads

To define leads, imagine a bucket full of potential sales contacts expressing an interest in your company's products.

A lead represents a potential customer with whom you have not established a relationship yet. Usually a lead contains valuable information to realise future sales opportunities. However, the most common mistake is that such key information too often gets lost, because it is registered nowhere. And even when registered, it might still be difficult to track any activity for that lead, because the information is not at hand when you need it.

Storing leads information in a central place such as OpenERP will release you of these worries.

So when would you create a lead in OpenERP, either manually or automatically? The following events could be a trigger:

  • An inquiry email sent to one of your company's generic email addresses, such as, from the mailgateway,

  • A business card from a prospective customer met briefly at an exhibition: you have to contact him again to qualify the lead and to know if there is any possibility of a sales opportunity; registered manually,

  • A database of potential customers in a given sector and region imported through a CSV file. The potential customers have to be contacted again individually or through a mass mailing to determine which contacts require further follow-up,

  • An interesting contact that you met during a business networking event. You have to qualify it before assigning a salesperson to the contact,

  • A form completed on your website directly integrated into OpenERP using our webservice. Before converting the form into a sales proposition or opportunity, you should read and handle the person's request.

Employees in the marketing or presales department will usually work on leads. Once these leads will be converted into customers and/or sales opportunities, the sales department pays individual attention to each opportunity. Of course, before converting a lead into an opportunity, some qualification work has to be done.

OpenERP allows you to easily configure the way your company qualifies leads. You can create your own stages through Sales ‣ Configuration ‣ Leads & Opportunities ‣ Stages. Use the sequence number to determine the order of the stages, i.e. 10 for First Call, 20 for Renewing Contact and so on. Of course, you can also drag & drop a stage to another place to automatically change the order of all the stages. A salesperson can change the status of the lead according to the response from the prospect and enter the result of this contact in the lead form (e.g. in the Notes field).

Leads can be assigned to a Sales Team for easy follow-up (see Adapting OpenERP to your Sales Organization). Each user can be added to a default sales team which can be specified in the User Preferences. When you define a tree structure for your sales teams, you can also escalate a lead to another sales team for further actions.


Leads or Opportunities

Companies may decide to not use leads, but instead to keep all information directly in an opportunity. For some companies, leads are merely an extra step in the sales process. You could call this extended (start from lead) versus simplified (start from opportunity) customer relationship management. OpenERP perfectly allows for either one of these approaches to be chosen. If your company handles its sales from opportunities directly, feel free to move on to chapter Optimizing your Sales Cycle through Opportunities, although most of the features explained below also apply to opportunities.

In the next sections we will explain in more detail some examples of what Leads in OpenERP can be used for.

Storing your Business Cards effectively

Potential customers are usually entered as a lead in the system. This means that you do not create a partner or a sales opportunity until you have qualified whether the lead is interesting or not.



When a qualified lead requires further actions, you can turn the lead into a partner and, eventually, a sales opportunity.

To make a new lead, go to the Sales ‣ Sales ‣ Leads menu and click the Create button. In the Lead form that opens, you can enter the contact data of this new potential customer and add notes.


Creating a New Lead

You can also set the status of a lead according to the qualification work that has been carried out:

  • New : the lead data have been entered, no work has been done yet and a salesperson has not yet been assigned to the request,

  • Opportunity: the lead has been converted into a partner and/or a sales opportunity,

  • Escalate: the lead is escalated to the upper sales team in the tree structure for further actions,

  • Cancelled: the lead has been cancelled because the salesperson has decided that it is not worth following up.

On the Extra Info tab in the Leads form, you find information about the campaign, the channel, and so on.


Extra Tab

Importing a Leads Database

You can also import a huge list of leads. That may be useful if you have bought a database of potential prospects that you want to load into OpenERP to handle them all at the same time.

Start with a list of leads in CSV format, for instance. If your prospects database is provided in another format, you can easily convert it to the CSV format using Microsoft Excel or OpenOffice Calc.



The best thing to do to make sure your import will go smoothly, first export all the required Lead fields using the Export function, and then edit the resulting csv file for import.

Open the Leads form using the menu Sales ‣ Sales ‣ Leads. List view of leads shows two options create or import, click the Import link.

Select your file containing the leads information and click Import File. OpenERP will automatically map the column headers from your CSV file to the corresponding fields in OpenERP. If necessary, you can click CSV Options to change the settings so that they match your local settings.


Importing Leads into the System

Check the online chapter about system administration for more information on import and export on


Various Imports

Importing and Exporting data in OpenERP is a generic function available to all resources. So you can import and export such lists as partners, opportunities, accounting entries, products and price lists.

Clearly there are other methods of generating leads automatically or semi-automatically:

  • Through a Contact Form on your Website;

  • Using the Outlook or Thunderbird plugin to insert new leads directly from the salesman's mailbox when he sees promising emails,

  • Using the email gateway for each incoming email from a certain address (such as which may create a lead automatically from the contents of the email.

These different methods are described later in this book (see chapter Automating your Lead Acquisition).

Organizing Leads

To help the users organize and handle leads efficiently, OpenERP provides several features in the CRM to be used according to the needs of each:

Use the Sales ‣ Sales ‣ Leads view to organize your leads:

  • Display a list of all the leads (New, open, Unassigned Leads, ...) according to the sales team you are linked to,

  • Display a list of New leads by clicking New,

  • Display Unassigned Leads by clicking Unassigned Leads,

  • Display a list of all the leads assigned to different salespeople by clicking the Group by button Salesperson.

  • Quickly find leads not yet assigned to a Campaign, by clicking the Group by button and then Campaign.

The sales manager can use this Leads view to easily keep track of what each salesperson is working on.


List of Leads to be Handled

Leads can also be prioritized. Salespeople can assign a priority to their lead, and then start working on their leads from the top of the list, which is sorted by priority.

Analysing Leads

OpenERP also offers statistical reports to keep track of your Lead Management. The Reporting ‣ Sales ‣ Leads Analysis report allows you to check various leads-related elements. You can look at processing delays, number of responses given and emails sent (if you use the email gateway feature). Sort your leads analysis by different groups to get accurate, grained analysis.

These are some analysis possibilities of the Leads Analysis report.

  1. Leads by State and per Month

To analyse the leads by status, group the leads by qualification level (Stage) and status (State), this can also be done for individual months (first group by Month).

  1. How effective are your Campaigns?

Group by Campaign to easily find the number of leads by campaign and the total number of leads. You can also select a specific campaign in your filter.

  1. Leads by Priority.

Group by Priority to see which leads are hot, warm or cold.


Leads Analysis