Skip to main content

Global Fee Configuration

Role Required: SUPER_ADMIN / TNCHS_ADMIN
Navigation: Sidebar → Fee Configuration
Last Updated: March 2026 | Portal Version: 1.0

Overview​

As Super Admin, you manage the platform-wide default fees that apply to all societies. These global defaults form the base layer of the fee hierarchy — societies and layouts can override them with their own values.

Fee Hierarchy​

Fees resolve using a three-level hierarchy:

Layout Fee (most specific — wins if set)
  ↑ overrides
Society Fee (society-specific override)
  ↑ overrides
Global Fee (platform default — applied if no override exists)

When a citizen books a plot, the system checks for a layout-level fee first. If none exists, it checks the society level. If neither exists, the global default applies.

Default Global Fees​

The platform ships with these pre-seeded global fee defaults:

Fee CodeFee NameTypeDefault ValueCategoryApp FeatureRefundable
PLOT_BOOKING_ADVANCEPlot Booking AdvanceFixed₹50,000BOOKINGPlot Booking✅
ADMINISTRATIVE_CHARGESAdministrative ChargesFixed₹1,000ADMINPlot Booking❌
ENTRANCE_FEEEntrance FeeFixed₹10MEMBERSHIPSociety Registration❌
ENTRANCE_FEE_CGSTEntrance Fee CGST (9%)Percentage9% of Entrance FeeTAXSociety Registration❌
ENTRANCE_FEE_SGSTEntrance Fee SGST (9%)Percentage9% of Entrance FeeTAXSociety Registration❌
SHARE_CAPITALShare CapitalFixed₹100MEMBERSHIPSociety Registration❌

Fee Properties​

Each fee configuration has the following properties:

PropertyDescription
Fee CodeUnique identifier (e.g., PLOT_BOOKING_ADVANCE)
Fee NameDisplay name shown to users
Fee TypeFIXED (flat amount) or PERCENTAGE (of a calculation basis)
Fee ValueAmount or percentage
Calculation BasisFor percentage fees: what it's calculated on (e.g., ENTRANCE_FEE)
Fee CategoryBOOKING / ADMIN / MEMBERSHIP / TAX / GOVERNMENT
App FeatureWhere it applies: booking_plots or register_society
Is MandatoryWhether the fee can be waived
Is ActiveWhether the fee is currently in effect
Display OnlyShow to user but don't collect (informational)
Is RefundableWhether this fee is included in refund calculations
Is Advance PaymentWhether this counts as the booking advance
Multiply By CountMultiply by number of plots (for multi-plot bookings)
Include In TotalInclude in the total payable amount
Calculation OrderProcessing sequence (lower = earlier)
Rounding ModeNEAREST_PAISA or NONE
Effective From / ToDate range when the fee is applicable

Managing Global Fees​

Viewing All Fees​

  1. Navigate to Fee Configuration
  2. The list shows all fees (global, society, and layout levels)
  3. As Super Admin, you see fees across all societies

Filters Available​

FilterOptions
SocietyFilter by specific society
Source LevelGlobal / Society / Layout
Fee CategoryBooking / Admin / Membership / Tax / Government
StatusActive / Inactive

Creating a Global Fee​

  1. Click Create Fee
  2. Leave Society and Layout blank (this makes it global)
  3. Fill in:
    • Fee Code (unique identifier)
    • Fee Name (display text)
    • Fee Type (Fixed or Percentage)
    • Fee Value
    • Category and App Feature
    • Mandatory / Active / Refundable flags
    • Effective dates
  4. Click Save

Updating a Fee​

  1. Find the fee in the list
  2. Click to edit
  3. Modify values as needed
  4. Changes are tracked in the audit trail with your admin ID

Deactivating a Fee​

  1. Find the fee and click Deactivate
  2. This is a soft-delete — sets IsActive to false
  3. The fee stops applying to new transactions but historical data remains

Fee Templates​

Templates are predefined sets of fees that can be applied to a society in one click.

Viewing Templates​

  1. Navigate to Fee Configuration → Templates
  2. Templates include common fee configurations for:
    • Booking fees
    • Membership/registration fees
    • Government charges

Applying a Template to a Society​

  1. Click Apply Template
  2. Select the target Society
  3. Select the Template
  4. Click Apply
  5. Fee configurations from the template are created for that society
  6. Existing fees with the same codes are skipped (not overwritten)

Cloning Fees​

Copy a fee configuration from one society to another:

  1. Find the source fee
  2. Click Clone
  3. Select the Target Society
  4. Click Clone
  5. A copy is created with:
    • Same name, description, type, and amount
    • Current date as the new effective date
    • Target society as the owner
    • Your admin ID as the creator

Fee Preview​

Test a fee configuration before saving:

  1. Navigate to Fee Configuration → Preview
  2. Enter a sample base amount
  3. The system shows what the calculated fee would be
  4. Useful for verifying percentage-based fees

Bulk Operations​

Bulk Activate/Deactivate​

  1. Select multiple fees using checkboxes
  2. Click Bulk Status Update
  3. Choose Activate or Deactivate
  4. Confirm the operation
  5. A summary shows successes and failures

Export Fees​

  1. Click Export
  2. Choose format: CSV or JSON
  3. Filters from the current view apply to the export
  4. Downloaded file includes all fee properties

How Societies Override Global Fees​

When a Society Admin creates a fee with the same code at the society level:

  • The society-level fee takes precedence for that society
  • Other societies still use the global default
  • The global fee remains unchanged

Example: Global ENTRANCE_FEE = ₹10. Society A sets ENTRANCE_FEE = ₹25. Members joining Society A pay ₹25; members joining Society B still pay ₹10.

Common Scenarios​

"A new government charge needs to be added platform-wide"​

  1. Create a new global fee with the appropriate Fee Code
  2. Set Category to GOVERNMENT, App Feature to the relevant area
  3. Set IsMandatory = true if it cannot be waived
  4. All societies will automatically inherit this fee

"A society wants to reduce their entrance fee"​

The Society Admin can create a society-level override. If they don't have access, you can:

  1. Create a new fee with the same code at the society level
  2. Set the desired amount
  3. This overrides the global default for that society only

"I need to audit who changed a fee"​

Fee changes are tracked in the audit trail. Navigate to Audit Logs and filter by EntityType = FeeConfiguration.