Fees

v0.1.0 Edulab

Module name	fees
Version	0.1.0
Needs	payments >=0.1.0 <1.0.0
Entities	14 (list)
Roles	fees:admin, fees:accountant, fees:clerk, fees:student, fees:parent

Fee heads, fee structures, student fee demands, installments, concessions, other fees, receipts and refunds for a university and its colleges.

Who uses it

Role	Can do
fees:admin	Set up fee heads and fee structures, assign fees to students, approve concessions, refunds and programme transfers, publish fee notices
fees:accountant	Record counter (offline) payments, update demands and installments, process refunds, add remarks
fees:clerk	Raise other-fee and certificate charges, record programme transfers
fees:student	See own fee demand, installments, receipts and notices; pay online; request a refund
fees:parent	See the fees, installments and receipts of linked students

What it does

• Fee heads (tuition, exam, library, …) with priority and installment number.
• Fee structures per college, programme, academic year, year of study, category, aided/unaided, lateral entry and specialisation, built from fee heads; full, partial or installment payment plans; due date and late fee rule; intake limits.
• Student fee demands created from a structure, with per-head paid/pending amounts, admission status (new, accepted, hold, cancelled, refunded, rejected, revoked) and fee status (not paid, partially paid, paid).
• Installments with due dates and reminders.
• Concessions and scholarships, including amounts carried from the previous year.
• Other fees and certificate fees charged to individual students.
• Receipts for every applied payment, online or at the counter, with a downloadable receipt.
• Refunds for double payment, overpayment, cancellation or revocation, with the student's bank details.
• Programme transfers that move a student's demand to another structure and can be reverted.
• Fee notices shown on the student fee page.
• Online payment goes through the Payments module; this module never talks to a gateway.

Needs

• Core: 1.x
• Modules: Payments 0.x (online payment, settlement accounts, gateway refunds)

Setup after install

1. Create settlement accounts in Payments for the university and each college that receives money.
2. Add fee heads (fee_head), then fee structures for each college, programme, year and category; pick the settlement account on each structure.
3. Assign fee demands to students (from admission, by import, or by hand).
4. Set receiptPrefix, the late fee settings (lateFeeEnabled, lateFeePerDay, lateFeePerMonth) and reminder days.
5. Give staff the fees:admin, fees:accountant or fees:clerk role; students and parents get their roles from the core.

Settings

Setting	Default	Meaning
Receipt number prefix	RCPT	Prefix on receipt numbers
Allow part payment above the minimum fee	Yes	Partial-plan students may pay any amount from the minimum fee upward
Put first payment on hold when intake is full	Yes	A first payment for a full structure is applied but the demand goes to Hold
Charge late fee after the due date	No	Adds the structure's late fee rule after the due date
Late fee per day / per month	0	Rate (in paise) used when the structure's late fee type is Per day / Per month
Days before an installment due date to remind	10	Reminder email lead time
Days before the fee due date to remind	7	Reminder email lead time
Email student and parent when a payment is applied	Yes	Payment confirmation
Students can request a refund	Yes	Shows the refund request form to students
Offline payment modes accepted at the counter	Cash, Cheque, Demand draft, NEFT/RTGS, UPI	Modes the accountant can record

Events

Emits	When	Payload
fees.payment.received	A payment has been applied to a fee demand or other fee and a receipt was made	student, amount (paise), purpose, demand, other_fee, receipt, payment, mode, paid_on, fee_status
fees.demand.created	A fee demand is assigned to a student	student, demand, purpose, academic_year, total_fee
fees.demand.paid	A demand becomes fully paid	student, demand, purpose, academic_year, total_paid
fees.demand.cancelled	A demand is cancelled, refunded, rejected or revoked	student, demand, purpose, admission_status
fees.refund.paid	A student refund is paid out	student, refund, demand, amount

Listens to	Does
payments.payment.received	For orders it requested: applies the amount to the demand / installments / other fee, writes a receipt, then emits fees.payment.received
payments.payment.failed	Releases installments and other fees that were marked "In payment"
payments.refund.completed	Marks the linked refund as Paid and emits fees.refund.paid

Personal data

Fields marked pii: refund account holder name, IFSC code and account number (refund). Student identity, contact details and parents live in the core.

Support

Published by Edulab. Report problems through the Edulab support desk of your platform; include the site, module version and the receipt or demand number.