Loan type settings explained
This is what every field on a loan type does: the loan term, interest rate, loan fee and loan charge, grace periods, default interest, late penalty, split instalments, minimum months of service, the minimum wage to loan ratio, the import settings and approvers. Use it when you set up a loan type, or to work out why an employee's loan request was refused.
Where: Benefits › Team Benefits › the settings (cog) menu › Loan Types › a loan type
You need: the Loan Type Settings right with write access to change these fields
How to find out why a loan request was refused
- Note the exact message the employee saw.
- Find it in the Message column of the table at the end of this article.
- Open the loan type and check the setting named there.
- If the setting is right, fix the employee's profile instead, for example their hire date, basic wage or contract expiry date.
To set up a new type step by step, see Loan types.
When these settings apply
The limits and terms apply when an employee requests a loan, and when you import a loan with Calculate Loan set to Yes. They do not apply to a loan you record with Add Loan on Team Loans, which is saved exactly as you enter it.
Each loan copies the type's interest, fee, grace, default interest and split settings when it is created. Changing the type later changes only new loans.
Loan type
| Field | What it does |
|---|---|
| Name | Required, up to 64 characters, unique in your company (capitals ignored). It shows on the loan, the request and every report. |
| Description | Optional, up to 512 characters. It shows under the name in the list of loan types. |
Names that become SSS codes. On the SSS Loan Report, a type named SSS Salary Loan shows as S, SSS Calamity Loan as C, SSS Emergency Loan as E, SSS LRP as 4 and SSS SLERP as 1. Any other name shows in full. Capitals don't matter; spelling does.
Terms
| Field | What it does | Default |
|---|---|---|
| Minimum months and Maximum months | The range of repayment terms an employee can choose, in months. Each must be at least 1, and the minimum can't be above the maximum. | Blank, no limit |
| Installment period | How often instalments fall. Required. The list also offers other periods, but only Monthly is accepted. | – |
| First installment grace (Months) | Months added to the loan's start date before the first instalment. 2 means repayment starts two months after the start date. | 0 |
| Loan Fee (%) | A fee as a percentage of the loan amount. Required; 0 means none. | 0 |
| Loan charge | A fixed fee in your currency. It is added to the percentage fee, not used instead of it. The loan's fee is Loan charge plus Loan Fee (%) of the amount. | 0 |
| Split Installment | For employees paid semi-monthly or bi-weekly, splits each monthly instalment across their pay periods. Employees paid monthly are not affected. | Off |
| Do not include default installments in payslip | On: an instalment that has become overdue (status Default) is not deducted in payroll, so it stays unpaid until a payment is recorded. Off: payroll deducts it with the next payslip. | Off |
| Charge late penalty | On: an overdue instalment also gets a late charge at the loan's own yearly interest rate. | Off |
| Minimum amount and Maximum amount | The range a request can borrow. The minimum must be at least 1, and can't be above the maximum. | Blank, no limit |
| Yearly interest rate | Interest per year, in %. KAMI turns it into a daily rate (yearly ÷ 365) and works out equal instalments over the term. 0 means the amount is simply divided across the instalments. Required. | – |
| Default interest rate and Period | A charge on an overdue instalment: this % of the unpaid amount for each day (Daily) or month (Monthly) it is overdue. Fill in both or neither. | Blank, none |
| Drawdown notice (Days) | The loan's start date must be at least this many days after the day it is requested. Not checked on imports. | 0 |
| Payment grace and Period | How long after each instalment date it can stay unpaid before it becomes overdue, in days (Daily) or months (Monthly). Fill in both or neither. | 0 |
| Requires Loan Account Number | On: a request must include a loan account number, for example the number the SSS or Pag-IBIG gave the loan. It shows on the SSS Loan Report. | Off |
KAMI works out default interest and late charges each night while an instalment stays overdue. The overdue amount then appears in the instalment, and payroll deducts it unless Do not include default installments in payslip is on.
Credit scoring
| Field | What it does |
|---|---|
| Minimum months of service | Whole months from the employee's hire date to the day they request. At least 1 if you set it. The employee must have a hire date on their profile. The refusal message shows the limit in years. |
| Minimum wage to loan ratio | The employee's basic wage for one pay period, divided by the instalment, must be at least this number. 3 means an instalment can be no more than a third of one pay period's basic wage. |
Import Settings
These three only apply when you import loans with Calculate Loan set to Yes. They never affect an employee's request.
| Field | Lets an imported loan through when |
|---|---|
| Allow loan in probation period | The loan started while the employee was on probation |
| Allow loan without wage | The employee has no basic wage on their profile |
| Allow maturity exceed contract expiry date | The loan ends after the employee's contract expiry date |
Approvers
Up to two people at each of three levels: Primary approvers, Secondary approvers and Tertiary approvers. The lists show active employees with the Loan Manager right. Primary approvers are asked first, then each later level in turn. With no approvers at all, every request for the type is approved automatically.
Checks every request faces, whatever the type
These come from the employee's profile, not the loan type:
- A basic wage must be set, and a pay cycle (batch cycle) assigned.
- If the wage isn't monthly, working days per week must be set.
- The employee can't be on probation on the loan's start date. Probation counts from the hire date.
- The loan must end before the contract expiry date, and before any termination date. Imports can skip the contract check, never the termination check.
Messages and what to check
| Message | Check |
|---|---|
| Minimum loan tenor of N months allowed. / Maximum loan tenor… | Minimum months / Maximum months |
| Minimum loan amount is N. / Maximum loan amount is N. | Minimum amount / Maximum amount |
| Minimum employment of N years required. | Minimum months of service, and the hire date |
| You do not have hire date assigned but requested loan type has minimum service requirement. | Add the hire date to the profile |
| Installment amount exceeds wage multiple limit. | Minimum wage to loan ratio, the term, or the basic wage |
| The [type] can be requested with a start date of at least N days from today. | Drawdown notice (Days) |
| For [type], Loan Account number is required. | Requires Loan Account Number |
| You may not apply for a loan during your Probation Period. | Probation on the profile, or Allow loan in probation period for imports |
| Basic Wage should be assigned before applying for a loan. | The basic wage, or Allow loan without wage for imports |
| Loan maturity exceeds Contract Expiry Date. | The contract expiry date, a shorter term, or Allow maturity exceed contract expiry date for imports |
| Loan maturity exceeds Termination Date. | A shorter term. This check can't be switched off. |