1. 12.1 Loans fees
1. Fee Categories
R12 Loans fees contain the following fee categories:
1. Event based fees – fees that are automatically added to loan installments by the system as result of
different events. Events include:
a. Loan origination
b. Disbursement funding
c. Conversion from disbursement to term phase (for disbursement loans only)
d. Late payment
e. Loan payoff
2. Manual fees – fees that can be manually added to loan installments or charged as standalone
manual bills
3. Recurring fees – fees that are automatically added to loan installments by the system recurrently
2. 2. Fee Calculation Methods
All fees can have one of the following calculation methods:
• Fixed - fee amount is fixed
• Variable – fee amount is calculated as percentage of some base amount
• Custom – fee amount is calculated by custom procedure provided by the user
2.1. Variable calculation method
Variable calculation method calculates fees as percentage of the following predefined based amounts:
• Original Loan Amount –originally approved loan amount
• Current Loan Amount – current approved loan amount (loan amount can be increased during after loan
is approved)
• Outstanding Principal Balance – loan outstanding principal balance
3. • Individual Disbursement Amount – individual disbursement amount; available for funding fees only
• Overdue Interest – overdue interest amount
• Overdue Principal – overdue principal amount
• Overdue Principal and Interest – sum of overdue principal and interest amounts
• Total Disbursed Amount – total amount disbursed to borrower
• Total Undisbursed Amount - total undisbursed yet amount
2.2. Custom calculation method
If fixed or variable calculation methods don’t satisfy customer’ fee calculation requirements, user is free to
implement and use their own fee calculation method. For that user must set name of Custom pls/sql
procedure (package.procedure) that handles the fee calculation according to their business requirement.
Any custom fee procedure must have the following signature (procedure name can have any name):
PROCEDURE MY_CUSTOM_FEE_CALC(
P_LOAN_ID IN NUMBER,
P_FEE_ID IN NUMBER,
P_INSTALLMENT IN NUMBER,
X_AMOUNT OUT NOCOPY VARCHAR2,
X_ERROR OUT NOCOPY VARCHAR2);
where:
P_LOAN_ID - Input Loan ID (passed by the system)
P_FEE_ID - Input fee id from lns_fees_all table (passed by the system)
P_INSTALLMENT - Input installment number (passed by the system)
X_AMOUNT - Returned fee amount value
X_ERROR - Returned error message.
Sample of custom fee procedure is implemented in LNS_SAMPLE_HOOKS.CUSTOM_FEE_CALC distributed
with any post 12.1.3 release.
4. 3. Fee Billing Options
Depends on fee category fees can have one of these billing options:
• At Submit for Approval – for origination fees only; this fee is changed when loan submitted for
approval
• At Loan Activation – for origination fees only; this fee is changed when loan become active
• With Installment – this fee is charged with next scheduled installment
• Ad-hoc – for manual fees only; this fee can be billed manually from loan manual bill page
• Recurring – for recurring fees only; this fee is automatically changed with every loan installment
• At Loan Payoff – for payoff fees only; this fee is changed during loan payoff process
• At Term Conversion – for disbursement loans only; this fee is changed during conversion from
disbursement to term phase process
5. 4. Fee Setup
To setup fees user navigates Loan Administration -> Setup -> select Operating Unit -> Fees
6. 5. Assigning fees to Loans product
All fees can be assigned to any Loans product in product Fees tab except for funding fees.
Funding fees are assigned to default disbursements in Disbursement tab -> Fees and Conditions page.
7. 6. Using fees in loans
6.1. Fees Tab
During loan creation all fees assigned to product are inherited by new loan. All inherited fees (except
funding fees) can be seen on loan Fees tab. User has ability to assign more fees to a loan using Add Fee
button, remove fees from the loan by using Remove button and update fees by using Update button.
8. 6.2. Origination Fees
Origination fees can be charged at different times of loan origination process: at submit for approval, at loan
activation and/or with 1-st loan installment.
Origination fee with “At Submit for Approval” billing option is charged when loan is submitted for approval.
This fee is billed as 0-th installment and can be viewed on loan servicing center page.
Origination fee with “At Loan Activation” billing option is charged when loan become active. This fee is
billed as 0-th installment and can be viewed on loan servicing center page.
Origination fee with “With Installment” billing option is charged with 1-st loan installment.
9. 6.3. Funding Fees
Funding fees can be assigned to individual disbursements on Funding -> Fees tab. Funding fees are billed
with first installment that has due date following actual disbursement funding date. For example, let’s say
loan’s installments are due on 1-st of every month. So, if disbursement is funded on Sep 20, then funding
fee for this disbursement will be billed in installment that is due on Oct 1.
10. 6.4. Recurring Fees
If assigned to a loan, recurring fees are automatically added to installments by the system.
11. 6.5. Manual Fees
Manual fees can be manually added to loan installments (billing option is with installment) or charged
as standalone manual bill (billing option is ad-hoc). Manual with installment fees can be charged only
when loan is in servicing. Manual ad-hoc fees can be charged during any loan stage including
origination, funding and servicing.
Adding manual fee to loan installment:
13. 6.6. Late fees
If assigned to a loan, late fees are automatically added to installments by the system if due payment is late.
14. 6.7. Payoff fees
If assigned to a loan, payoff fees are automatically added to payoff transaction list during payoff process.
15. 6.8. Conversion Fees
Conversion fees can be assigned only to disbursement phase loans. If assigned, conversion fee is billed as 0-
th installment in term phase after loan is converted.
7. Applicable patch
All above fees are included with standalone patch 9682244:R12.LNS.B - IMPORTANT FIXES ON THE TOP OF
LNS 12.1.3 RELEASE - AUG 2010. This patch can be applied on the top of 12.1.1, 12.1.2 and/or 12.1.3
releases.
