Customer Master in ERPNext (Detailed Guide)
A Customer, also known as a client, buyer, or purchaser, is an individual or organization that receives goods, services, or products from a seller in exchange for monetary value. In ERPNext, the Customer Master is a core record used throughout the selling and accounting process.
Every customer must be assigned a unique identifier, which can either be the customer name itself or a system-generated naming series configured under Selling Settings.
To access the Customer list, navigate to:
Home > Selling > Customers
1. Creating a Customer in ERPNext
To create a new customer record in ERPNext, follow these steps:
- Open the Customer list and click on New.
- Enter the Full Name of the customer.
- Select the Type:
- Individual – for personal customers
- Company – for business customers
- Select a Customer Group (e.g., Individual, Commercial, Non Profit, Government). Custom groups can also be created based on business needs.
- Assign a Territory to define geographic segmentation.
- If the customer originates from a lead, select the lead in the From Lead field.
- Click Save to create the customer record.
The Customer form can also be populated in bulk using the Data Import Tool.
2. Key Features of Customer Master
The Customer Master in ERPNext is designed to support complete customer lifecycle management and integrates tightly with sales and accounting modules.
2.1 Transaction Flow
The typical flow of customer-related transactions is:
Quotation → Sales Order → Delivery Note → Sales Invoice → Payment Entry
This ensures end-to-end tracking from sales initiation to payment completion.
2.2 Multiple Contacts and Addresses
ERPNext allows linking multiple contacts and addresses to a single customer record. This is useful when dealing with large organizations that have multiple communication points or billing/shipping locations.
Contacts and addresses are stored separately but can be linked dynamically to customer transactions.
2.3 Sales Invoice Flexibility
Depending on configuration in Selling Settings, ERPNext may require a Sales Order or Delivery Note before invoicing.
However, for specific customers, these rules can be bypassed by enabling:
– Allow Sales Invoice Without Sales Order
– Allow Sales Invoice Without Delivery Note
This provides flexibility for special billing scenarios.
2.4 Tax Withholding Configuration
Customers can be linked to a Tax Withholding Category to manage TCS or similar statutory requirements where applicable. This ensures correct tax treatment during invoice generation.
2.5 Currency and Price List Control
ERPNext supports multi-currency transactions and multiple pricing structures.
You can configure:
– Billing Currency – default currency for transactions
– Default Price List – pricing scheme applied automatically
This is especially useful for businesses operating in multiple regions or markets.
2.6 Accounting Integration
ERPNext does not require individual customer ledgers by default. Instead, all customers are mapped to a unified Debtors Ledger.
If required, separate ledgers can be created under Accounts Receivable in the Chart of Accounts and linked to a specific customer.
ERPNext also supports multi-company setups where the same customer can be used across multiple companies with separate accounting structures.
2.7 Credit Limit and Payment Terms
A Credit Limit can be defined for each customer to control exposure and manage risk.
Additionally, default Payment Terms Templates can be assigned to automate due dates and installment structures in invoices.
2.8 Sales Team and Sales Partner Mapping
ERPNext allows assigning internal salespersons and external partners to customers.
– Sales Team: Internal employees responsible for managing the account, with commission distribution if multiple members are involved.
– Sales Partner: External agents, distributors, or affiliates who earn commission based on sales contribution.
2.9 Loyalty Program Integration
Customers can be enrolled in a Loyalty Program to reward repeat purchases and improve customer retention through points or discount-based systems.
2.10 Ledger and Receivables View
ERPNext provides quick access to financial insights:
– Accounting Ledger: Displays complete transaction history
– Accounts Receivable: Shows outstanding invoices and pending payments
These tools help finance teams monitor customer balances in real time.
2.11 Customer Naming and Configuration Settings
Customer IDs can be configured in multiple ways:
– Naming Series: System-generated unique IDs based on predefined patterns
– Customer Name: Uses the actual name as the identifier
Default settings like Customer Group, Territory, and Price List can also be preconfigured in Selling Settings for faster data entry.
3. Summary
The Customer Master in ERPNext is a centralized structure that manages identity, transactions, credit control, communication, and accounting integration, ensuring seamless coordination between sales and finance operations.
4. Related Topics
- Customer Group
- Quotation
- Price List
- Contact Management
- Lead vs Contact vs Customer
