Salesmen Master

Salesmen Master Module - User Guide

1. Introduction 📝

The Salesmen Master module is a core administrative table used to maintain a directory of all personnel authorized to handle sales activities. By centralizing sales force data, the ERP can accurately track who is responsible for specific enquiries, orders, and regional targets.

â„šī¸

In the overall business flow:

  1. It identifies the Lead Owner in the Sales Enquiry and Marketing modules.
  2. It assigns Operational Responsibility to Sales Orders and Invoices.
  3. It enables Performance Tracking and regional sales analysis.

Typically, this module is managed by Sales Directors and HR Administrators.


2. Getting Started with Salesmen Master 🚀

Accessing the Module

Navigate to the Salesmen Index via the Sales Setup or CRM menu.

The Dual-Role Index (Sales vs CRM)

The module operates in two distinct operational modes determined by the URL route indicator:

  • Sales Mode (/salesmenmstindex/S): Standard manufacturing sales view. Salesmen are defined by Name, 3-character Short Code, Designation, Territory, and Active status. Salesmen Groups are completely hidden and not required.
  • CRM Mode (/salesmenmstindex/C): Advanced CRM view. Displays an additional Salesmen Group column and a top action button for Salesmen Group Master (salesmengroupmstindex). In CRM mode, assigning a Salesmen Group is mandatory.

3. Features ✨

The Salesmen Master provides a detailed profile for each member of the sales team:

  • 🆔 Unique Short Codes: Assign a 3-character unique identifier for quick data entry and short-hand reporting.
  • 📂 Group Categorization (CRM Mode): Organize salesmen into Salesmen Groups (e.g., “North Region”, “Technical Sales”, “Inter-company”) for aggregated reporting, with inline quick-creation directly from the dropdown.
  • 📍 Territory Mapping: Record the specific Sales Territory (e.g., “Western India”, “Middle East”) assigned to each salesman.
  • 👔 Designation Tracking: Store professional titles to define the hierarchy within the sales team.
  • đŸšĻ Lifecycle Management: Use the IsActive toggle to deactivate personnel who are no longer with the company without losing historical transaction data.
  • đŸ›Ąī¸ Reference Protection: Integrated “Delete-Check” utility prevents removing a salesman who has already been linked to live orders or invoices.

4. Complete Flow 🔄

Define Salesmen Groups (CRM Mode Only)

  • If using the CRM workflow (/salesmenmstindex/C), configure your team’s group structure either via Salesmen Group Master (salesmengroupmstindex) or directly using the "+" (Add New) option inside the autocomplete field during salesman creation.
  • Note: If operating in Sales mode (/salesmenmstindex/S), this step is omitted.

Create Salesman Profile

  • Open the Salesmen Index (/salesmenmstindex/S or /salesmenmstindex/C) and click “Create New”.
  • Enter the Salesman Name (up to 50 characters).
  • Enter a unique 3-character Salesmen Short Code.
  • Optionally specify Designation and Sales Territory (up to 100 characters each).
  • In CRM mode (ind == "C"), select or quick-add the Salesmen Group.
  • Click Save.

Assign to Transactions

  • Once saved, the salesman will appear in the dropdowns for:
    • Sales Enquiry
    • Sales Order
    • Marketing Activity
    • CRM Leads

Maintenance

  • Periodically review the list to update designations or territory changes.
  • Deactivate old records (IsActive = N) to keep dropdown lists clean for active users while preserving transaction history.

5. Validations and Error Handling âš ī¸

The system enforces strict data integrity rules:

Validation TypeWhat is checked?Error Message / Action
Uniqueness (Name)If the Salesman Name already exists.“Salesmen Name already exist.”
Uniqueness (Code)If the 3-character Short Code is taken.“Salesmen Short Name already exist.”
Referential IntegrityChecks across Order, Invoice, and Enquiry tables.“Master Record is live. You may not delete it.”
Mandatory Group (CRM Mode)If no group is picked in CRM mode (/salesmenmstcreate/C).“Salesmen Group needs to be selected.”
Length ConstraintCharacter limits for names and titles.“Salesmen Name can be upto 50 characters only.”

6. Tools / Smart Features 🔧

  • đŸ•ĩī¸ Centralized Delete Check: A background utility (GetSalesmenMstDeleteCount) that scans all transactional dependencies before allowing a master record deletion.
  • ➕ Inline Group Creation: In CRM mode, the Salesmen Group autocomplete includes an integrated “+ Add New” button so users don’t need to exit the creation form to define a new group.
  • 🎨 Integrated UI: The module uses MudDataGrid for powerful filtering, sorting, and inline search capabilities.

7. Related Reports 📊

  • 📋 Salesmen Master List: Export a full directory of sales personnel for regional mapping and audit.

8. Configuration Requirements âš™ī¸

  • đŸ–‡ī¸ Salesmen Group: Required only when operating in CRM mode (ind == "C"). Not required for Sales mode (ind == "S").
  • 📑 Permissions: Users require SalesmenMstCreate (Sales) or CrmSalesmenMstCreate (CRM) roles to add new records.

9. Best Practices / Tips 💡

â„šī¸
  • Consistent Short Codes: Use meaningful short codes like RAJ, SM1, A01 to make searching faster in high-volume transaction pages.
  • Group by Geography: If your team is large, group them by territory for easier regional sales analysis later.
  • Never Delete History: Instead of deleting a salesman who has left, always use the “IsActive = N” setting. This preserves your historical sales reports.

10. Technical Observations 🔍

âš ī¸
  • Soft Delete Logic: The application relies on active/inactive flags. Hard deletions should only be performed for erroneously created records that haven’t been used yet.
  • Dual-Context Role: Be aware that CRM and standard sales modules might use different role names (CrmSalesmenMst vs SalesmenMst) for the same master data.