Loan type settings explained

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

  1. Note the exact message the employee saw.
  2. Find it in the Message column of the table at the end of this article.
  3. Open the loan type and check the setting named there.
  4. 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

FieldWhat it does
NameRequired, up to 64 characters, unique in your company (capitals ignored). It shows on the loan, the request and every report.
DescriptionOptional, 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

FieldWhat it doesDefault
Minimum months and Maximum monthsThe 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 periodHow 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 chargeA 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 InstallmentFor 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 payslipOn: 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 penaltyOn: an overdue instalment also gets a late charge at the loan's own yearly interest rate.Off
Minimum amount and Maximum amountThe range a request can borrow. The minimum must be at least 1, and can't be above the maximum.Blank, no limit
Yearly interest rateInterest 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 PeriodA 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 PeriodHow 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 NumberOn: 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

FieldWhat it does
Minimum months of serviceWhole 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 ratioThe 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.

FieldLets an imported loan through when
Allow loan in probation periodThe loan started while the employee was on probation
Allow loan without wageThe employee has no basic wage on their profile
Allow maturity exceed contract expiry dateThe 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

MessageCheck
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.

Related articles