xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField SalesCRMRewardsClaimsInventoryProcurementWarehouse 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
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/Monthly TDS Projection — entity reference
REFERENCE · Last reviewed

Monthly TDS Projection — entity reference

The month's salary-TDS projection for one employee: annual income projected forward, verified Chapter VI-A deductions applied, annual tax computed and spread over the months remaining in the financial year. It is the ONLY source of the salary TDS the payroll calculation deducts — the engine reads MonthlyTds for the employee and period and uses it verbatim for the TDS component, and nothing else writes this row in production, which is why Calculate always runs the projection first. Both tax regimes are computed on the same income facts and both are persisted alongside the recommendation and the annual saving, but the deduction always follows the elected Employee.TaxRegime. Note what the projection does NOT yet include: it builds its income facts from projected annual gross and Chapter VI-A claims only, so section 10 exemptions such as HRA, the 16(iii) professional-tax deduction, perquisites, house-property loss and relief under section 89 are all treated as nil. Grain: one row per Resource per PayrollPeriod, replaced on each re-projection.

Fields

FieldLabelTypeRequiredWhat it does
AnnualSavingAnnual SavingCurrency
AppliedRegimeApplied RegimePickList
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
FinancialYearFinancial YearTextThe Indian financial year the projection is computed for, derived from the payroll period's end date with the year starting on 1 April and formatted as 2026-27. It is the key used to find the regime rule set, slab bands, surcharge bands and the employee's declaration.
IdIdGuidYes
LabelLabelText
ModifiedByIdModified ByLookup → UserAccountYes
MonthlyTdsMonthly TdsCurrency
NameNameText, uniqueYes
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountLookup → Account
PayrollPeriodIdPayroll PeriodLookup → PayrollPeriodThe period this projection is for. Re-projecting soft-deletes any earlier row for the same employee and period rather than updating it, so history is preserved but only one live projection exists per employee per period.
ProjectedAnnualGrossProjected Annual GrossCurrencyThe estimate of the employee's full-year salary that the tax is computed on: year-to-date gross from already-calculated runs in this financial year, plus the average of those months projected over the months that remain.
ProjectedAnnualTaxProjected Annual TaxCurrencyThe full-year tax liability under the applied regime after slab tax, rebate, marginal relief, surcharge and cess, rounded to the statutory unit. It is the annual figure, not what is deducted this month — the monthly figure additionally nets off tax already withheld and divides by the months remaining.
RecommendedRegimeRecommended RegimePickList
RecordTypeIdRecord TypeGuid, hidden
RegimeMismatchOn Dearer RegimeBoolean
ResourceIdResourceLookup → ResourceThe employee, keyed on Resource rather than Employee — the payroll calculation looks the projection up by Resource and payroll period, which together form the row's effective grain.
RevisedAfterProofRevised After ProofBooleanIntended to mark a projection recomputed after proof verification. Every code path that writes a projection sets it to false and nothing ever sets it true, so it cannot currently be used to identify post-verification revisions.
TaxableIncomeTaxable IncomeCurrency
TaxableIncomeIfNewTaxable Income If NewCurrency
TaxableIncomeIfOldTaxable Income If OldCurrency
TaxIfNewRegimeTax If New RegimeCurrency
TaxIfOldRegimeTax If Old RegimeCurrency
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete this MonthlyTdsProjection.
DeleteBulkDeleteDeleteDelete
DeleteEntityDeleteDeleteDeleteEntity
EditEditEditEdit this MonthlyTdsProjection.
EditEntityEditEditEdit
EditInLineEditEditInlineEditInLine
NewNewNewCreate a MonthlyTdsProjection.
ViewViewViewView this MonthlyTdsProjection.

Lookup filters

FilterLookup fieldNotes
PartnerAccountFilterPartnerAccountId