Introduction

Al Majmoua currently handles all repayments of loans by clients by having clients deposit their repayments directly at a bank, and then Al Majmoua is able to download online a file of these recorded transactions to import their MIS.  They need the ability to do this in Mifos as well.  See related Business requirements for more detail.

User Stories (Epics)

Goals

• Ability to import file of loan repayment transaction details into Mifos

• Transaction History in Mifos accurately shows loan payments.

Non-Goals

The following items will not be addressed in this release:

• Importing bank transactions from any bank other than Audi Bank

• No import of attendance, savings, fees, or loan disbursal information - only loan repayments are imported.

• Additional logging of import than what we do already in Mifos for logging

Definitions and Terminology

• Mandatory fields will be preceded by *

• Links are italicized

• Buttons are Button

Related Documents

• Business Requirements

Import Bank Transactions

This feature is in the Admin section and will allow the User to import bank transactions

Use Cases

Administrator assigns permissions to accountant to import bank transactions

Actors

•  Administrator

Preconditions

•  None

Basic Flow

1. Administrator logs onto Mifos and navigates to the Admin section. Administrator selects Manage Roles and Permissions. Administrator selects the role for accountants.

2. Mifos displays all possible permissions for the role and Administrator scrolls down to "Bulk". Administrator confirms that "Can import transactions" is checked.

Post-conditions

• Accountant role has permission to import bank transactions

Alternative Flows

• None

Validations

• None

Accountant imports transactions (Audi Bank) - file with no errors

Actors

• Accountant

Preconditions

•  Accountant has permissions to import transactions

• Accountant has file in xls (Excel 97 format) to import

Basic Flow

1. Accountant logs onto Mifos and navigates to the Admin section. Accountant selects Import transactions.

2. Mifos displays new screen for Import Transactions.

3. Accountant selects Audi Bank Excel 97 or Audi Bank TSV for bank, and selects file from their computer for import. Accountant clicks on Continue.

4. Mifos imports file and checks for any errors (see Validations below). If there are no errors, Mifos displays Review & Submit screen with "There are no errors found. Click Submit to continue with import.".

5. Accountant clicks on Submit. Mifos displays confirmation screen that import was successful.

Post-conditions

• All data available in the file has been imported and all the correct tables and loan account data correctly populated.

Validations

• If a row has a cell that's empty in a required column is empty, that row is rejected and appropriate error message displayed.

• No bad data - ie, no numbers in columns that require text and vice versa. Date of Transaction is in date format YYYY/MM/DD if it's a TSV file, or does not follow the expected format of that column. See FR's below.

Alternative Flows

Accountant cancels Import

1. At step 4, Accountant clicks on Cancel instead. Mifos returns User to the Admin screen.

Post-conditions

• No data has been imported.

Import has errors and Accountant chooses to continue

1. At step 4, Mifos determines there are errors from Validations above.  Mifos displays Review & Submit screen with error messages depending on types of error.

2. Accountant chooses to continue with import of the valid rows and clicks on Submit.   Mifos displays confirmation screen that import was successful.

Post-conditions

• Valid rows are imported and invalid rows are rejected.

Import has errors and Accountant chooses to Cancel

1. At step 4, Mifos determines there are errors from Validations above.  Mifos displays Review & Submit screen with error messages depending on types of error.

2. Accountant chooses to cancel and clicks on Cancel instead. Mifos returns User to the Admin screen.

Post-conditions

• No data has been imported.

Import has errors and Accountant chooses to import a different file

1. At step 4, Mifos determines there are errors from Validations above.  Mifos displays Review & Submit screen with error messages depending on types of error.

2. Accountant chooses to import a different file and clicks on Edit Import Information instead. Mifos returns User to the previous screen.  Return to Step 2 of Basic Flow.

Post-conditions

• No data has been imported.

Loan Officer checks data has been updated

Actors

• Loan Officer

Preconditions

• Loan Officer has permissions to view clients loan data

• Administrator has already imported data for that date.

Basic Flow

1. Loan Officer logs onto Mifos and navigates to client A's loan account.

2. Mifos displays Transaction History. Loan Officer confirms that a repayment has been updated correctly.

Post-conditions

•  None

Alternative Flows

Loan Officer doesn't see the data updated

1. Loan Officer selects a client who did not pay for the date of transaction the Administrator had imported.

2. Loan Officer goes to view that client's transaction history and sees that no transaction has been made.

Accountant imports bank transactions (generic) - P2

Actors

• Accountant

Preconditions

•  Accountant has permissions to import bank transactions

Basic Flow

1. Accountant logs onto Mifos and navigates to the Admin section. Accountant selects Import bank Transactions.

   1. OR Accountant clicks on link in Quick Start - Import bank Transactions

2. Mifos displays new screen for Import Bank Transactions.

3. Accountant enters date of transaction (defaulted to today). and selects file from their computer for import. File follows generic format set by Mifos.

   1. Accountant can select up to 5 custom fields they want data imported from the file to map to.  Ie - they select custom Field "Serial" and enter in column name "Serial" where the import will map to that column.  No validations are done on custom field columns.

   2. Accountant clicks on Continue.

4. Mifos imports file and checks for any errors (see Validations below). If there are no errors, Mifos displays Review & Submit screen with "There are no errors found. Click Submit to continue with import.".

5. Accountant clicks on Submit. Mifos returns the Accountant to the Admin screen.

Post-conditions

• All data available in the file has been imported and all the correct tables and loan account data correctly populated.

Validations

• If any cell in a required column is empty  entire import is rejected with appropriate error message.

• No bad data - ie, no numbers in columns that require text and vice versa. Date of Transaction is in date format MM/DD/YYYY or does not follow the expected format of that column. See FR's below.  This is only for columns required in generic format - there is no validation done on Custom fields.

Alternative Flows

User Stories

Import Bank Transactions (Audi Bank) Functional Requirements

Add new permission

Add new screen for Import Bank Transactions (Audi Bank)

Import File Details and Validations (Audi)

Audi Bank Import Columns and Description