Lead Management
Lead Management Module - User Guide
๐ Business Impact
The Lead Management module is your operational command center for converting prospects into paying customers. Maintaining structured follow-ups, enforcing single-action discipline, and centralizing client interaction history can increase sales team conversion rates by up to 25% and eliminate lead abandonment.
โก Quick Start: 3-Minute Fast Track
For sales representatives logging an opportunity immediately:
- Header Entry: Navigate to Lead, click Create Main, select the Source / Platform, enter Lead Name, Contact Person, Email, and pick the primary Salesperson.
- Log First Follow-up: From the lead details page, click Lead Activity Details โ Create Line, choose the Interaction Type, set the Due Date, and add notes.
- Engage & Progress: Complete the interaction, mark its status as Done, and schedule the next follow-up.
- Close Deal: Once terms are agreed, transition the Lead Status to Converted and proceed to create the Sales Order.
๐บ๏ธ Process Flow: Prospect to Order
graph TD
Prospect["Prospect Inquiry (Trade Show, Web, Call)"] --> CreateLead["Step 1: Create Lead Header"]
CreateLead --> FirstActivity["Step 2: Create Initial Activity (Pending)"]
FirstActivity --> Engage["Step 3: Conduct Call / Meeting / Demo"]
Engage --> AttachRFQ["Attach RFQ / Specs (PDF Up to 1 MB)"]
Engage --> SendQuote["Send Proposal Email (Doc Type Template)"]
AttachRFQ --> UpdateStatus["Step 4: Update Activity Status (Done / Cancelled)"]
SendQuote --> UpdateStatus
UpdateStatus --> NextStep{"Further Follow-up Needed?"}
NextStep -- Yes --> NextActivity["Step 5: Create Next Activity (Pending)"]
NextActivity --> Engage
NextStep -- No --> Outcome{"Deal Won?"}
Outcome -- Yes --> Convert["Step 6: Update Lead Status to Converted"]
Outcome -- No --> Drop["Step 6: Update Lead Status to Dropped"]
Convert --> SalesOrder["Step 7: Proceed to Sales Order"]
style CreateLead fill:#e0f2fe,stroke:#0284c7,stroke-width:2px
style FirstActivity fill:#fef3c7,stroke:#d97706,stroke-width:2px
style UpdateStatus fill:#fed7aa,stroke:#ea580c,stroke-width:2px
style Convert fill:#dcfce7,stroke:#16a34a,stroke-width:2px
style SalesOrder fill:#bbf7d0,stroke:#15803d,stroke-width:2pxโ Prerequisites Checklist
Before logging your first lead, ensure the following configurations are complete:
- Campaign Platforms: Lead acquisition channels are cataloged in Campaign Platform Master.
- Interaction Types: Touchpoint categories (Call, Meeting, Demo) are registered in Interaction Type Master.
- Sales Personnel: Sales executives are active in Sales Person Master with mandatory group assignments.
- Proposal Templates: Standard quotation/proposal text is authored in Proposal Template Master.
- System Parameters: Verify that the document warehouse flag
UploadDownloadDocsis enabled (Y) if you intend to store PDF attachments.
1. Overview & Architecture ๐
Lead Management is organized into a robust Two-Tier Architecture:
- Main Lead Record (Header): Captures organizational and contact dataโCompany/Lead Name, Contact Person, Designation, Phone, Email, Acquisition Source, and Primary Sales Executive.
- Lead Activities (Follow-up Lines): Tracks each iterative touchpointโActivity Date, Due Date, Interaction Medium, Assigned Specialist, Proposal Template, Interaction Notes, Status (Pending / Done / Cancelled), and Attached Documents.
2. Getting Started ๐
Accessing the Module
Navigate to CRM > Transactions > Lead (/crmleadindex).
The Index Page
The main index displays an active pipeline grid with:
- Lead No: Formatted system number with a direct hyperlink to the lead’s detail view (
/crmleaddetails/{id}). - Platform: The originating campaign source.
- Lead Name: Company or client organization title.
- Salesmen: Primary sales executive assigned to the account.
- Status: Current pipeline milestone (e.g., Interested, Trial, Negotiation, Converted, Dropped).
๐ Missed / Power Feature: Global Activity Worklist (crmlead1index/0)
Notice the Activity Details button on the bottom bar of the Lead Index page. Clicking this button opens a consolidated system-wide worklist of all scheduled and completed activities across all leads in the company.
- Displays Lead Name, Salesperson, Assigned Specialist, Activity Date, Due Date, Interaction Type, and Activity Status.
- Enables sales managers to audit team cadence, filter upcoming due dates, and monitor overdue follow-ups across all clients without opening individual lead records.
3. Features โจ
A. Lead Creation & Automatic Numbering
Clicking Create Main opens the creation interface. The system prompts for source platform, contact credentials, and sales executive. Upon saving, the system automatically assigns the next sequential Lead Number and directs you to the detailed profile.
B. Sequential Activity Cadence (Anti-Abandonment Engine)
To prevent sales representatives from abandoning follow-ups or creating cluttered backlogs, the system enforces strict sequential activity discipline:
- Only one active Pending activity can exist on a lead at any given moment.
- Before scheduling a new touchpoint, the representative must resolve the prior activity by marking it Done or Cancelled.
C. Specialist Activity Delegation
While each Lead has an overall account owner, individual activities can be delegated to specialized team members. For example, the primary executive can assign a technical product demonstration to an application engineer while retaining primary account ownership.
D. Integrated Document Warehouse (PDF Attachments)
Each activity line supports attaching customer RFQs, floor layouts, or technical specifications:
- Format & Size: Accepts
.pdffiles up to 1 MB. - Audit Archival Lock: To maintain audit compliance, records older than 1 year have document uploads and re-uploads permanently locked.
E. One-Click Proposal Email Dispatch
When an activity specifies a Proposal Template Type, an Email action button becomes active on the activity screen:
- Directly sends an HTML-formatted proposal to the lead’s registered email address.
- Automatically creates an email subject in the format:
[Proposal Template Type] - [Lead Name]. - Formats paragraphs and line breaks automatically, eliminating the need for external mail software.
F. Lead Status Progression & Closure Controls
When a lead is first created, its status defaults to the initial stage. As interactions occur:
- Once at least one activity has been recorded, the Status dropdown unlocks in Lead Modify, allowing progression through your sales stages.
- Transitioning a lead to Converted or Dropped locks the account against further edits and preserves complete historical engagement data.
4. Complete Flow ๐
Step 1: Register Prospect
- Open Lead Index and click Create Main (
/crmleadcreate). - Select the Source / Platform (e.g.,
Trade Expo Mumbai). - Enter Lead Name (company), Contact Name, Designation, Contact No (8-10 digits), and a valid Email.
- Select the primary Salesperson and click Save.
Step 2: Schedule First Interaction
- From the newly created lead details screen, click Lead Activity Details (
crmlead1index/{id}). - Click Create Line (
crmlead1create/{id}). - Specify the Due Date (cannot be in the past).
- Select the Interaction Type (e.g.,
Phone Call) and verify the Assigned To executive. - Optionally select a Proposal Template Type and write detailed objectives in Notes.
- Click Save.
Step 3: Conduct Touchpoint & Upload Documents
- After speaking with the customer, open the activity details screen (
crmlead1details/{id}). - If the customer provided an RFQ or specification sheet, click Upload Document, attach the PDF, and click Upload.
- If a proposal is requested, click Email to send the pre-approved template directly to the contact.
Step 4: Resolve Activity & Schedule Follow-Up
- Click Modify on the activity (
crmlead1modify/{id}). - Update the Activity Status from
PendingtoDone(orCancelled). - Add conversation feedback into the notes and click Save.
- Return to the activity list and click Create Line to schedule the next follow-up milestone.
Step 5: Deal Conversion or Closure
- When the deal is won, open the main lead screen, click Modify, and change the Status to
Converted. - With the deal concluded, proceed to create the official Sales Order.
- If the opportunity does not materialize, mark the status as
Droppedto preserve history for future re-engagement campaigns.
5. Validations and Error Handling โ ๏ธ
The Lead Management engine enforces critical business rules to maintain pipeline discipline:
| Validation Scenario | What is checked? | Error Message / System Behavior |
|---|---|---|
| Activity Sequential Lock | Prevents creating a new activity while an earlier activity on the same lead is still marked as Pending (P). | “You cannot create a new Activity until the previous pending Activity is closed. Please update the pending status of your last activity.” |
| Lead Closure Dependency | Blocks marking a Lead as Converted or Dropped if any activity line remains in Pending status. | “Please update Activity Status as Done/Cancelled for all the lines” |
| Modification Lock on Closed Deals | Prevents editing lead headers or line activities once a lead is Converted or Dropped. | “You may not modify this as lead is Converted / Dropped.” |
| Activity Date Chronology (Create) | Ensures that new follow-up activities cannot have a due date in the past. | “Due date cannot be before today’s date” |
| Activity Date Chronology (Modify) | Ensures that during modification, the due date does not precede the original activity logging date. | “Due date cannot be before Activity Date” |
| Single-Line Activity Deletion Lock | Prevents deleting an individual activity if it is the only remaining line under that lead. | “Only one line is there in this document. You have to delete the whole document itself.” |
| Resolved Activity Deletion Guard | Protects audit history by preventing deletion of activities marked as Done or Cancelled. | “Activity is Done / Cancelled you may not delete it.” |
| Lead Deletion Guard | Prevents deleting a main lead record if any of its activities have been completed or cancelled, or if the lead is closed. | “You may not delete this record as activities are Cancelled or Done” |
| Proposal Email Template Check | Verifies that proposal text exists in Proposal Template Master for the selected document type before initiating email. | “Please create records in Proposal Template for [Document Type Name]” |
| Document Upload File Limits | Enforces PDF file type and a 1 MB file size cap. | “File size must be up to 1 MB” / “File needs to be selected.” |
| Document Warehousing Parameter | Checks system flag UploadDownloadDocs. If inactive, uploads are disabled. | “Upgrading to Electronic Document Ware House feature is required, Please contact support.” |
| 1-Year Document Audit Lock | Hides upload and re-upload links for activities older than 1 year to preserve compliance records. | Upload links are automatically hidden. |
6. Tools / Smart Features ๐ง
- ๐ Consolidated Activity Grid (
crmlead1index/0): Access all organization-wide touchpoints with one click from the Lead Index without entering individual customer files. - ๐ฅ Dynamic Multi-Executive Delegation: Reassign specific tasks (demos, audits) to specialized team members without transferring entire account ownership.
- ๐ Cloud PDF Storage: Instant browser download and viewing of linked customer attachments directly from the activity view.
- ๐ฌ Built-in SMTP Dispatch: Sends proposals directly from system email credentials with automated HTML line-break formatting.
7. Configuration Requirements โ๏ธ
- Permissions: Access requires assigned CRM security roles (
CrmLeadDetails,CrmLeadCreate,CrmLeadModify,CrmLeadDelete). - System Parameters: Document warehousing requires
UploadDownloadDocs = "Y".
8. Best Practices ๐ก
- Never Leave Pending Activities Open: When an interaction concludes, always take 30 seconds to mark it as
Done, enter notes, and schedule the next follow-up. This keeps your dashboard pipeline clean and accurate. - Keep Contact Numbers Clean: Enter 10-digit mobile numbers without country code prefixes or punctuation for seamless phone dialing on mobile viewports.
- Use Re-Upload Responsibly: Re-uploading a document replaces the previous file in the cloud storage. Only re-upload if updating an RFQ revision.