Mifos User Documentation Portal
  • Overview and Background
    • History and Background
    • Mifos Vision, Mission & Values
    • Who Mifos is For
    • How Mifos is Used
    • The Mifos Stack
      • Overview
    • Mifos v/s Fineract
    • Community app v/s Webapps
  • General Contributing Guidelines
    • Upstream Development Approach
      • Contribution Process
      • The Apache Way
    • Contributors Guide
    • Contribution Guidelines: Android Project
    • Contribution Guidelines: Web Project
  • Getting Started
    • Getting started with Git & Github
    • Postman integration with Gitbook for testing
    • Testing framework-Web
    • Testing framework-Android
    • Mifos CI/CD tools and instructions
  • External 3rd Apps
    • Pentaho Reporting Plugin
    • Payment Hub
  • MifosX
    • Overview
    • User Manual
      • How to Use This Manual
      • For All Users
        • General Navigation
          • Sign In Page
          • Welcome Page
          • Dashboard Page
          • List Page
          • Menu Page
          • Form Page
          • Clients-Groups-Centers Navigation
          • Navigation Tool
          • Global Search
          • Loan Product and Accounting with Mifos
        • Reports
          • Standard Reports Shipped in Mifos X
          • Standard Reports Field Descriptions
          • Custom Reports
            • Creating Simple Pentaho Report and Embedding it to Mifos X
          • XBRL Reporting
      • For Administrators (Mifos X Platform)
        • Initial System Set Up
        • Administration
          • Users
          • Organization
            • Manage Offices
            • Currency Configuration
            • Manage Holidays
            • Manage Funds
            • Manage Employees
            • Bulk Loan Reassignment
            • Standing Instructions History
            • Teller / Cashier Management
            • Fund Mapping
            • Working Days
            • Password preferences
            • Payment type
            • Loan Provisioning Criteria
            • SMS Campaigns
            • Message Gateway Configuration
            • Daily Teller Cash Management
            • Entity Data Table Checks
          • System
            • Manage Data Tables
            • Audit Trails
            • Manage Codes
            • Manage Reports
            • Manage Roles and Permissions
            • Manage Scheduler Jobs
            • Configure Maker-Checker Tasks
            • Global Configuration
            • Manage Hooks
              • Steps for creating sms bridge
            • Account Number Preferences
            • Entity To Entity Mapping
              • External Services
          • Products
            • Loan Products
              • Loan Product Fields
                • Accounting Loan Product Fields
                • Configuring and Disbursing of Top-Up Loan
                • Declining Balance Interest Calculation
                • Enabling Floating Rate
                • Enabling Variable Installments
                • Flat interest calculation
                • Loan Product Fields—Additional Fields for Loans with Variable Terms based on Loan Cycle
                • Recalculate Interest
                • Tranche Loan Fields
              • Setting up Minimum Days between Disbursal and First Repayment
              • Product Mix
            • Charges
            • Floating Rate
            • Savings Products
              • Saving Product Fields
                • Accounting Saving Product Fields
            • Fixed Deposit Products
              • Fixed Deposit Product Fields
                • Accounting Fixed and Recurring Deposit Product Fields
              • Interest rate chart with amount range
            • Recurring Deposit
              • Recurring Deposit Product Fields
            • Interest Calculations for Deposit Products
            • Overdraft Product
            • Share products
              • Dividends
            • Manage Tax configuration
          • Templates
          • mifos dropdown
        • Clients, Groups and Centers
          • Manage Clients
            • Client Life Cycle Statuses
            • Client Relationship Management
          • Manage Groups
          • Manage Centers
        • Accounting
          • Chart of Accounts - General Ledger Setup
            • Default COA sql script
          • Accounts linked to Financial Activities
          • Migrate opening balances (Office-wise)
          • Accounting Rules
          • Provisioning Entries
          • Print General Ledger Listing
          • How To Enter GL Opening Balance
        • Configure Notifications
      • For Operational Users (Mifos X Web App)
        • Accounting operations
          • Add Journal Entries
          • Searching Accounting Transactions
          • Frequent Postings
          • Advanced Accounting Rules
          • Closing Entries
          • Accruals
        • Accounts and Transactions
          • Cash Transaction Processing
          • Deposit Accounts
            • Mifos X Saving Accounts
              • How to Activate a Saving Account
              • How to Add a Charge to a Saving Account
              • How to Approve a Saving Account Application
              • How to Calculate Interest for a Saving Account
              • How to Close a Saving Account
              • How to Create a Saving Account Application
                • Saving Account Fields
              • How to create overdraft account (Draft)
              • How to Delete a Saving Account Application
              • How to Make a Deposit to a Saving Account
              • How to Make a Withdrawal from a Saving Account
              • How to Modify a Saving Account Application
              • How to Post Interest to a Saving Account
              • How to Reject a Saving Account Application
              • How to Transfer funds from a Saving Account
              • How to Withdraw a Saving Account Application
            • Standing Instructions
              • How to Set up a Standing Instruction
                • Standing Instruction Form Fields
            • Term Deposit Accounts (Fixed Deposit / Recurring Deposit)
              • How to Activate a Term Deposit Account
              • How to Add a Charge to a Term Deposit Account
              • How to Approve a Term Deposit Account Application
              • How to Calculate Interest for a Term Deposit Account
              • How to Create a Term Deposit Account Application
                • Term Deposit Account Fields
              • How to Delete a Term Deposit Account Application
              • How to Make a Deposit to a Recurring Term Deposit Account
              • How to Modify a Term Deposit Account Application
              • How to Post Interest to a Term Deposit Account
              • How to Reject a Term Deposit Account Application
              • How to Withdraw a Term Deposit Account Application
            • Creating Recurring Deposit Account:
          • Loan Accounts
            • How to Create a Loan Account Application
              • Loan Account Fields
            • How to Make Repayments on a Client Loan Account
            • Track Loan Performance History
            • How to Approve a Loan Account Application
            • How to Add a Charge to a Loan Account
            • How to Modify a Loan Account Application
            • How to Assign a Loan Officer
            • How to Reject a Loan Account Application
            • How to Withdraw a Loan Account Application
            • How to Delete a Loan Account Application
            • How to Add Collateral to a Loan Account
            • How to Add/Remove/Modify a Guarantor to a Loan Account
            • How to Manage Loan Account Disbursement
            • How to Make Repayments on a Group Loan Account
            • Using collection sheet or other payment types for making payments
            • How to Waive Interest for a Loan Account
            • How to Write-off a Loan Account
            • How to Close a Loan Account as Rescheduled
            • How to Close a Loan Account
            • Making Prepay of the loan
            • How to Prepay a Loan Account
            • How To Create Group Loan Account
            • How to Process Bulk JLG Loan Application
            • How to generate - Loan transactions report
            • How to reschedule loan
            • How to provide floating rates
            • How to provide variable installments
            • How to create new loan - Interest Recalculation
            • Tranche loan process
            • Loan with term vary based on loan cycle
            • How to Place Guarantee Funds On-Hold?
          • Overdraft account
          • Saving Accounts
            • How To Create Group Saving Account
          • Share Accounts
        • Checker Inbox & Tasks
      • Side Bar - Features
        • Checker inbox and tasks
        • Collection sheet
        • Help.
        • Individual collection sheet
        • Keyboard short-cuts
        • Navigation
      • Others - mifos dropdown
        • Help
        • Profile
        • Settings
          • Date format
          • Language
        • Signout
      • Data Import Tool
        • Getting started with - Data Import Tool
        • Installing Data Import Tool
      • Glossary of Terms
      • Index
      • Reporting Documentation
      • Mobile Money Tool
    • User Space
      • New Feature Request Content
      • Recommended System Requirement
      • MifosX Overview
      • Installation guide
        • Upgrading Mifosx
        • Install MifosX on Windows
        • Install MifosX on Linux
        • Install MifosX on AWS
      • Release Notes
        • Release 1 and Features List
        • Release 2 and Features List
      • User Manual
        • How to Use This Manual
        • For All Users
          • General Navigation
            • Sign In Page
        • For Administrators
          • Initial System Set Up
        • For Operationals
      • Roadmap
      • Frequently Asked Questions (FAQs)
      • Demo Server Details
    • Developer Space
      • Setting Up Dev Environment
        • Setting up Frontend - community-app
      • Setting up MifosX from latest builds
      • Contributors Guide
      • Customising MifosX
      • Additional features
        • Data import tool
        • SMS campaigns
        • Pentaho reports
      • How Mifosx works
      • Adding a new tenant to MifosX instance
      • Using REST client for testing
      • API documentation
      • Scaling MifosX
      • Upgrading MifosX
      • Troubleshooting guide
  • Core Banking & Embedded Finance
    • Core Banking
      • Overview
    • Embedded Finance
      • Overview
  • Application Framework
    • Payment Hub EE
  • Main Platforms
    • Fineract 1.x
      • Apache Fineract
      • Apache Fineract Client
    • Fineract CN
      • Overview
      • User Manual
  • Staff UI Platforms
    • Fineract 1.x
      • Community-App
      • Web-App
      • Web Self-Service App
        • Online Banking App 2.0 User Manual
          • Developer Environment Setup for Online Banking App 2.0
      • Mobile Field Officer Applications
        • Android Client
          • User Manual
    • Fineract CN
      • Digital Bank User Interface
      • Mobile Field Officer Applications
        • Fineract CN Mobile
  • Customer UI Platforms
    • Fineract 1.x
      • Mobile Banking
        • Mifos Mobile
      • Mobile Wallets
      • Online Banking
    • Fineract CN
      • Mobile Banking
        • Fineract CN Mobile
        • Mifos Mobile CN
      • Mobile Wallets
      • Online Banking
  • Ancillary Tools
    • Fineract 1.x
      • Message Gateway
      • Mifos Passcode
      • PPI Vision
      • DevOps Tooling
      • Fineract Android SDK
      • MifosX Admin
      • Mifos ChatBot
      • Data Import Tool
    • Fineract CN
      • Fineract CN Containers
      • Fineract CN Terraform
  • Payment and Process Orchestration
    • Fineract 1.x
      • Payment Hub
      • Fineract Pentaho
    • Fineract CN
      • Staff Interfaces
        • Digital Bank UI
      • Customer Interfaces
        • Fineract CN Mobile
        • Mifos Mobile CN
        • Fineract CN Mobile
      • Ancillary Tools
        • Fineract CN Terraform
        • Fineract CN Containers
    • Payment Hub EE
