Party Master
Party Master - User Guide
1. Introduction π
The Party Master is the central repository for managing all external entities your business interacts with, primarily Customers, Suppliers, and Sundry parties. It acts as a bridge between operational modules (Sales/Purchase) and the Financial Accounting module.
Key Objectives of Party Master:
- Financial Linking: Link operational parties to specific Ledger Accounts (Control Accounts).
- Statutory Compliance: Manage PAN, GSTIN, MSME, and TDS details.
- Credit Control: Enforce Credit Limits and Credit Periods to manage financial risk.
- Logistics Management: Support multiple branches/delivery locations for a single party.
2. Getting Started with Party Master π
Accessing the Module
To access the Party Master module, navigate to the Common Masters > Party section from the main menu.
The Index Page
Upon opening, the Index Page displays a comprehensive list of all existing Parties. Here, you can:
- Search/Filter: Filter parties by Party ID, Short Name, Party Type, or Active Status using expandable filter drawers.
- Quick Navigation: Click on a Party ID to view its full details.
- Action Buttons:
- Create New: Open the standard manual party registration form.
- Create from GST: Fetch government GST portal records to auto-populate party identity or add a branch.
- Export to Excel: Download the complete party directory.
- Import: Bulk onboard parties via spreadsheet (initial setup).
- Other Features: Jump to auxiliary setup masters (Party Group, Segment, Category, Payment Terms).

Create Party / Branch from GST Search β‘
Clicking Create from GST (/partymstcreatefromgst) streamlines onboarding and eliminates data entry errors:
- GSTIN / URP Search: Enter a 15-character GSTIN (or type
URPfor unregistered persons followed by a 10-character PAN). - Automated Taxpayer Fetch: The system queries statutory databases to retrieve legal trade name, principal business address, state code, and pincode.
- Smart Entity Mapping:
- If the PAN does not exist in your ERP, the system lets you create a brand-new party.
- If existing parties already share this PAN, a selector allows you either to create a distinct new party or append this location as a new Branch under the existing party.
Party Details & Operational Controls
Selecting a party from the index opens the Party Details view:
- Core Identity: Party Type, Legal Name, Short Name, Group, Category, Segment, and linked Control Account.
- Statutory & Operational Flags: PAN No, MSME Registration, ITC Eligibility, E-Invoice Mandatory flag, and Default Transaction Types.
- Allow Invoice for Party: A direct toggle to permit or suspend invoicing for this party without altering account ledger configurations.
- Modify Party Type: For active parties, allows administrators to migrate party classifications (e.g., Customer to Supplier or Sundry) and remap the control ledger without deleting the party or corrupting historical records.
- Re-Activate Party: For inactive parties (
IsActive == 'N'), provides an instant re-activation shortcut. - Branch Index: Direct navigation to inspect and maintain delivery and billing branches.

Other Features & Links
Clicking on “Other Features” provides access to a dedicated menu of linked configuration masters:
- Group / Segment / Category Master: For organizing parties into logical reporting segments.
- Payment Term Master: To define standard credit terms and payment cycles.

3. Structural Breakdown ποΈ
The Party Master follows a two-tier hierarchy to support complex multi-location business operations:
Tier 1: Main Party (Master Level)
Contains core business governance and global financial terms:
- Unique Identity: Auto-generated
PartyIdand businessShort Name. - Classification: Party Type (Customer, Supplier, Sundry), Party Group, Category, Segment, and Region.
- Operational Controls: Assigned Sales Officer, Allow Invoice toggle, Multiple Orders in Single Invoice flag.
- Financial Terms: Credit Limit, Credit Period (days), Cash Discount percentage, and Payment Terms.
- Statutory & Tax Setup: Centralized PAN number, MSME number, ITC Eligibility (Input Tax Credit), and E-Invoice Mandatory status.
- Accounting Links: Linked Control Account (Chart of Accounts), TDS Code, Default Invoice Trn Type, and Bill Trn Type.
Tier 2: Branches / Locations (Unit Level)
Contains unit-level logistics and tax destinations:
- Address Management: Multi-line delivery and billing addresses, City, State, and Pincode.
- GST Identification: State-specific GSTIN (supporting multi-state GST registration under a shared PAN).
- Statutory Codes: Unit-level TCS codes and dispatch plant codes.
4. Business Validations & Rules π‘οΈ
To protect data consistency and financial reporting, the system enforces the following business validations:
| Feature | Validation Rule |
|---|---|
| Control Account Mapping | The linked Ledger Account must strictly align with the Party Type (e.g., a Supplier must link to Sundry Creditors / Trade Payable control accounts). |
| PAN Format Integrity | Validates against the standard 10-character Indian PAN format (ABCDE1234Z). |
| GSTIN State Matching | The first two digits of any entered GSTIN must mathematically match the selected state’s statutory GST code. |
Duplicate PAN & GSTIN (SpecialAuth) | The system checks for duplicate PANs across parties and duplicate GSTINs across branches. Rather than an abrupt hard rejection, the system triggers Special Authorization (SpecialAuth)βprompting for a supervisor OTP verification before proceeding. |
| Credit Boundaries | Credit Period must fall between 0 and 999 days; Credit Limit must fall between 0 and 99,999,999. |
5. Bulk Management (Import / Export) π
Managing high-volume party master directories is streamlined via spreadsheet utilities:
- Export to Excel: Exports the complete master directory along with branch mappings for audit and review.
- Download Model: Downloads the standard Excel template titled
ImportPartyMst.xlsx. - Initial Onboarding Constraint: Bulk import is strictly permitted only when the Party Master is empty (
0 records). Once master records exist, the import option is disabled with the notice “Records already exists. You may not Import.” This ensures that live operational databases cannot be overwritten or corrupted through bulk uploads. - Universal Pre-Import Audit: Uploaded spreadsheets undergo rigorous two-tier audits (Z-codes for data layout and AβZ logic codes for state codes, group codes, and duplicate detection) before any record is committed.
6. Lifecycle & Data Integrity π
Data integrity is mission-critical for the Party Master, as it directly impacts Financial Ledgers.
π Modification & Audit Trails
- Audit Notes: If the system’s Audit Trail is enabled, users must provide a reason (“Audit Trail Notes”) for any modification to an existing party.
- Change Detection: The system automatically logs exactly which fields were changed (e.g., changing a Credit Limit from 50k to 100k).
π« Deletion Safety Protocols
Deletions are strictly controlled to prevent “orphaned” financial entries:
- Direct Usage Check: The system scans Vouchers, JVs, and Opening Balances for any entries linked to the
Control Account + Party ID. - Reason Required: A mandatory “Delete Reason” must be provided for every deletion, which is then logged in the system’s Audit Trail.
- Hierarchical Block: You cannot delete a Main Party if it has active Branches. You must delete branches first (if they have no usage).
7. Integration & Reports π
The Party Master is a primary filter and data provider for:
- Sales/Purchase Analysis: Reports sorted by Party Segment, Category, or Group.
- Outstanding Reports: Debtors and Creditors aging are driven by the Credit Period defined here.
- Statutory Reports: GST-1, GST-3B, and TDS/TCS filings rely on the PAN and GSTIN data stored in the Party Master.
- RTGS/NEFT Management: Bank account details (managed via RTGS Master) are linked to these Party IDs.
8. Best Practices π‘
- Consistent Short Names: Use Short Names (Aliases) for quick searching in transaction screens.
- Regular Address Audits: Ensure GSTINs are updated for branches annually, especially if a party migrates from “Unregistered” to “Registered”.
- State Accuracy: Double-check the State Code before entering GSTIN to avoid validation errors during invoice generation.