/
Early Repayment of Fees

Early Repayment of Fees

Mar 07, 2011

Early Repayment of Fees

Release:

2.1

Current Owners:

Kay Chau

Status (Draft, In Review, Stable, Approved)

Stable

Introduction

Our new customer MFI in Kenya, PAWDEP, has a business need to assign penalties to savings accounts and have them due when applied.  What PAWDEP does is that whenever a client withdraws money from their savings, they must pay 10ksH for doing the withdrawal.  This is not possible in Mifos right now as you cannot assign fees or penalties to savings accounts, nor can you have fees applied to client accounts due when they are applied (can only be due at meetings).  We need to implement a way to meet their business need.

Goals

  • Ability to apply payment of penalties before or on meeting date to the client

  • Allow partial payment of fees and penalties

Non-Goals

The following items will not be addressed in this release:

  • Decoupling of Fees schedule from Meeting Schedules

  • Only applicable to Clients, Groups and Centers - no Fees related to Savings or Loans.

Definitions and Terminology

Term

Definitions

Term

Definitions

 

 

  • Mandatory fields will be preceded by *

  • Links are italicized

  • Buttons are Button

Related Documents

Early Repayment of Fees

This will update existing Fees/Penalties functionality at the client, group, and center accounts.

User Stories and Scenarios

Priority

Size

User Stories / Scenarios

Priority

Size

User Stories / Scenarios

1

 

MFI is able to apply some sort of 1 time, upfront fee at any time.  They are also able to apply payment on it immediately instead of having it due on the next meeting.  The fee is just added to the open balance, but can be paid off before the next meeting.  Essentially you are allowed to make payments towards your fees balance at any time now instead of restricting to the next meeting. Same as prepaying.

Applying a fee ON a client's meeting date attaches the fee to TODAY's meeting IFF the meeting hasn't been paid yet.
Applying a one-time fee BETWEEN 2 meeting dates attaches the fee to the NEXT meeting
Recurring fees do not factor into "fees balance"
New recurring fees behave the same way.

2

 

Also needed but the ability to make Partial Payment - Can pay off less than balance, but then payment is applied in a certain order:

Payment is paid off in order applied.

* Overdue charges
* One-time fee
* Recurring Fee

No overpayments allowed.

Example Use Case

Branch Staff applies a one-time fee to a client with no other fees due on client's meeting date and then applies payments through CSE

Client needs to a pay a penalty for savings withdrawal.  At the meeting, LO collects a payment of 10ksH for the penalty.  During data entry in Mifos. Branch Staff needs to note that a penalty of 10ksH has been applied to the client.  Then they want to go into CSE and note all payments that were collected.

Actors

  • Branch Staff

Preconditions

  • Client has no recurring fees and no fees due at their next meeting date currently.

  • Client meets on the 5th of every month.

Basic Flow

  1. Branch Staff logs onto Mifos on the 12/5 and navigates to client.

  2. Branch Staff applies a charge of 10ksH to the client. He wants to apply payment on it immediately (before next meeting date).  Client has no other fees or penalties due.

  3. Branch Staff navigates to Collection Sheet Entry runs a collection sheet for 12/5.  Under A/C column, amount of 10ksH is listed for the client.  Branch Staff completes CSE and applies exact payment.

Post-conditions

  • Balance of client account is 0.

Validations

  •  It used to be that this charge would not show up until 1/5.

Alternate Flow

  1. At Step 3 of Basic Flow, Branch Staff applies payment of 4ksH in CSE.  CSE completes.  Balance of client account is 6ksH.

Branch Staff applies a one-time fee to a client with no other fees due on client's meeting date and then applies backdated payments through CSE

MFI staff will usually enter these after their meeting days.

Actors

  • Branch Staff

Preconditions

  • Client has no recurring fees and no fees due at their next meeting date currently.

  • Client meets on the 5th of every month.

