Skip to content

Operate Template (Loans CSV)

One row per loan. Each row triggers 4 Fineract API calls: client creation, loan creation, approval, and disbursement.

Download operate_template.csv

Sample Data

csv
firstname,lastname,externalId,mobileNo,emailAddress,activationDate,lenderConfig,loanExternalId,principal,submittedOnDate,expectedDisbursementDate,loanTermFrequency,loanTermFrequencyType,numberOfRepayments,interestRatePerPeriod,approvedOnDate,actualDisbursementDate,disbursementAmount,utr_payment_id,note
John,Doe,DMI-CLT-001,9876543210,john@example.com,01 March 2026,DMI,DMI-LN-001,100000,01 March 2026,05 March 2026,12,months,12,10,02 March 2026,05 March 2026,100000,UTR-001,Disbursement for DMI-LN-001
Jane,Smith,UGRO-CLT-002,9876543211,jane@example.com,01 March 2026,UGRO,UGRO-LN-002,250000,01 March 2026,05 March 2026,24,months,24,12,02 March 2026,05 March 2026,250000,UTR-002,Disbursement for UGRO-LN-002

Column Reference

ColumnRequiredExampleDescription
firstnameYesJohnClient first name
lastnameYesDoeClient last name
externalIdYesDMI-CLT-001Unique client ID from your system
mobileNoNo9876543210Client mobile number
emailAddressNojohn@example.comClient email
activationDateYes01 March 2026Client activation date
lenderConfigYesDMILender name (see table below)
loanExternalIdYesDMI-LN-001Unique loan ID from your system
principalYes100000Loan amount (must be > 0)
submittedOnDateYes01 March 2026Loan submission date
expectedDisbursementDateYes05 March 2026Expected disbursement date
loanTermFrequencyYes12Loan tenure
loanTermFrequencyTypeYesmonthsdays, weeks, months, or years
numberOfRepaymentsYes12Number of EMIs
interestRatePerPeriodYes10Annual interest rate (%)
approvedOnDateYes02 March 2026Loan approval date
actualDisbursementDateYes05 March 2026Actual disbursement date
disbursementAmountNo100000Omit or leave empty for full disbursement
utr_payment_idNoUTR-001Disbursement UTR reference
noteNoDisbursement noteFree text note

Supported Lenders

lenderConfigLender
LIQUILOANSLiquiloans
UGROUgro Capital
DMIDMI Finance
ARTHMATEArthmate
SHIVALIKShivalik Small Finance Bank
VIVRITIVivriti Capital
GBGromor / Growth Bharat
IKFIKF Finance

Date Format

Recommended: dd MMMM yyyy (e.g., 01 March 2026)

Other supported formats: YYYY-MM-DD, DD-MM-YYYY, DD/MM/YYYY

Date Ordering Rule

Dates must be in chronological order:

activationDate ≤ submittedOnDate ≤ approvedOnDate ≤ actualDisbursementDate

WARNING

The migration script validates date ordering and exits with an error if violated.

Turno Fineract LMS Documentation