Powered by GitBook
On this page
  • Details
  • Currency
  • Terms
  • Settings
  • Interest Recalculation
  • Loan Tranche Details
  • Configurable terms & settings
  • Charges
  • Overdue Charges
  • Accounting
  • View Loan Product
  • Edit Loan Product

Was this helpful?

  1. MifosX
  2. User Manual
  3. For Administrators (Mifos X Platform)
  4. Administration
  5. Products

Loan Products

PreviousProductsNextLoan Product Fields

Last updated 5 years ago

Was this helpful?

Loan products define the rules, default settings, and constraints for a financial institution's lending offerings. A loan product provides a template for multiple loan accounts for the financial institution's clients.

The information required to set up a loan product includes:

  • Identifying or descriptive information

  • Currency information

  • Terms

  • Settings

  • Tranche

  • Charges

  • Accounting

Beginning at the main screen, select Admin, then Products from the drop-down menu. This will launch the Products menu.

Select Loan Products.

The Loan Products page will be displayed as shown below;

Click on the blue "Create Loan Product" shown on the image above.

Details

Note: All red colored asterisk mark are mandatory fields.

Please refer to the above Details - Image, Mentioned details below are updated with respect to the provided fields numbers.

1 - Provide Loan Product name .(Mandatory)

2 - Provide Short name. (Mandatory)

