#5205·hrms

Tax Regime–Based Exemption Handling for Child Education and Child Hostel Allowance in a Common Salary Structure

Author: prasathbalachandrasekar1999-cellCreated Sep 3, 2026Updated Sep 8, 2026
Labelsbug

Information about bug

Description

The salary components Child Education Allowance and Child Hostel Allowance have different tax treatment depending on the employee's selected income tax regime:

  • Under the New Tax Regime, both Child Education Allowance and Child Hostel Allowance are taxable.

  • Under the Old Tax Regime, both components are exempted, subject to the applicable exemption limits and conditions.

The issue occurs when a single standard Salary Structure contains both components and is assigned to multiple employees who have selected different income tax regimes.

Example / Use Case

Consider a standard Salary Structure named "Standard Salary Structure" containing the following salary components:

Salary Component | Amount | New Tax Regime | Old Tax Regime -- | -- | -- | -- Basic Salary | ₹50,000 | Taxable | Taxable Child Education Allowance | ₹2,000 | Taxable | Exempted Child Hostel Allowance | ₹3,000 | Taxable | Exempted

Now, this same Salary Structure is assigned to two employees:

  • Employee A → Selected New Tax Regime

  • Employee B → Selected Old Tax Regime

Since both employees are using the same Salary Structure, the system needs to determine the taxability/exemption of Child Education Allowance and Child Hostel Allowance based on each employee's selected tax regime.

For Employee A (New Regime):

  • Child Education Allowance → Taxable

  • Child Hostel Allowance → Taxable

  • Both components should be considered while calculating taxable income and income tax.

For Employee B (Old Regime):

  • Child Education Allowance → Exempted, subject to applicable limits

  • Child Hostel Allowance → Exempted, subject to applicable limits

  • Eligible exemption should be considered while calculating taxable income and income tax.

Problem

The tax exemption configuration appears to be associated with the Salary Component/Salary Structure, rather than being dynamically evaluated based on the employee's selected Income Tax Regime.

As a result, when the same Salary Structure is assigned to employees following different tax regimes, it is unclear how the system should correctly determine the taxable amount and exemption for the same salary components.

This can potentially lead to incorrect taxable income and income tax calculations when employees under the Old and New Tax Regimes share the same Salary Structure.

Expected Behavior

The system should allow the same Salary Structure to be assigned to employees regardless of their selected tax regime.

During payroll/income tax calculation, the system should dynamically determine the tax treatment of each salary component based on the employee's selected Income Tax Regime.

For example:

  • If the employee has selected New Tax Regime, Child Education Allowance and Child Hostel Allowance should be treated as taxable.

  • If the employee has selected Old Tax Regime, the components should be considered exempted according to the applicable exemption rules and limits.

The tax treatment should therefore be determined at the employee-level tax calculation, without requiring separate Salary Structures for each tax regime.

Module

HR

Version

ERPNext: v15.104.2 Frappe HR: v15.58.4 Frappe Framework: v15.104.0

Installation method

None

Relevant log output / Stack trace / Full Error Message.

bash

Code of Conduct

  • I agree to follow this project's Code of Conduct