Accounts
1. Overview
The Accounts module in Sumo Ledger provides a comprehensive view of all accounts in the system, organized by product. Each account belongs to a product type (e.g., customer, loan, user_holdings) and represents a financial entity — such as a customer account, a payable ledger, or a holdings account.
The module offers account lifecycle tracking (opening and dormancy trends), product-level summaries, and detailed account-level information including balances and metadata.
Navigation: Accounts (main sidebar menu)
URL: https://las.ledger.raralabs.dev/product-accounts
2. Accounts Overview Page
2.1 New Account Opening vs Dormant Chart
A dual-axis bar chart showing:
- Opened (left axis): The number of new accounts opened per day.
- Dormant (right axis): The number of accounts that became dormant per day.
A Date Range filter controls the time window displayed (e.g., 2026-06-13 to 2026-07-13).
2.2 Search
A search bar allows you to filter products by name.
2.3 Tabs
- Accounts by products: Displays all products that have at least one account, along with account statistics.
- Products without Accounts: Lists products that have been configured but do not yet have any accounts created under them.
2.4 Accounts by Products Table
| Column | Group | Description |
|---|---|---|
| Products | — | The product name (e.g., customer, loan). Clicking navigates to the account list for that product. |
| Active | Accounts Overview | Number of accounts in Active state. Sortable. |
| Dormant | Accounts Overview | Number of accounts in Dormant state. Sortable. |
| Total | Accounts Overview | Total number of accounts for this product. Sortable. |
| Opened | Last 30 Days | Number of new accounts opened in the last 30 days. |
| Dormant | Last 30 Days | Number of accounts that became dormant in the last 30 days. |
| Total | Last 30 Days | Total account activity (opened + dormant) in the last 30 days. |
3. Product Account List
Clicking a product name opens the account list for that product.
3.1 Page Header
Breadcrumb: Accounts > [product_name] (e.g., Accounts > customer).
3.2 Summary Cards
- Account Opened: Count of accounts opened in the selected date range.
- Account Dormant: Count of accounts that became dormant.
3.3 Chart
A dual-axis chart showing opened vs. dormant accounts over time for this specific product.
3.4 Actions
| Element | Description |
|---|---|
| Date Range | Filter by date range. |
| Filter | Dropdown filter for narrowing results by specific fields. |
| Search | Free-text search across account fields. |
| View | Toggle table layout or visible columns. |
| Import Account (.csv) | Bulk-import accounts from a CSV file. |
| + Add Account | Open the form to create a new account manually. |
3.5 Account List Table
The table displays all accounts for the selected product with the following columns:
| Column | Description |
|---|---|
| Account Ref Id | The external reference ID for the account (e.g., a CIF number, national ID, or custom reference). |
| Account Name | The display name of the account. |
| Account Owner | The name of the account holder. |
| Account Number | The system-generated unique account number. |
| Reporting Group Id | The reporting group this account belongs to (e.g., default_reporting_group). |
| State | The current state of the account (e.g., ACTIVE, DORMANT). |
| boid | Beneficiary Owner ID, if applicable. |
| phone_number | Contact phone number associated with the account. |
| is_freeze | Whether the account is frozen (e.g., Pending, Completed). |
| account_number | An additional account number field for reference. |
| Email address associated with the account. | |
| gender | Gender of the account holder. |
Note: The visible columns may vary based on the product configuration and the custom fields defined for that product.
Accounts are grouped by creation date (e.g., 25-May-26 (1), 12-May-26 (1)) for easier navigation.
4. Creating a New Account
Click "+ Add Account" to open the account creation form. The form fields depend on the product's account configuration (defined in Configurations > Product). Common fields include:
- Account Ref Id: A unique external reference (e.g., a customer ID or registration number).
- Account Name: The display name for the account.
- Account Owner: The name of the account holder.
- Reporting Group: The reporting group to assign this account to.
- Additional custom fields as defined in the product configuration.
5. Importing Accounts
Click "Import Account (.csv)" to bulk-import accounts from a CSV file. The CSV headers must match the field names expected by the product's account configuration.
6. Best Practices
- Use meaningful Account Ref IDs. These are the primary way to look up accounts externally. Use identifiers like CIF numbers or national IDs.
- Assign accounts to the correct reporting group. This ensures they appear in the right financial reports.
- Monitor the overview page for dormancy trends. A rising dormancy rate may indicate issues with account engagement.
- Use CSV import for bulk account creation. This is especially useful during system migration or onboarding.
- Check the "Products without Accounts" tab to identify products that may need initial account setup.