# Accounting Module - User Manual for Accountants

## Table of Contents

1. [Introduction](#introduction)
2. [Getting Started](#getting-started)
3. [Chart of Accounts Management](#chart-of-accounts-management)
4. [Creating and Posting Journal Entries](#creating-and-posting-journal-entries)
5. [Generating Financial Reports](#generating-financial-reports)
6. [Fiscal Period Management](#fiscal-period-management)
7. [Common Tasks and Workflows](#common-tasks-and-workflows)
8. [Troubleshooting](#troubleshooting)

## Introduction

Welcome to the Accounting Module user manual. This guide will help you effectively manage the financial accounting operations of the microfinance institution.

### Who Should Use This Manual

This manual is designed for:
- **Accountants**: Daily transaction recording and report generation
- **Senior Accountants**: Journal entry posting and period-end processes
- **Finance Managers**: Financial analysis and fiscal period management
- **Auditors**: Review and verification of financial records

### Key Features

- **Chart of Accounts**: Manage your account structure
- **Journal Entries**: Record financial transactions
- **Financial Reports**: Generate Trial Balance, Income Statement, Balance Sheet, and Cash Flow Statement
- **Fiscal Periods**: Control accounting periods
- **Automatic Integration**: Loan and expense transactions automatically create accounting entries

## Getting Started

### Accessing the Accounting Module

1. Log in to the microfinance system using your credentials
2. Navigate to the **Accounting** menu in the main navigation bar
3. You will see the Financial Dashboard as your home screen

### Dashboard Overview

The Financial Dashboard provides a quick snapshot of your financial position:



**Dashboard Metrics:**
- Total Assets, Liabilities, and Equity
- Current month Revenue and Expenses
- Net Income for the current month
- Total Cash Balance across all accounts
- Year-to-date Income and Expenses
- Pending journal entries requiring approval

**Navigation Links:**
- Chart of Accounts
- Journal Entries
- Financial Reports
- Fiscal Periods
- Audit Log

## Chart of Accounts Management

The Chart of Accounts is the foundation of your accounting system. It contains all the accounts used to record financial transactions.

### Viewing the Chart of Accounts

1. Click **Accounting** → **Chart of Accounts**
2. You will see a list of all accounts organized hierarchically

**Account Information Displayed:**
- Account Code (e.g., 202001)
- Account Name (e.g., "Loan Portfolio")
- Account Type (Asset, Liability, Equity, Income, Expense)
- Current Balance
- Status (Active/Inactive)

### Filtering and Searching Accounts

**Filter by Type:**
1. Use the dropdown menu at the top to select account type
2. Options: All Accounts, Assets, Liabilities, Equity, Income, Expenses
3. Click **Apply Filter**

**Search by Code or Name:**
1. Enter search term in the search box
2. System searches both account codes and names
3. Results update automatically

### Creating a New Account

**Step-by-Step Instructions:**

1. Navigate to **Chart of Accounts**
2. Click the **+ Add Account** button
3. Fill in the required fields:
   - **Account Code**: Unique identifier starting from 202001 (e.g., 202010)
   - **Account Name**: Descriptive name (e.g., "Petty Cash")
   - **Account Type**: Select from Asset, Liability, Equity, Income, Expense
   - **Subtype** (optional): For Assets or Liabilities, select specific subtype
     - Asset subtypes: Current Asset, Loan Portfolio, Fixed Asset, Other Asset
     - Liability subtypes: Current Liability, Client Savings, Borrowings, Other Liability
   - **Description**: Detailed explanation of the account's purpose
   - **Parent Account** (optional): Select parent account for hierarchical structure
4. Click **Save**

**Example: Creating a Petty Cash Account**

```
Account Code: 202010
Account Name: Petty Cash
Account Type: Asset
Subtype: Current Asset
Description: Small cash amounts for daily office expenses
Parent Account: 202003 - Cash
```

### Editing an Existing Account

1. Navigate to **Chart of Accounts**
2. Click on the account you want to edit
3. Click the **Edit** button
4. Modify the fields as needed
5. Click **Save**

**Note:** You cannot change the Account Code once created. System accounts (marked with a lock icon) have restricted editing.

### Deactivating an Account

If an account is no longer needed:

1. Open the account detail page
2. Click **Deactivate Account**
3. Confirm the action

**Important:** You cannot deactivate an account if:
- It has child accounts (deactivate children first)
- It has been used in posted journal entries
- It is a system account

### Viewing Account Transactions

1. Click on any account in the Chart of Accounts
2. The account detail page shows:
   - Account information
   - Current balance
   - Recent transactions (last 20)
3. Click **View Full Analysis** for complete transaction history

## Creating and Posting Journal Entries

Journal entries are the primary method for recording financial transactions in the system.

### Understanding Journal Entry Status

- **Draft**: Entry is saved but not yet posted to the general ledger
- **Posted**: Entry has been posted and affects account balances
- **Reversed**: Entry has been reversed by a correcting entry

### Creating a Manual Journal Entry

**Step-by-Step Instructions:**

1. Navigate to **Accounting** → **Journal Entries**
2. Click **+ Create Journal Entry**
3. Fill in the header information:
   - **Transaction Date**: Date of the transaction (cannot be in the future)
   - **Description**: Clear description of the transaction
   - **Branch**: Select the branch (if multi-branch operation)

4. Add line items:
   - Click **+ Add Line**
   - **Account**: Select from Chart of Accounts (use search/dropdown)
   - **Description**: Line-specific description
   - **Debit**: Enter debit amount (if applicable)
   - **Credit**: Enter credit amount (if applicable)
   
5. Add at least 2 line items
6. Ensure total debits equal total credits (shown at bottom)
7. Click **Save as Draft**

**Important Rules:**
- Each line must have either a debit OR a credit (not both)
- Total debits must equal total credits
- Minimum 2 line items required
- Transaction date must be in an open fiscal period

### Example: Recording Office Rent Payment

**Scenario:** Paid KES 50,000 for January rent via bank transfer

```
Transaction Date: 2024-01-05
Description: January 2024 office rent payment
Branch: Head Office

Line Items:
1. Debit  - 501001 (Rent Expense)          KES 50,000.00
           Description: January office rent
2. Credit - 202004 (Bank Account)                        KES 50,000.00
           Description: Payment for rent

Total Debits:  KES 50,000.00
Total Credits: KES 50,000.00
Status: Balanced ✓
```

### Dynamic Line Item Management

While creating a journal entry:

**Adding Lines:**
- Click **+ Add Line** button
- New row appears at the bottom
- Fill in account, description, and amount

**Removing Lines:**
- Click the **X** icon on the right of the line
- Line is removed immediately
- Totals recalculate automatically

**Real-Time Balance Check:**
- As you enter amounts, totals update automatically
- If debits ≠ credits, indicator shows "Unbalanced" in red
- When balanced, indicator shows "Balanced" in green

### Account Search/Autocomplete

When selecting an account:
1. Start typing the account code or name
2. Dropdown shows matching accounts
3. Select from the list
4. Account details appear (code, name, current balance)

### Posting a Journal Entry

Once a draft entry is ready to post:

1. Navigate to **Journal Entries**
2. Click on the draft entry you want to post
3. Review all line items carefully
4. Click **Post Entry** button
5. Confirm the action

**What Happens When You Post:**
- Entry status changes from "Draft" to "Posted"
- All line items are written to the General Ledger
- Account balances are updated
- Entry becomes immutable (cannot be edited or deleted)
- Timestamp and your username are recorded

**Validation Checks:**
- Debits must equal credits
- All accounts must be active
- Transaction date must be in an open fiscal period
- Branch must be valid

If any validation fails, you'll see an error message explaining the issue.

### Reversing a Posted Journal Entry

To correct an error in a posted entry:

1. Open the posted journal entry
2. Click **Reverse Entry** button
3. Enter:
   - **Reversal Date**: Date for the reversal (usually today)
   - **Reason**: Explanation for the reversal
4. Click **Confirm Reversal**

**What Happens:**
- Original entry status changes to "Reversed"
- New entry is created with opposite debits/credits
- New entry is automatically posted
- Both entries remain in the system for audit trail
- Original entry shows link to reversal entry

**Example:**

Original Entry:
```
DR: Rent Expense       50,000
    CR: Bank Account           50,000
Status: Reversed (See reversal entry #JE-2024-00125)
```

Reversal Entry:
```
Reference: JE-2024-00125
DR: Bank Account       50,000
    CR: Rent Expense           50,000
Description: Reversal of JE-2024-00100 - Reason: Incorrect amount
Status: Posted
```

### Viewing Journal Entry Details

1. Navigate to **Journal Entries**
2. Click on any entry
3. Detail page shows:
   - Entry header (reference, date, description, status)
   - All line items with accounts, debits, credits
   - Total debits and credits
   - Audit information (created by, posted by, timestamps)
   - Linked loan or expense (if applicable)
   - Reversal information (if reversed)

### Filtering Journal Entries

**Filter by Status:**
- Draft Only
- Posted Only
- Reversed Only
- All Entries

**Filter by Date Range:**
1. Select start date
2. Select end date
3. Click **Apply Filter**

**Filter by Branch:**
- Select branch from dropdown
- Click **Apply Filter**

Multiple filters can be combined.

## Generating Financial Reports

The accounting module provides comprehensive financial reports for analysis and compliance.

### Trial Balance Report

The Trial Balance verifies that total debits equal total credits across all accounts.

**Generating the Report:**

1. Navigate to **Accounting** → **Reports** → **Trial Balance**
2. Select parameters:
   - **As of Date**: Report date (usually month-end or today)
   - **Branch**: Specific branch or "All Branches"
3. Click **Generate Report**

**Report Contents:**
- All active accounts with non-zero balances
- Accounts grouped by type (Assets, Liabilities, Equity, Income, Expenses)
- Debit and credit balance columns
- Subtotals for each account type
- Grand totals for debits and credits
- Balance indicator (Balanced/Unbalanced)

**Interpreting the Trial Balance:**

✓ **Balanced:** Total debits = Total credits (system is in balance)
✗ **Unbalanced:** Total debits ≠ Total credits (investigation required)

If unbalanced, review recent journal entries for errors.

**Exporting:**
- Click **Export to PDF** for formatted report
- Click **Export to Excel** for data analysis

### Income Statement (Profit & Loss)

The Income Statement shows revenues, expenses, and net income for a period.

**Generating the Report:**

1. Navigate to **Reports** → **Income Statement**
2. Select parameters:
   - **Start Date**: Beginning of period (e.g., 2024-01-01)
   - **End Date**: End of period (e.g., 2024-01-31)
   - **Branch**: Specific branch or "All Branches"
3. Click **Generate Report**

**Report Structure:**

**Income Section:**
- Interest Income from loans
- Fee Income (processing fees, late fees)
- Other Income
- **= Gross Income**

**Expense Section:**
- Operating Expenses (rent, utilities, supplies)
- Staff Costs (salaries, benefits)
- Loan Loss Provisions
- Other Expenses
- **= Total Expenses**

**Bottom Line:**
- **Net Income = Gross Income - Total Expenses**

**Analysis Tips:**
- Compare current month to previous month
- Calculate income ratios (expenses/income)
- Monitor expense trends
- Identify cost-saving opportunities

**Exporting:**
- PDF format for board presentations
- Excel format for detailed analysis

### Balance Sheet (Statement of Financial Position)

The Balance Sheet shows the organization's financial position at a specific date.

**Generating the Report:**

1. Navigate to **Reports** → **Balance Sheet**
2. Select parameters:
   - **As of Date**: Report date (usually month-end)
   - **Branch**: Specific branch or "All Branches"
3. Click **Generate Report**

**Report Structure:**

**Assets:**
- Current Assets (Cash, Bank, Receivables)
- Loan Portfolio
- Fixed Assets (Office Equipment, Vehicles)
- Other Assets
- **= Total Assets**

**Liabilities:**
- Current Liabilities (Payables)
- Client Savings/Deposits
- Borrowings (from banks/institutions)
- Other Liabilities
- **= Total Liabilities**

**Equity:**
- Share Capital
- Retained Earnings
- Current Period Net Income
- **= Total Equity**

**Accounting Equation:**
```
Total Assets = Total Liabilities + Total Equity
```

The report includes a balance verification indicator. If the equation doesn't balance, investigate for errors.

**Analysis Tips:**
- Monitor liquidity (current assets vs current liabilities)
- Track loan portfolio growth
- Evaluate capital adequacy
- Assess debt-to-equity ratio

### Cash Flow Statement

The Cash Flow Statement shows how cash moved during a period using the indirect method.

**Generating the Report:**

1. Navigate to **Reports** → **Cash Flow Statement**
2. Select parameters:
   - **Start Date**: Beginning of period
   - **End Date**: End of period
   - **Branch**: Specific branch or "All Branches"
3. Click **Generate Report**

**Report Structure:**

**Operating Activities:**
- Net Income (from Income Statement)
- Add: Depreciation and Amortization (non-cash)
- Changes in Working Capital:
  - Increase in Receivables (use of cash)
  - Increase in Payables (source of cash)
- **= Net Cash from Operating Activities**

**Investing Activities:**
- Purchase of Fixed Assets (use of cash)
- Sale of Fixed Assets (source of cash)
- **= Net Cash from Investing Activities**

**Financing Activities:**
- New Borrowings (source of cash)
- Loan Repayments (use of cash)
- Equity Contributions (source of cash)
- Dividends Paid (use of cash)
- **= Net Cash from Financing Activities**

**Cash Reconciliation:**
- Beginning Cash Balance
- \+ Net Increase/(Decrease) in Cash
- **= Ending Cash Balance**

The report includes a reconciliation indicator to verify the calculation.

### Account Analysis Report

The Account Analysis provides detailed transaction history for a specific account.

**Generating the Report:**

1. Navigate to **Reports** → **Account Analysis**
2. Select parameters:
   - **Account**: Choose account from dropdown
   - **Start Date**: Beginning of period
   - **End Date**: End of period
3. Click **Generate Report**

**Report Contents:**
- Account header (code, name, type)
- Opening balance at start of period
- All transactions with:
  - Date
  - Description
  - Reference number
  - Debit amount
  - Credit amount
  - Running balance
- Period totals (total debits, total credits)
- Closing balance at end of period

**Use Cases:**
- Reconcile bank accounts
- Investigate account discrepancies
- Audit trail review
- Detailed transaction analysis

## Fiscal Period Management

Fiscal periods control when transactions can be recorded and enable period-end processes.

### Understanding Fiscal Periods

**Period Types:**
- **Monthly**: January 2024, February 2024, etc.
- **Quarterly**: Q1 2024, Q2 2024, etc.
- **Annual**: FY 2024, FY 2025, etc.

**Period Status:**
- **Open**: Transactions can be recorded for dates in this period
- **Closed**: No transactions allowed; period is locked

### Viewing Fiscal Periods

1. Navigate to **Accounting** → **Fiscal Periods**
2. View list of all periods
3. See name, type, date range, and status

### Creating a New Fiscal Period

1. Click **+ Create Period**
2. Fill in:
   - **Period Name**: e.g., "January 2024"
   - **Period Type**: Monthly, Quarterly, or Annual
   - **Start Date**: First day of period
   - **End Date**: Last day of period
3. Click **Save**

New periods are created as "Open" by default.

**Best Practice:** Create periods in advance (e.g., create all 12 months at year start).

### Closing a Fiscal Period

At period-end (usually month-end):

1. Navigate to **Fiscal Periods**
2. Click on the period to close
3. Click **Close Period** button
4. System performs validation:
   - All journal entries for the period are posted
   - Trial balance is balanced
   - No draft entries remain
5. Review closing balances
6. Confirm closure

**What Happens:**
- Period status changes to "Closed"
- Closing balances are calculated and saved
- No new entries can be created for this period
- Closing balances become opening balances for next period
- Timestamp and your username recorded

### Reopening a Fiscal Period

If corrections are needed after closing:

1. Navigate to **Fiscal Periods**
2. Click on the closed period
3. Click **Reopen Period** button
4. Enter reason for reopening
5. Confirm action

**Note:** Reopening requires special permission (usually Finance Manager role).

### Period-End Checklist

Before closing a period:

- [ ] All loan disbursements and repayments are recorded
- [ ] All expenses are approved and recorded
- [ ] All manual journal entries are posted
- [ ] Bank reconciliations are complete
- [ ] Trial balance is balanced
- [ ] Generate and review all financial reports
- [ ] Save PDF copies of reports
- [ ] No draft entries remain

## Common Tasks and Workflows

### Task 1: Monthly Bank Reconciliation

**Goal:** Match bank statement with accounting records

**Steps:**

1. Generate Account Analysis report for Bank Account
   - Select bank account (e.g., 202004)
   - Date range: First to last day of month
   - Export to Excel

2. Obtain bank statement for the month

3. Compare transactions:
   - Check off matching transactions
   - Identify unrecorded bank transactions
   - Identify outstanding checks

4. Create journal entries for unrecorded items:
   - Bank fees
   - Interest earned
   - Direct deposits
   - Electronic payments

5. Verify ending balances match

### Task 2: Recording Loan Write-Off

**Scenario:** Loan #12345 is deemed uncollectible, write off KES 100,000

**Journal Entry:**
```
Transaction Date: 2024-01-15
Description: Write-off of uncollectible loan #12345

DR: Allowance for Loan Losses    100,000.00
    CR: Loan Portfolio                       100,000.00
```

**Steps:**

1. Create journal entry with above details
2. Post entry
3. Update loan status in loan system to "Written Off"
4. Document decision in loan file

### Task 3: Recording Asset Purchase

**Scenario:** Purchased office computer for KES 80,000, paid by cheque

**Journal Entry:**
```
Transaction Date: 2024-01-20
Description: Purchase of office computer

DR: Office Equipment (Fixed Asset)   80,000.00
    CR: Bank Account                            80,000.00
```

### Task 4: Recording Staff Salary Payment

**Scenario:** Paid January salaries totaling KES 500,000 via bank

**Journal Entry:**
```
Transaction Date: 2024-01-31
Description: January 2024 staff salaries

DR: Salaries Expense           500,000.00
    CR: Bank Account                      500,000.00
```

### Task 5: Correcting an Error

**Scenario:** Accidentally recorded rent expense as KES 50,000 instead of KES 40,000

**Steps:**

1. Locate the incorrect journal entry
2. Click **Reverse Entry**
3. Enter reversal date and reason: "Incorrect amount"
4. Confirm reversal
5. Create new correct journal entry:
   ```
   DR: Rent Expense        40,000.00
       CR: Bank Account               40,000.00
   ```
6. Post the new entry

## Troubleshooting

### Problem: Cannot Post Journal Entry

**Error:** "Debits do not equal credits"

**Solution:**
- Review all line items
- Verify amounts are entered correctly
- Check for missing lines
- Use calculator to verify totals
- Look at the balance indicator at bottom of form

**Error:** "Period is closed for this date"

**Solution:**
- Check the transaction date
- Verify fiscal period status
- If correction is needed, request period reopening from Finance Manager
- Or change transaction date to current open period

**Error:** "Account [code] is inactive"

**Solution:**
- The account has been deactivated
- Use a different active account
- Or request account reactivation from supervisor

### Problem: Trial Balance Doesn't Balance

**Investigation Steps:**

1. Note the difference amount
2. Check if any recent entries equal the difference (might be unposted)
3. Review recently posted entries for errors
4. Generate Account Analysis for accounts with large balances
5. Check for entries with only debit or only credit lines
6. Run data integrity check: Contact system administrator

### Problem: Financial Reports Show Unexpected Results

**Diagnostic Steps:**

1. Verify correct date range selected
2. Check branch filter (should it be "All Branches"?)
3. Review recent journal entries for period
4. Generate Trial Balance first to verify system balance
5. Compare to previous period reports for unusual changes
6. Review account classifications in Chart of Accounts

### Problem: Integration Not Creating Accounting Entries

**Scenario:** Loan disbursed but no journal entry created

**Solution:**
1. Check if loan status is "Active"
2. Verify fiscal period is open for disbursement date
3. Check system error logs (contact IT support)
4. Manually create journal entry if needed
5. Report issue to system administrator

### Problem: Cannot Close Fiscal Period

**Error:** "Unposted entries exist"

**Solution:**
- Go to Journal Entries
- Filter by "Draft" status
- Post or delete all draft entries
- Try closing again

**Error:** "Trial balance is unbalanced"

**Solution:**
- Generate Trial Balance report
- Note the imbalance amount
- Investigate and correct the issue
- Ensure all entries for the period are balanced

## Getting Help

### Support Resources

**Documentation:**
- README.md - Module overview and technical details
- API_DOCUMENTATION.md - API reference (if using REST API)
- This User Manual

**System Support:**
- Contact IT Help Desk for technical issues
- Email: support@your-institution.com
- Phone: +254-XXX-XXXXXX

**Accounting Questions:**
- Contact Finance Manager
- Senior Accountant
- Refer to organization accounting policies

### Training Resources

New users should complete:
1. Chart of Accounts overview training
2. Journal entry creation workshop
3. Financial reports interpretation
4. Period-end closing procedures

Contact HR for training schedule.

---

**Document Version:** 1.0.0  
**Last Updated:** January 2025  
**Prepared By:** Microfinance Development Team

*This manual is a living document and will be updated as new features are added to the accounting module.*