Sales Person

Sales Person Master (CRM Mode) - User Guide

1. Introduction 📝

The Sales Person Master maintains the profiles of all personnel authorized to handle commercial opportunities, manage customer leads, and execute follow-up interactions. In CRM mode, the master enforces team hierarchy and territorial structure by categorizing every sales executive into an active Salesmen Group.

â„šī¸

In the overall CRM flow:

  1. Designates the primary Lead Owner during initial prospect registration.
  2. Identifies the Assigned Executive responsible for specific follow-up activities.
  3. Groups analytical metrics in the CRM Dashboard and the Salesmen Performance sheet of the Lead Summary Report.

2. Getting Started 🚀

Accessing the Module

Navigate to CRM > Masters > Sales Person (/salesmenmstindex/C).

Operational Context: Sales Mode vs CRM Mode

The system features dual-mode operational behavior:

  • Standard Manufacturing Sales Mode (/salesmenmstindex/S): Standard directory entry. Salesmen Groups are hidden and optional.
  • Advanced CRM Mode (/salesmenmstindex/C): Specifically designed for customer relationship workflows. Shows a dedicated Salesmen Group column and a top action button for Salesmen Group Master. In CRM mode, assigning a Salesmen Group is mandatory.

3. Features ✨

  • 🆔 3-Character Short Identifier: Assign a concise 3-character code (e.g., RAJ, K01, DEL) for rapid identification in high-volume transaction forms.
  • 📂 Mandatory Group Categorization: Link every sales rep to a strategic group (e.g., Direct Sales, Key Accounts, West Zone, Export Team).
  • ➕ Inline Quick-Add Group: Define and register a new Salesmen Group directly from the salesman creation screen without interrupting data entry.
  • 📍 Territory & Hierarchy Tracking: Record designated sales territories and official corporate designations.
  • đŸšĻ Non-Destructive Inactivation: Use the IsActive toggle (Y / N) to retire personnel who transition to other roles or depart the firm, safeguarding historical transaction integrity.
  • đŸ›Ąī¸ Transactional Reference Protection: Integrated check prevents deleting sales personnel who have active or completed leads, quotations, or orders.

4. Complete Flow 🔄

Access CRM Sales Person Index

  • Open CRM > Masters > Sales Person.
  • Ensure the page displays the Salesmen Group column, confirming you are operating in CRM mode (/salesmenmstindex/C).

Create Sales Profile

  • Click Create New (/salesmenmstcreate/C).
  • Enter the Salesman Name (up to 50 characters).
  • Enter a unique 3-character Short Code.
  • Specify the Designation and designated Sales Territory (up to 100 characters each).
  • Select the applicable Salesmen Group. If the required group does not yet exist, click the inline "+" (Add New) button to define it instantly.
  • Confirm that Is Active is set to Yes.
  • Click Save.

Assign to Leads and Activities

  • The registered salesperson is now available for selection in:
    • Lead Create: As the primary lead owner.
    • Lead Modify: To reassign the lead if no activities are logged yet.
    • Lead Activities: To delegate specific meetings, calls, or demos to specialized team members.

Lifecycle Maintenance

  • When a representative leaves or changes responsibilities, update their profile and set Is Active = No. Their past deal records remain intact on all dashboards and reports while keeping current dropdowns clean.

5. Validations and Error Handling âš ī¸

The master enforces strict referential and structural rules:

Validation ScenarioWhat is checked?Error Message / System Behavior
Mandatory Group Selection in CRMPrevents saving a salesperson profile in CRM mode without an assigned group.“Salesmen Group needs to be selected.”
Name Uniqueness CheckChecks against existing personnel names across the entire organization.“Salesmen Name already exist.”
Short Code Uniqueness CheckVerifies that the 3-character short code is not already assigned to another rep.“Salesmen Short Name already exist.”
Live Transaction Reference GuardVerifies across CRM Leads, Activities, Orders, and Invoices before allowing deletion.“Master Record is live. You may not delete it.”

6. Tools / Smart Features 🔧

  • ⚡ Inline Group Creation: The group autocomplete dropdown includes an embedded “+ Add New” button, allowing administrators to establish regional groups on-the-fly.
  • 🔍 Multi-Parametric Filter: Use the data grid search to filter sales personnel by territory, group, active status, or short code.

7. Configuration Requirements âš™ī¸

  • Permissions: Access requires assigned CRM sales master permissions (CrmSalesmenMstDetails, CrmSalesmenMstCreate, CrmSalesmenMstDelete).

8. Best Practices 💡

  • Consistent Short Codes: Adopt a company-wide naming convention for short codes (e.g., initials or department prefixes like SM1, EX1) for rapid autocomplete selection.
  • Never Delete Active History: Deactivating a representative (IsActive = N) preserves all past conversion analytics and audit trails on reports.