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/TDS Section — entity reference
REFERENCE · Last reviewed

TDS Section — entity reference

A withholding-tax section master under the Income-tax Act: TDS sections (contractors, professional fees, purchase of goods, commission and so on) and TCS sections, holding the statutory rate, the PAN-not-available penal rate, the per-transaction and annual exemption thresholds, and when the levy triggers. The calculation service reads this master to decide whether and how much to deduct or collect on each transaction. Rate rows are effective-dated and may be scoped to a deductee bucket, so dual-rate sections are two rows sharing a section code; from FY 2026-27 rows carry the Income-tax Act 2025 payment code that challans and quarterly returns cite, and the ProvisionTdsStatutoryCatalog action upserts the shipped statutory catalog and end-dates superseded old-era rows. An Account can pin a default section for its transactions.

Fields

FieldLabelTypeRequiredWhat it does
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated OnDateAndTimeYes
DeducteeTypeScopeDeductee Type ScopePickListWhich deductees this rate row applies to: empty/Any, IndividualHuf, or Others. Dual-rate sections (like contractor payments at 1 or 2 percent) are two rows sharing a SectionCode, split by this scope and matched to the party's deductee classification. Values: Individual / HUF, Others.
DeductionPointDeduction PointPickListWhen the levy is recognized: at bill booking, at payment/receipt, or whichever is earlier (deduped so an earlier-of section is withheld exactly once whichever event fires first). Defaults to bill booking. Values: At bill booking, At payment / receipt, Earlier of bill or payment.
DescriptionDescriptionText
EffectiveFromEffective FromDateAndTime
EffectiveToEffective ToDate
FormCodeForm CodePickListValues: 138 — Salary (ex-24Q), 140 — Resident non-salary (ex-26Q), 143 — TCS (ex-27EQ), 144 — Non-resident (ex-27Q).
IdIdGuidYes
IsActiveIs ActiveBoolean
LeviedOnExcessOverThresholdLevied On Excess Over ThresholdBooleanTrue for sections that levy only on the amount exceeding the annual threshold (the 194Q-style 0.1 percent on purchases above 50 lakh). False means once the threshold is crossed the rate applies to the full transaction value.
MinorHeadMinor HeadPickListValues: 200 — Regular, 400 — Demand.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYes
NatureNaturePickListTDS (tax deducted from amounts payable to vendors) or TCS (tax collected on amounts receivable from customers). Drives which payable control the postings hit and which quarterly form the transactions report on. Values: TDS — deducted on payables, TCS — collected on receivables.
NewSectionRefNew Section RefText
OwnerIdOwnerLookup → UserAccountYes
PaymentCodePayment CodeNumberIncome-tax Act 2025 payment code (1001-1092) cited on the ITNS 281 challan and in quarterly-return deductee rows from FY 2026-27. Null on pre-2026 legacy rows, which keep reporting by SectionCode; section resolution transparently maps a legacy-tagged line to the payment-code row valid on the transaction date.
RateRateCurrency
RateNoPANRate No PANCurrencyPenal rate applied when the party's PAN is missing or invalid (s.206AA for TDS, s.206CC for TCS). A deduction at this rate is reported with remarks code C on the return.
RecordTypeIdRecord TypeGuid, hidden
SectionCodeSection CodeText
ThresholdAnnualThreshold AnnualCurrencyAnnual aggregate exemption: deduction starts once the party's financial-year-to-date base crosses this amount. Whether the levy then applies to the full value or only the excess is controlled by LeviedOnExcessOverThreshold.
ThresholdSingleThreshold SingleCurrencyPer-transaction exemption: a single payment below this amount is never deducted, regardless of the annual aggregate.
UIPropsUI PropsText
UpdatedDateTimeUpdated OnDateAndTimeYes

Actions

ActionLabelTypeWhat it does
CloneCloneServerAction (Clone)Create a copy of this record
DeleteListRowDeleteDeleteDelete
EditHeaderEditEditInlineEdit
EditListRowEditEditEdit
NewNewNewNew TDS
ProvisionTdsStatutoryCatalogProvision Statutory CatalogServerAction (ProvisionTdsStatutoryCatalog)Upserts the shipped FY 2026-27 statutory withholding catalog (Income-tax Act 2025) into this tenant's section master - one row per payment code for the relevant TDS and TCS entries - and end-dates superseded old-era rows. Idempotent, keyed on payment code: a re-run re-asserts the statutory rates and thresholds without duplicating rows, so a Finance Act change ships as a catalog update plus re-run; deliberate tenant adjustments after provisioning are possible but a re-provision re-asserts the shipped values.