{"id":19321,"date":"2026-06-25T11:01:01","date_gmt":"2026-06-25T11:01:01","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=19321"},"modified":"2026-08-21T04:48:08","modified_gmt":"2026-08-21T04:48:08","slug":"how-to-create-and-convert-leads-in-idempiere","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-to-create-and-convert-leads-in-idempiere\/","title":{"rendered":"How to Create and Convert Leads in iDempiere"},"content":{"rendered":"\n

A Lead in iDempiere represents a potential customer who has shown interest in purchasing products but has not yet been qualified or converted into a Business Partner. Leads originate from cold calls, referrals, conferences, marketing campaigns, or email enquiries, and are assigned to sales representatives for follow-up.<\/p>\n\n\n\n

Once qualified, a Lead is converted into a Business Partner and optionally a Sales Opportunity, moving the prospect into the active sales pipeline and directly impacting revenue forecasting.<\/p>\n\n\n\n

Process Flow<\/strong><\/h2>\n\n\n\n
\"\"<\/figure>\n\n\n\n

Business Rules<\/strong><\/h2>\n\n\n\n
    \n
  • Name is mandatory when creating a Lead record.<\/li>\n\n\n\n
  • Sales Lead flag must be enabled to classify the record as a customer prospect.<\/li>\n\n\n\n
  • Lead Source must identify where the enquiry originated for channel tracking.<\/li>\n\n\n\n
  • Activities can be recorded against a Lead to maintain a full interaction history.<\/li>\n\n\n\n
  • Qualified Leads can be converted into a Business Partner using the Convert Lead process.<\/li>\n\n\n\n
  • Create Opportunity can optionally be enabled during conversion to generate a Sales Opportunity.<\/li>\n\n\n\n
  • Leads cannot create a Business Partner if the customer already exists in the system.<\/li>\n\n\n\n
  • Lead Activities provide a complete history of customer interactions before conversion.<\/li>\n<\/ul>\n\n\n\n

    Prerequisites<\/strong><\/h2>\n\n\n\n
      \n
    • Organization configured.<\/li>\n\n\n\n
    • Sales Representative configured.<\/li>\n\n\n\n
    • Campaign configured if lead attribution is required.<\/li>\n\n\n\n
    • Lead Source values available for classification.<\/li>\n\n\n\n
    • Sales Stage configured if an Opportunity will be created during conversion.<\/li>\n<\/ul>\n\n\n\n

      Configuration Steps<\/strong><\/h2>\n\n\n\n

      Step 1: Create the Lead Record<\/strong><\/h3>\n\n\n\n

      Capturing complete customer information at the time of enquiry ensures the lead can be effectively qualified and converted.<\/p>\n\n\n\n

        \n
      • Open the Lead window and click New Record.<\/li>\n\n\n\n
      • Enter all available contact and company information, enable Sales Lead, assign a Sales Representative, set Lead Source and Lead Status, and save.<\/li>\n<\/ul>\n\n\n\n
        Field<\/strong><\/td>Sample Value<\/strong><\/td>Mandatory<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
        Search Key<\/td>alpha<\/td>No<\/td>Unique identifier for quick lookup<\/td><\/tr>
        Name<\/td>Karthik<\/td>Yes<\/td>Contact person name at the prospective company<\/td><\/tr>
        BP Name<\/td>ALPHA RETAIL SOLUTIONS<\/td>No<\/td>Company name used during Business Partner creation on conversion<\/td><\/tr>
        Phone<\/td>9872202101<\/td>No<\/td>Primary contact phone number<\/td><\/tr>
        Email Address<\/td>karthik@alpharetail.in<\/td>No<\/td>Contact email address<\/td><\/tr>
        Address<\/td>No 20, Anna Salai, Chennai, 600002<\/td>No<\/td>Prospect business address<\/td><\/tr>
        Active<\/td>Checked<\/td>Yes<\/td>Makes the lead available for processing<\/td><\/tr>
        Sales Lead<\/td>Checked<\/td>Yes<\/td>Classifies the record as a customer sales prospect<\/td><\/tr>
        Vendor Lead<\/td>Unchecked<\/td>No<\/td>Enable only if the lead is a potential supplier<\/td><\/tr>
        Campaign<\/td>Q1 LinkedIn Posts<\/td>No<\/td>Marketing campaign from which the lead originated<\/td><\/tr>
        Lead Source<\/td>Cold Call<\/td>No<\/td>Channel through which the enquiry was received<\/td><\/tr>
        Lead Status<\/td>New<\/td>No<\/td>Current qualification status of the lead<\/td><\/tr>
        Sales Representative<\/td>Anand Menon<\/td>No<\/td>Staff member responsible for following up the lead<\/td><\/tr>
        Comments<\/td>Customer expressed interest in purchasing AASHIRVAAD ATTA 5KG for retail distribution.<\/td>No<\/td>Free-text notes about the enquiry<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        \"\"<\/figure>\n\n\n\n

        Step 2: Record Lead Activity<\/strong><\/h3>\n\n\n\n

        Every customer interaction must be recorded on the Activity tab to maintain a complete qualification history for the lead.<\/p>\n\n\n\n

          \n
        • Open the Activity tab on the Lead and click New Record.<\/li>\n\n\n\n
        • Select User\/Contact, Activity Type, and Sales Representative, enter Start Date and End Date, add Comments, and enable Complete when the interaction is finished.<\/li>\n<\/ul>\n\n\n\n
          Field<\/strong><\/td>Sample Value<\/strong><\/td>Mandatory<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
          User\/Contact<\/td>Karthik<\/td>Yes<\/td>Contact person involved in the interaction<\/td><\/tr>
          Activity Type<\/td>Phone call<\/td>Yes<\/td>Type of interaction recorded<\/td><\/tr>
          Description<\/td>Initial Product Enquiry<\/td>Yes<\/td>Short description of the interaction<\/td><\/tr>
          Sales Representative<\/td>Anand Menon<\/td>No<\/td>Sales representative who conducted the activity<\/td><\/tr>
          Sales Opportunity<\/td>Blank<\/td>No<\/td>Link to an opportunity, if already created<\/td><\/tr>
          Comments<\/td>Customer requested pricing, delivery schedule, MOQ, and distributor margins for Aashirvaad Atta 5KG.<\/td>No<\/td>Detailed notes from the interaction<\/td><\/tr>
          Start Date<\/td>26\/06\/2026 4:11 PM<\/td>Yes<\/td>Date and time the interaction began<\/td><\/tr>
          End Date<\/td>26\/06\/2026 6:00 PM<\/td>No<\/td>Date and time the interaction ended<\/td><\/tr>
          Complete<\/td>Checked<\/td>No<\/td>Marks the activity as completed<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
          \"\"<\/figure>\n\n\n\n

          Step 3: Qualify the Lead<\/strong><\/h3>\n\n\n\n

          Qualification determines whether the lead has sufficient business potential to be converted into a Business Partner and Opportunity.<\/p>\n\n\n\n

            \n
          • Review the lead based on customer interest, expected purchase volume, distribution coverage, delivery location, and commercial viability.<\/li>\n\n\n\n
          • Update Comments or Lead Status to reflect the qualification outcome.<\/li>\n<\/ul>\n\n\n\n
            Qualification Criteria<\/strong><\/td>Sample Assessment<\/strong><\/td><\/tr><\/thead>
            Customer Interest Level<\/td>High \u2013 actively seeking a distributor for Aashirvaad Atta 5KG<\/td><\/tr>
            Expected Volume<\/td>Approximately 100 bags per month<\/td><\/tr>
            Distribution Coverage<\/td>Multiple retail outlets across Chennai<\/td><\/tr>
            Delivery Location<\/td>Chennai, Tamil Nadu<\/td><\/tr>
            Commercial Viability<\/td>Meets minimum order quantity requirements<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

            Step 4: Convert the Lead<\/strong><\/h3>\n\n\n\n

            Convert Lead transforms a qualified lead into a Business Partner and optionally creates a Sales Opportunity for pipeline tracking.<\/p>\n\n\n\n

              \n
            • Click the Process button on the Lead and select Convert Lead.<\/li>\n\n\n\n
            • Enable Create Opportunity, enter Sales Stage, Opportunity Amount, Currency, Sales Representative, and Expected Close Date, then click OK.<\/li>\n<\/ul>\n\n\n\n
              Field<\/strong><\/td>Sample Value<\/strong><\/td>Mandatory<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
              Create Opportunity<\/td>Checked<\/td>No<\/td>Generates a Sales Opportunity during conversion<\/td><\/tr>
              Sales Stage<\/td>Prospecting<\/td>No<\/td>Initial stage assigned to the new Opportunity<\/td><\/tr>
              Opportunity Amount<\/td>500,000<\/td>No<\/td>Expected deal value for the Opportunity<\/td><\/tr>
              Currency<\/td>INR<\/td>No<\/td>Currency of the Opportunity Amount<\/td><\/tr>
              Sales Representative<\/td>Anand Menon<\/td>No<\/td>Sales representative assigned to the Opportunity<\/td><\/tr>
              Expected Close Date<\/td>31-Jul-2026<\/td>No<\/td>Target date for closing the Opportunity<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
              \"\"<\/figure>\n\n\n\n

              Step 5: Verify the Conversion Result<\/strong><\/h3>\n\n\n\n

              Confirming that the Business Partner and Sales Opportunity were created correctly ensures the lead has successfully entered the sales pipeline.<\/p>\n\n\n\n

                \n
              • Open the Business Partner window and search for the converted customer.<\/li>\n\n\n\n
              • Then open the Sales Opportunity window and verify the newly created Opportunity is present with the correct stage and amount.<\/li>\n<\/ul>\n\n\n\n
                Record<\/strong><\/td>What to Verify<\/strong><\/td>Expected Result<\/strong><\/td><\/tr><\/thead>
                Business Partner<\/td>Search for ALPHA RETAIL SOLUTIONS<\/td>Business Partner record created successfully<\/td><\/tr>
                Sales Opportunity<\/td>Sales Stage, Amount, Sales Representative, and Expected Close Date<\/td>Opportunity created in Prospecting stage<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                Common Issues and Resolutions<\/strong><\/h2>\n\n\n\n
                Issue<\/strong><\/td>Cause<\/strong><\/td>Resolution<\/strong><\/td><\/tr><\/thead>
                Lead cannot be converted<\/td>Mandatory fields not populated<\/td>Verify Name and BP Name are filled before running Convert Lead.<\/td><\/tr>
                Duplicate Business Partner error during conversion<\/td>Customer already exists in Business Partner master<\/td>Search for the existing Business Partner and link it to the lead manually.<\/td><\/tr>
                Opportunity not created after conversion<\/td>Create Opportunity was not enabled<\/td>Re-run Convert Lead and enable Create Opportunity before clicking OK.<\/td><\/tr>
                Activity not visible on the Lead<\/td>Activity not saved correctly<\/td>Open the Activity tab and verify the record was saved and Complete is checked.<\/td><\/tr>
                Lead not appearing in Sales Representative’s list<\/td>Sales Representative not assigned<\/td>Assign the correct Sales Representative on the Lead header.<\/td><\/tr>
                Lead Source missing from dropdown<\/td>Lead Source not configured<\/td>Configure the required Lead Source values in the reference data setup.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                Next Steps<\/strong><\/h2>\n\n\n\n
                  \n
                • Progress the Sales Opportunity through Qualification, Proposal Submitted, and Negotiation stages.<\/li>\n\n\n\n
                • Record additional Activities against the Opportunity as customer interactions continue.<\/li>\n\n\n\n
                • Close the Opportunity as Closed Won once the order is confirmed.<\/li>\n\n\n\n
                • Create a Sales Order from the converted Business Partner.<\/li>\n\n\n\n
                • Review lead conversion rates periodically to measure sales pipeline health.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"

                  A Lead in iDempiere represents a potential customer who has shown interest in purchasing products but has not yet been […]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10,78],"tags":[],"class_list":["post-19321","post","type-post","status-publish","format-standard","hentry","category-idempiere-product","category-idempiere-sales"],"_links":{"self":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/19321","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/comments?post=19321"}],"version-history":[{"count":2,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/19321\/revisions"}],"predecessor-version":[{"id":28185,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/19321\/revisions\/28185"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=19321"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=19321"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=19321"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}