Migrating to ERPNext: Setting Opening Balances
When migrating from a legacy accounting system to ERPNext, you must import your opening balances to establish the financial starting point.
Important
Before migrating data, you must close the books of accounting in your old system. This ensures that your total assets equal your total liabilities, which is crucial for an accurate opening balance.
Key Concepts
- Opening Balances: These are the balances of all your ledger accounts on the day you officially start using ERPNext.
- Data Complexity:
- Simple Balances: Some accounts, like Cash or Bank, only require a single dollar value.
- Detailed Balances: Other accounts, like Creditors (Accounts Payable), require more detail, such as supplier names and individual unpaid invoice numbers.
- Temporary Opening Account: A special ledger (
Temporary Opening) is used to balance debit and credit entries during the import process. Once all opening balances are correctly imported, the balance of this account should become zero.
Importing Opening Balances: Step-by-Step
ERPNext provides specific tools for different types of opening data.
1. General Ledger Balances
Used for simple account balances like cash, bank accounts, etc.
- Tool: Journal Entry
- Path:
Accounting > General Ledger > Journal Entry - Process:
- Create a new Journal Entry.
- Set the Entry Type to
Opening Entry. - The system will populate a table with your accounts from the Chart of Accounts.
- Enter the opening balance for each account in the appropriate Debit or Credit column.
- Use the
Temporary Openingaccount to ensure the total debits equal total credits. - Save and Submit.
2. Fixed Assets
Used for importing physical or virtual assets with existing depreciation.
- Tool: Asset DocType
- Path:
Assets > Masters > Asset - Process:
- Create a new Asset.
- Fill in the asset details (name, item code, location).
- Check the Is Existing Asset checkbox.
- Enter the Gross Purchase Amount, Purchase Date, and
Available-for-use Date. - Input the Opening Accumulated Depreciation value as of the migration date.
- Save and Submit the asset.
- Create a corresponding Journal Entry to update the related fixed asset and accumulated depreciation ledgers.
3. Opening Inventory
Used to set the initial stock levels for your items in each warehouse.
- Tool: Stock Reconciliation
- Path:
Stock > Tools > Stock Reconciliation - Process:
- Create a new Stock Reconciliation.
- Set the Purpose to
Opening Stock. - In the items table, specify the Item Code, Warehouse, Quantity, and Valuation Rate.
- You can also specify Batch Numbers and Serial Numbers if applicable.
- Set the Difference Account to
Temporary Opening. - Save and Submit.
Tip
For a large number of items, use the Download/Upload feature to prepare your stock data in a spreadsheet.
4. Unpaid Invoices
Used to import outstanding sales (receivables) and purchase (payables) invoices.
- Tool: Opening Invoice Creation Tool
- Path:
Accounting > Opening and Closing > Opening Invoice Creation Tool - Process:
- Select the Company.
- Choose the Invoice Type (
SalesorPurchase). - In the table, enter details for each outstanding invoice, including Party Name (Client/Vendor) and Total Outstanding Amount.
- Use the spreadsheet template for bulk import if needed.
- Click Create Invoices.
