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:

It identifies the Lead Owner in the Sales Enquiry and Marketing modules.
It assigns Operational Responsibility to Sales Orders and Invoices.
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

The module is shared between standard sales and CRM:

Identification: Displays the auto-generated Salesmen No.
Profile: Shows the Name, Designation, and whether the record is Active.

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: Organize salesmen into Salesmen Groups (e.g., “North Region”, “Technical Sales”, “Inter-company”) for aggregated reporting.
📍 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

Navigate to the Salesmen Group Index.
Create groups using the “Create New” button to define your team’s structure (e.g., by geography or expertise).

Create Salesman Profile

Go to the Salesmen Index and click “Create New”.
Enter the Salesman Name and a unique Short Code.
Select the appropriate Salesmen Group.
Define the Designation and Sales Territory.

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 to keep dropdown lists clean for active users.

5. Validations and Error Handling ⚠️

The system enforces strict data integrity rules:

Validation Type	What 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 Integrity	Checks across Order, Invoice, and Enquiry tables.	“Master Record is live. You may not delete it.”
Mandatory Group	If no group is picked.	“Salesmen Group needs to be selected.”
Length Constraint	Character 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.
🎨 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: Groups must be created before individual salesmen can be added.
📑 Permissions: Users require SalesmenMstCreate or CrmSalesmenMstCreate 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.

Order Status Master Transfer Price Master