You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@fineract.apache.org by "oleksii-novikov-onix (via GitHub)" <gi...@apache.org> on 2026/01/09 12:20:10 UTC
[PR] FINERACT-2413: Add re-amortization documentation [fineract]
oleksii-novikov-onix opened a new pull request, #5306:
URL: https://github.com/apache/fineract/pull/5306
## Description
Describe the changes made and why they were made. (Ignore if these details are present on the associated Apache Fineract JIRA ticket.)
## Checklist
Please make sure these boxes are checked before submitting your pull request - thanks!
- [ ] Write the commit message as per [our guidelines](https://github.com/apache/fineract/blob/develop/CONTRIBUTING.md#pull-requests)
- [ ] Acknowledge that we will not review PRs that are not passing the build _("green")_ - it is your responsibility to get a proposed PR to pass the build, not primarily the project's maintainers.
- [ ] Create/update [unit or integration tests](https://fineract.apache.org/docs/current/#_testing) for verifying the changes made.
- [ ] Follow our [coding conventions](https://cwiki.apache.org/confluence/display/FINERACT/Coding+Conventions).
- [ ] Add required Swagger annotation and update API documentation at fineract-provider/src/main/resources/static/legacy-docs/apiLive.htm with details of any API changes
- [ ] [This PR must not be a "code dump"](https://cwiki.apache.org/confluence/display/FINERACT/Pull+Request+Size+Limit). Large changes can be made in a branch, with assistance. Ask for help on the [developer mailing list](https://fineract.apache.org/#contribute).
Your assigned reviewer(s) will follow our [guidelines for code reviews](https://cwiki.apache.org/confluence/display/FINERACT/Code+Review+Guide).
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@fineract.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] FINERACT-2413: Add re-amortization documentation [fineract]
Posted by "adamsaghy (via GitHub)" <gi...@apache.org>.
adamsaghy merged PR #5306:
URL: https://github.com/apache/fineract/pull/5306
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@fineract.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] FINERACT-2413: Add re-amortization documentation [fineract]
Posted by "adamsaghy (via GitHub)" <gi...@apache.org>.
adamsaghy commented on code in PR #5306:
URL: https://github.com/apache/fineract/pull/5306#discussion_r2682225420
##########
fineract-doc/src/docs/en/chapters/features/re-amortization.adoc:
##########
@@ -0,0 +1,250 @@
+= Loan Re-Amortization
+
+== Overview
+
+Re-amortization recalculates EMI (Equal Monthly Installment) amounts for remaining installments based on the outstanding principal balance as of the current business date.
+
+=== Example
+
+A customer has a 1000 EUR loan with 4 monthly installments of 250 EUR each. After missing the first two payments (500 EUR overdue), re-amortization redistributes this amount across the remaining 2 installments, resulting in 500 EUR per installment instead of 250 EUR - without changing due dates or adding new installments.
+
+=== Re-Amortization vs Re-Aging
+
+[cols="1,2,2",options="header"]
+|===
+| Aspect | Re-Amortization | Re-Aging
+
+| Schedule structure
+| Preserves existing installment count and due dates
+| Creates new installments with user-defined count, start date, and frequency
+
+| User input
+| Only interest handling type
+| Start date, number of installments, period type, frequency, interest handling
+
+| Use case
+| Redistribute overdue principal across existing future installments
+| Restructure loan for customers in payment difficulty
+|===
+
+== Supported Loan Type
+
+Re-amortization is only available for:
+
+* **Progressive** loan schedule type
+* **Advanced Payment Allocation** strategy
+* For interest-bearing loans: **interest recalculation must be enabled**
+
+== Eligibility Criteria
+
+* Loan must be **active** (disbursed and not closed)
+* Transaction date must be **before or on maturity date**
+* Loan must **not** be charged-off
+* Loan must **not** be contract terminated
+* Only **one** re-amortization transaction is allowed per business day
+
+== Interest Handling Types
+
+For **interest-bearing loans**, re-amortization supports three strategies:
+
+[cols="1,3",options="header"]
+|===
+| Type | Description
+
+| `DEFAULT`
+| Standard behavior - outstanding principal is redistributed across remaining installments
+
+| `WAIVE_INTEREST`
Review Comment:
Please remove "Waive interest"
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@fineract.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] FINERACT-2413: Add re-amortization documentation [fineract]
Posted by "oleksii-novikov-onix (via GitHub)" <gi...@apache.org>.
oleksii-novikov-onix commented on code in PR #5306:
URL: https://github.com/apache/fineract/pull/5306#discussion_r2687433016
##########
fineract-doc/src/docs/en/chapters/features/re-amortization.adoc:
##########
@@ -0,0 +1,250 @@
+= Loan Re-Amortization
+
+== Overview
+
+Re-amortization recalculates EMI (Equal Monthly Installment) amounts for remaining installments based on the outstanding principal balance as of the current business date.
+
+=== Example
+
+A customer has a 1000 EUR loan with 4 monthly installments of 250 EUR each. After missing the first two payments (500 EUR overdue), re-amortization redistributes this amount across the remaining 2 installments, resulting in 500 EUR per installment instead of 250 EUR - without changing due dates or adding new installments.
+
+=== Re-Amortization vs Re-Aging
+
+[cols="1,2,2",options="header"]
+|===
+| Aspect | Re-Amortization | Re-Aging
+
+| Schedule structure
+| Preserves existing installment count and due dates
+| Creates new installments with user-defined count, start date, and frequency
+
+| User input
+| Only interest handling type
+| Start date, number of installments, period type, frequency, interest handling
+
+| Use case
+| Redistribute overdue principal across existing future installments
+| Restructure loan for customers in payment difficulty
+|===
+
+== Supported Loan Type
+
+Re-amortization is only available for:
+
+* **Progressive** loan schedule type
+* **Advanced Payment Allocation** strategy
+* For interest-bearing loans: **interest recalculation must be enabled**
+
+== Eligibility Criteria
+
+* Loan must be **active** (disbursed and not closed)
+* Transaction date must be **before or on maturity date**
+* Loan must **not** be charged-off
+* Loan must **not** be contract terminated
+* Only **one** re-amortization transaction is allowed per business day
+
+== Interest Handling Types
+
+For **interest-bearing loans**, re-amortization supports three strategies:
+
+[cols="1,3",options="header"]
+|===
+| Type | Description
+
+| `DEFAULT`
+| Standard behavior - outstanding principal is redistributed across remaining installments
+
+| `WAIVE_INTEREST`
Review Comment:
Done
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@fineract.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org