xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField Sales & SFACRMRewardsClaimsInventoryProcurementWarehouse ManagementField ServiceServiceSupportTelephony & MessagingFinance & AccountingPayrollExpense ManagementCommercePortalsAnalytics & ReportingData StudioMobile AppSee all products →
PLATFORM
Platform overviewApp BuilderAutomationIntegrationsSecurity & GovernanceChange ManagementDevelopers
SENSE AI
Sense AI overviewSense AssistSense ControlSense VisionAI StudioTrust & governanceIn Claude & ChatGPTUse cases
SOLUTIONS
Auto DMSConsumer Goods DMSSales Force Automation (SFA) FMCG & DistributionManufacturing & Dealer NetworksAutomotive & DealershipsPharma & HealthcareConsumer DurablesAgri-InputsBuilding MaterialsService NetworksWarehousing & 3PLFinancial AccountingERP SoftwareIndia GST ComplianceUAE VAT & e-InvoicingSaudi ZATCA & VATAll solutions →
RESOURCES
Knowledge CenterDeveloper & CLIBlogGuidesWhat is xMatix?Company facts
COMPANY
AboutCareersPartnersEventsContactAuthorsLegal
Sign in Request demo
Home/Docs/Entity Reference/Tax Regime Rule — entity reference
REFERENCE · Last reviewed

Tax Regime Rule — entity reference

The income-tax parameters of one regime for one financial year that are not slab bands: standard deduction, the rebate ceiling and maximum with its marginal relief, the highest surcharge rate, cess and the rounding unit. The salary TDS projection and the annual salary rows of a Q4 TDS return look up exactly one active rule whose Regime and Financial Year match exactly and whose Partner Account is the payroll company or blank; a company rule replaces the shared one. The projection computes both regimes, so it writes nothing for an employee unless the year has a rule for the Old and the New regime. No rules are supplied with the product.

Fields

FieldLabelTypeRequiredWhat it does
AllowsChapterViaDeductionsAllows Chapter VI-A DeductionsBooleanInformational. Which declared deductions count in each regime is decided by each Tax Deduction Section's Allowed In Old Regime and Allowed In New Regime; this switch only changes the reason text of a refused claim.
AllowsHousePropertyLossSetOffAllows House Property Loss Set-OffBooleanWhether a house-property loss may reduce salary income in the regime. Salary TDS always treats house-property income as nil, so it has no effect today.
CessRateCess RateCurrencyHealth and education cess as a plain number (4 for 4 percent), charged on the tax after rebate and marginal relief plus the surcharge after its relief. Blank means no cess.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated OnDateAndTimeYes
FinancialYearFinancial YearTextThe financial year in the form 2026-27, matched exactly against the year derived from the payroll period's end date. Free text: any other spelling, or a blank, means the rule is never found. Unlike a salary tax slab, a blank year does not apply to every year.
HousePropertyLossSetOffCapHouse Property Loss Set-Off CapCurrencyCeiling on the house-property loss that may be set off against salary. Has no effect today, because salary TDS always treats house-property income as nil.
IdIdGuidYes
IsActiveIs ActiveBooleanWhether the rule is used. Blank also counts as active. Untick it only when another rule for the same regime and year takes over, or nothing is projected for that year.
LabelLabelTextOptional display text. Not used by the computation.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYesIdentifier of the rule, typed by you (no numbering series). Required. Put the regime and year in it, for example NEW-2026-27.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountLookup → AccountThe company the rule belongs to. Blank means every company; a company rule replaces the shared rule for that company. A blank value can be filled on save with the creating user's default company, which makes the rule company-only.
RebateIncomeCeilingRebate Income CeilingCurrencyTaxable income at or below which the rebate applies. Above it there is no rebate at all; only the marginal relief, if enabled, softens the jump. Also the reference point for that relief. Blank means no rebate.
RebateMarginalReliefEnabledRebate Marginal Relief EnabledBooleanWhen on, the tax after rebate on income just above the ceiling is cut so that it does not exceed the income above the ceiling. Applied before surcharge and cess, in whichever regime it is switched on. Blank counts as off.
RebateMaxAmountRebate Max AmountCurrencyThe largest rebate. The rebate given is the slab tax up to this amount, when taxable income is at or below the ceiling. Blank or 0 means no rebate.
RecordTypeIdRecord TypeGuid, hidden
RegimeRegimePickListOld or New (shown as Old Regime and New Regime), matched exactly against the regime being computed. Defaults to New on the form. A rule with no regime is never used. Values: Old Regime, New Regime.
RoundingUnitRounding UnitCurrencyAmount to round to, normally 10. Applied to the taxable income and again to the final tax, to the nearest multiple (an exact half rounds up). Blank or 0 keeps paise.
SpecialRateSurchargeCapRateSpecial Rate Surcharge CapCurrencySurcharge cap on tax from dividends and special-rate capital gains, as a plain number. Salary TDS never supplies special-rate income, so this has no effect on the projection or the TDS return.
StandardDeductionStandard DeductionCurrencyFlat deduction from salary income, applied in both regimes before declaration claims. Blank counts as 0.
SubscriptionKeySubscription KeyGuid, hiddenYes
SurchargeMaxRateSurcharge Max RateCurrencyThe highest surcharge rate the regime allows, as a plain number (25 for 25 percent). A surcharge band with a higher rate is cut down to it. Blank means no cap.
UpdatedDateTimeUpdated OnDateAndTimeYes

Actions

ActionLabelTypeWhat it does
DeleteDeleteDeleteDelete the Tax Regime Rule
DeleteBulkDeleteDeleteDelete the selected Tax Regime Rule records
EditEditEditEdit the Tax Regime Rule
EditHeaderEditEditEdit
EditInLineEdit InlineEditInlineEdit the Tax Regime Rule inline
NewNewNewCreate a new Tax Regime Rule
ViewViewViewView the Tax Regime Rule