Student Fee Demand

fees.fee_demand · every change is kept in the audit log · numbered FD-{YYYY}-{######}

Fields

Every record also has id, created_at and updated_at.

Field	Label	Type	Rules
student	student	link → core.student	required
fee_structure	fee structure	link → fees.fee_structure	required
college	college	link → core.college	required
programme	programme	link → core.programme	required
academic_year	academic year	link → core.academic_year	required
year_of_study	year of study	number	min 1; max 6
category	category	select	one of: General, Reserved, SC, ST, OBC
quota	quota	select	one of: Merit, Management, Management (Institute), Management (Other), NRI; default "Merit"
merit_round	merit round	select	one of: Default, First, Second, Third, Fourth, Fifth, Sixth, Seventh, Eighth, Ninth, Tenth, In-house, Linguistic minority; default "Default"
enrolment_type	enrolment type	select	one of: Primary, Secondary, Repeater; default "Primary"
programme_type	programme type	select	one of: Aided, Unaided; default "Aided"
lateral_entry	lateral entry	check	default false
specialisation	specialisation	text	max 140 characters
subject_group	subject group	text	max 60 characters
purpose	purpose	text	default "tuition"; max 40 characters
source	source	select	one of: Admission, Exam, Manual, Import; default "Admission"
payment_plan	payment plan	select	one of: Full, Partial, Installment; default "Full"
components	components	table of fee_demand_component
total_fee	total fee	money	required; min 0
minimum_fee	minimum fee	money	min 0
concession_total	concession total	money	default 0; min 0
previous_year_due	previous year due	money	default 0; min 0
previous_year_due_status	previous year due status	select	one of: None, Unpaid, Paid, Refunded, Fee updated, Carried to next year, Moved on programme transfer; default "None"
total_paid	total paid	money	default 0; min 0
due_date	due date	date	required
admission_status	admission status	select	one of: New, Accepted, Hold, Cancelled, Refunded, Rejected, Revoked; default "New"
fee_status	fee status	select	one of: Not paid, Partially paid, Paid, Cancelled, Refunded, Hold, Rejected; default "Not paid"
fully_paid	fully paid	check	default false
last_payment_on	last payment on	datetime
payment_link_enabled	payment link enabled	check	default true
online_payment_allowed	online payment allowed	check	default true
settlement_account	settlement account	link → payments.settlement_account
supporting_document	supporting document	file
receipt	receipt	file

Unique together: student + fee_structure

Permissions

Role	Can
fees:admin	read, create, update, delete
fees:accountant	read, update
fees:clerk	read
fees:student	read — only own rows (via student)
fees:parent	read — only own rows (via student)

API

GET    /api/fees/fee_demand?<field>=<value>&limit=100&offset=0
POST   /api/fees/fee_demand
GET    /api/fees/fee_demand/:id
PATCH  /api/fees/fee_demand/:id
DELETE /api/fees/fee_demand/:id