Fee Configuration
Document Title | Fee Configuration |
---|---|
Document Number | FEE-001 |
Version | 1.1.1 |
Author(s) | Assistant Manager, Academics |
Approved by | Senior Manager, Operations |
Last Update Date | May 13th, 2025 |
Late Fee creation Using JSON (Academic Module)
Introduction
This document provides a step-by-step guide to configuring late fees in the Samarth Portal using JSON. The configuration applies to both Term Fees and Examination Fees. Late fee rules are applied through predefined JSON structures based on institutional policy. This guide outlines prerequisites, the structure of the JSON, how to implement the rules, and where they are applied in the system. This document is a simple guide for Institution staff and technical teams to create and set up late fee rules in the Samarth Portal using JSON. It explains how to apply late fees for both Term Fees and Examination Fees based on the university’s rules
Prerequisites
Programme-specific fee must be configured.
Payment Gateway is integrated for Term fee and Examination Fees
In the Samarth Portal, JSON-enabled late fees are used for processing:
Term Fees
Examination Fees
Late Fee Creation
This section allows the admin to create university-specific late fee rules using the following parameters:
Name: Enter the template name for the late fee.
Late Fee Rule: Enter the rule in JSON format.
Status: Set the status of the template (Active/Inactive).
How to Create Late Fee JSON Based on Parameters
Late Fee Rules are defined using JSON format. Use the following variables:
pa
: Principal AmountdaysCount
: Number of days from the due date (late fee start date)
Example Scenario 1 (variable amount or per day amount)
For example, a late fee rule is required where:
For the first 10 days, a 10% charge of the principal amount is applied.
For the next 10 days, a 20% charge of the principal is applied.
For the next 20 to 100 days, 20% fixed + an additional 10% per day on principal from day 20 onwards.
If Principal Amount (PA) = 1000, and late fee applicable date = 01-Jan-2024:
[
{
“days”: 9,
“type”: “CALCULATE”,
“amount”: “(pa*(.1))”,
“currency”: “INR”
},
{
“days”: 19,
“type”: “CALCULATE”,
“amount”: “(pa*(.2))”,
“currency”: “INR”
},
{
“days”: 100,
“type”: “CALCULATE”,
“amount”: “(pa*(.2))+(daysCount-19)*(pa*.1)”,
“currency”: “INR”
}
]
Example Scenario 2 (FIxed amount)
For example, Configure the late fee of 500/- fixed.
If Principal Amount (PA) = 1000, and late fee applicable date = 01-Jan-2024:
[
{
“days”: 9,
“type”: “CALCULATE”,
“amount”: “500”,
“currency”: “INR”
}
]
Configuring Late Fee in Term/Semester Fees
To configure the Late Fee in Term/Semester Fees:
Login to the portal.
Go to Academic from the main dashboard.![][image2]
Launch on Fee.
Open Student Academic Session Fee and Due.![][image3]
Select the appropriate Academic-Year-Session.
Choose the Programme.
Click on Advance Settings.![][image4]
Click the cog (settings) icon to create a Late Fee template.
Click Create Late Fee.
Enter the JSON as explained above.
Configuring Late Fee in Examination Fees
To configure the Late Fee in Examination Fees:
Login to the portal.
Go to Academic from the main dashboard.![][image2]
Click on Examination.
Select the Examination-Year-Session.
Open the Examination Programme.![][image5]
Click on Advance Settings.
Click the cog (settings) icon to create a Late Fee template.
Click Create Late Fee.![][image6]
Enter the JSON as explained above.
Note : Once configured, the system will automatically apply late fees based on the rules defined in the JSON. Always test and validate the logic before final deployment.