3 - Provide description of this product.

4 - Select Fund source. Need to have defined required funds: Manage Funds.

5 - Provide Loan product Start date.

6 - Provide Loan product Close date. Note - Loan product cannot be used after this date.

7 - On checking the check box, it captures the number of loans taken by the customer.

Currency

  • 8 - Select Currency (Mandatory). Need to have defined required currency: Currency Configuration

  • 9 - Provide Decimal places (Mandatory).

  • 10 - Provide Currency in multiples of (Mandatory). This is to provide total amount rounding off. For example: 10, so Total amount gets rounded off to 10's.

  • 11 - Provide Installment in multiples of (Mandatory). This is to provide installment rounding off. For example: 10, so Installment amount gets rounded off to 10's.

Terms

Section A: Defining Loan term for normal loan product. Note: - If your loan product is based on Loan cycle - Jump to Section B.

  • 12 - Provide Principal (Loan) amount, Default field is a mandatory field. Minimum and Maximum are optional fields wherein the loan amount cannot be provided beyond the min & max value.

Example: Minimum: 5000, Default: 10000 & Maximum: 15000. At the loan account level default values will be shown.

  • 13 - Provide Number of repayments, Default field is a mandatory field. Minimum and Maximum are optional fields wherein the number of repayments cannot be provided beyond the min & max value.