Basic Flow

  1. Branch Staff logs onto Mifos on the 12/6 and navigates to client.

  2. Branch Staff applies a charge of 10ksH to the client. He wants to apply payment on it immediately (before next meeting date).  Client has no other fees or penalties due.

  3. Branch Staff navigates to Collection Sheet Entry runs a collection sheet for 12/5.  Under A/C column, amount of 0 is listed for the client.  Branch Staff completes CSE and applies a payment of 10ksH.

Post-conditions

  • Balance of client account is 0.

Validations

  •  Client should not be allowed to overpay

Alternate Flow

  1. At Step 3 of Basic Flow, Branch Staff applies payment of 4ksH in CSE.  CSE completes.  Balance of client account is 6ksH.

More Scenarios

Pre-Conditions

  • One-Time Charge = 10ksH

  • If Recurring Fees = 6ksH

  • Monthly meetings on the 5th of every month

Scenario #

User Applies the One-Time Charge of 10 ksH on:

Are there existing Recurring Fees?  (see Pre-Cond)

User wants to apply Payment through CSE or Individual Payment

Default Payment Due Listed
(in Payment Box, and in Account Balance displayed on Account)

User applies payment on this date and with this amount:

Was this a full or partial payment?

Open Balance After Payment

Comments

Scenario #

User Applies the One-Time Charge of 10 ksH on:

Are there existing Recurring Fees?  (see Pre-Cond)

User wants to apply Payment through CSE or Individual Payment

Default Payment Due Listed
(in Payment Box, and in Account Balance displayed on Account)

User applies payment on this date and with this amount:

Was this a full or partial payment?

Open Balance After Payment

Comments

1

On meeting date - 12/5

No

CSE

12/5 = 10

12/5 = 10

Full

0

Currently, can't pay this amount off on meeting date

2

 

No

Individual

12/5 = 10

12/5 = 10

Full

0

 

3

 

Yes

CSE

12/5 = 16

12/5 = 16

Full

0

 

4

 

Yes

Individual

12/5 = 16

12/5 = 16

Full

0

 

5

 

Yes

CSE

12/5 = 16

12/5 = 12

Partial - 12

4 (remains on one-time fee)

 

6

 

Yes

Individual

12/5 = 16

12/5 = 12

Partial - 12

4 (remains on one-time fee)

 

7

Between meetings - 12/15, no backdating, 12/5 meeting already entered

No

Individual

12/15 = 10

12/15 = 10

Full

0

 

8

=> You might want to pay off early in an Import case

Yes - already paid 12/5's

Individual

12/15 = 16

12/15 = 16

Full

0

 

9

 

Yes - already paid 12/5's

Individual

12/15 = 16

12/15 = 12

Partial - 12

4 (remains on recurring fee due next mtg)

 

10

 

Yes - didn't pay 12/5's (overdue amount)

Individual

12/15 = 22

12/15 = 22

Full

0

 

11

 

Yes - didn't pay 12/5's (overdue amount)

Individual

12/15 = 22

12/15 = 12

Partial - 12

10 (remains on one-time fee and then recurring fee for next mtg)

 

12

=> Unlikely to go into CSE on 12/15 since your 1/5 hasn't happened yet so these are for what happens when you go into Mifos on 1/5

No

CSE

1/5 CSE = 10

1/5 CSE = 10

Full

0

 

13

 

Yes - already paid 12/5's

CSE

1/5 CSE = 16

1/5 CSE = 16

Full

0

 

14

 

Yes - already paid 12/5's

CSE

1/5 CSE = 16

1/5 CSE = 12

Partial - 12

4 (remains on recurring fee)

 

15

 

Yes - didn't pay 12/5's (overdue amount)

CSE

1/5 CSE = 22

1/5 CSE = 22

Full

0

 

16

 

Yes - didn't pay 12/5's (overdue amount)

CSE

1/5 CSE = 22

1/5 CSE = 12

Partial - 12

10 (remains on one-time fee and then recurring fee)

 

17

Backdated scenario - 12/6

No

CSE

12/5 CSE = 0

12/5 CSE = 10

Full Balance

0

Error out if you try to enter in more than 10 for 12/5