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 (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/Sor/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 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 (CRM Mode) | If no group is picked in CRM mode (/salesmenmstcreate/C). | “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. - â 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
MudDataGridfor 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) orCrmSalesmenMstCreate(CRM) roles to add new records.
9. Best Practices / Tips đĄ
âšī¸
- Consistent Short Codes: Use meaningful short codes like
RAJ,SM1,A01to 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 (
CrmSalesmenMstvsSalesmenMst) for the same master data.