Example: Minimum: 5, Default: 10 & Maximum: 15. At the loan account level default values will be shown.

  • 14 - Provide Rate of Interest, Default field is a mandatory field. Minimum and Maximum are optional fields wherein the rate of interest cannot be provided beyond the min & max value.

Example: Minimum: 18, Default: 22 & Maximum: 24. At the loan account level default values will be shown.

  • 15 - Select Per month or Per year for Rate of Interest.

Example: Per year.

  • 16 - Provide Repaid Every value

Example: 1

  • 17 - Select Day or Week or Bi-weekly or Month

Example: Week

18 - This is an optional field. This could be used in case you want to set "Minimum days between disbursal and first repayment date".Example: 10 (Days), So if the loan disbursement is on January 1st and normal expected first repayment is on 8th January,If you are providing 10 days as minimum days between disbursal and first repayment date, the first repayment will happen on 11th Jan. OrSection B: If your loan product is based on Loan cycle.

19 - Check the check box to enable "Terms vary based on loan cycle".

20 - Provide values in principal section. Click on Add button to define Principal by loan cycle.In the image above:

21 - Equals - Loan cycle as 1 with Principal Default amount of 10000. (Had there been one more cycle, it could be defined as Equals - loan cycle as 2 with principal amount)

22 - Greater than - Loan cycle as 1 with Principal Default amount of 20000. Greater than should always be used for the last cycle.

23 - Define Number of repayments by loan cycles in the same way. Then continue defining other steps from Section A - 14 to 18.

Settings

  • 24 - Select Amortization: Depending upon the type of amortization you practice, select one. Equal Installments - All repayment amounts will be equal but the principal and interest amounts will vary with each repayment. Or Equal Principal Payments - All principal amounts will be equal but the repayment and interest amounts will vary with each repayment.

  • 25 - Select Interest method: Depending upon the type of interest method you practice, select one.Flat, For formula reference - Flat interest calculation Or Declining Balance, For formula reference - Declining Balance Interest Calculation

  • 26 - Select Repayment strategy: The repayment strategy determines the sequence in which each of the components is paid. For more information on Repayment strategies: Loan Product Fields - Repayment strategy.

  • 27 - Select Interest calculation period: Daily - Will Calculate the interest on DAILY basis example: Month of February has 28 days and it will calculate interest for 28 days, Or SAME AS REPAYMENT PERIOD - it calculates for the month, that is, 30 days.

  • 28 - Provide Moratorium (Optional):

    • On Principal Payment is '6' and the client's Repayment Frequency is every month, then for the first six months, the client has to pay Interest only and after six months the client starts paying principal amount too.

    • On Interest Payment is '6' and the client's Repayment Frequency is every month, then for the first six months, the client has to pay Principal only and after six months the client starts paying Interest amount too.

    • 29 - Provide Interest free period (Optional): If the Interest Free Period is '4' and the client's Repayment Frequency is every week, then for the first four weeks the client need not to pay interest, he has to pay principal due for that week only.

  • 30 - Provide Arrears tolerance (Optional): With 'Arrears tolerance' you can specify a tolerance amount and if the loan is behind (in arrears), but within the tolerance, it won't be classified as 'in arrears' and part of the portfolio at risk.

  • 31 - Select Days in year: Depending upon your organizations financial days select accordingly.

    Actual - Will consider number of days with respect to actual calendar. Or 360 days Or 364 days Or 365 days.

  • 32 - Select Days in Months: Depending upon your organizations financial practice select accordingly.

    Actual - Will consider number of days with respect to actual calendar. Or 30 days.

  • 33 - Provide "Allow fixing of installment amount" (Optional): On checking the check box it enables providing the installment amount manually at the loan account level. Example: If the repayment amount every installment is 107 and you want to it to be 105. On providing 105 amount manually, it automatically adjusts the schedule for all the repayments.

  • 34 - Number of days a loan may be overdue before moving into arrears (Optional): Loan Product Fields

  • 35 - Maximum number of days a loan may be overdue before becoming a NPA - non performing asset (Optional): Loan Product Fields

  • 36 - Account moves out of NPA only after all arrears have been cleared?: On checking the check box, Loans which are NPA will only move out of NPA only after all arrears have been cleared.

  • 37 - Principal Threshold (%) for Last Installment:

Interest Recalculation

38 - On checking the check box for "Recalculate Interest" - It will enable Interest recalculation. For more information on Interest recalculation refer - Interest Amount Recalculation for Loan Accounts.

Guarantee Requirements

39 - On checking the check box will enable "Place Guarantee Funds On-Hold".

40 - Mandatory Guarantee (%): This is to provide total % of loan amount as mandatory guarantee. Example: 20 %.

41 - Minimum Guarantee from Own Funds (%): Example: 10 % of loan amount from Own funds.

42 - Minimum Guarantee from Guarantor Funds (%): Example: 10 % of loan amount from Guarantor Funds.

Loan Tranche Details

Note: If your loan product is tranche loan, then providing the details you could create product.

43 - Checking the check box will enable Multiple disbursal's.

44 - Provide the maximum number of disbursements allowed for a loan account.

45 - Provide maximum outstanding loan account balance at a point in time.

Configurable terms & settings

46 - By default "Allow overriding select terms and settings in loan accounts" is checked (Enabled). If you don't want to allow over ridding for the mentioned categories, then you could un-check the box.

Charges

In order to use Add charge, you should have already defined it in charges. For more information on charges refer here: Charges

Overdue Charges

In order to use Add overdue charge, you should have already defined it in charges. For more information on charges refer here: Charges

Accounting

By default Accounting will be disabled - None:- Meaning If you are using this product for various transactions like disbursement, repayment etc. These transactions are not passed in journal entry. Enabling accounting for the loan product:->> You should have created chart of accounts, for info refer: https://mifosforge.jira.com/wiki/display/docs/Chart+of+Accounts+and+General+Ledger+Setup.>> To enable Accounting, you need to select either one of the account type below, depending upon your organization accounting practice.

  • Cash

  • Accrual (periodic)

  • Accrual (upfront)

>> Map accounts with respect to the loan product accounts. For information on these accounts refer: A Possible accounting Spec - Accounting rules for loans

Advanced Accounting Rule

On clicking on the show button, it enables Advanced accounting rule.

If you click on Add button, it will expand and show up selection drop-downs.

  • Configure Fund sources for Payment Channels. Example: In the shown image above, Payment type - Cheque is mapped to Fund source - Bank. So whenever payment type is used for transaction, journal entry for Account - Bank will be passed.

  • Map Fees to Income Accounts.

  • Map Penalties to Specific Income Accounts.

Click on Submit button to Save/Create loan product.

View Loan Product

Go to Admin>>Product>>Loan Products

In the image above showing Loan products list.

Edit Loan Product

Go to Admin>>Product>>Loan Products>>Select loan product (Example: Agriculture loan) >> then click on Edit button.

In the image above, View - Loan products details as well as you can Edit Loan product.

Mifos X provides the ability to restrict loan account holding combinations not allowed by a financial institution. Use the Product Mix capability to define your financial institutions restrictions.

A loan account is a specific instance of a loan product, with a specified interest rate and an account number, and it is owned by a financial institution client.

Related articles

  • Page:Savings Products

  • Page:Loan Products

  • Page:Share products

  • Page:Fixed Deposit Products

  • Page:Loan with term vary based on loan cycle