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 Transaction — entity reference
REFERENCE · Last reviewed

TDS Transaction — entity reference

One withholding event - TDS deducted from a vendor bill/payment or TCS collected on a customer sale - recorded per source document line, mirroring how TaxTransaction captures GST. Written by the posting service when a bill line carries a TDS section: the levy is assessed cumulatively for the fiscal year against the section's thresholds and, when leviable, an adjusting journal is posted (debit the payable control the bill credited, credit TDS payable) with the journal linked back via GLId. Drives section-wise threshold tracking, the withholding payable control balance, monthly deposit challans (via TdsChallanAllocation) and the quarterly return's deductee rows. Status moves from Computed to Deposited when a challan covering it is posted; Reversed rows drop out of reporting.

Fields

FieldLabelTypeRequiredWhat it does
BranchIdBranchLookup → Branch
BusinessUnitIdBusiness UnitLookup → BusinessUnit
CertificateNumberCertificate NumberText
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated OnDateAndTimeYes
DeductionDateDeduction DateDateAndTimeThe date tax was actually deducted. Equals DocumentDate in every normal posting; later only for a catch-up deduction on a back-dated correction, and that gap is what drives the 1 percent per month late-deduction interest leg on the challan.
DocumentDateDocument DateDateAndTime
DocumentNumberDocument NumberText
FiscalPeriodIdFiscal PeriodLookup → FiscalPeriod
FiscalYearIdFiscal YearLookup → FiscalYear
GLIdGLLookup → Journal
IdIdGuidYes
LdcCertificateIdLower Deduction CertificateLookup → LowerDeductionCertificate
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYes
NatureNaturePickListTDS (deducted, payable to the government on the vendor's behalf) or TCS (collected from the customer). Determines which payable control the posting credits and which quarterly form reports the row. Values: TDS — deducted on payables, TCS — collected on receivables.
OwnerIdOwnerLookup → UserAccountYes
PanAvailablePAN AvailableBooleanFalse when the party's PAN was unavailable at deduction time and the penal no-PAN rate was applied (reported with remarks code C on the return).
PartnerAccountIdPartner AccountLookup → Account
PartyAccountIdParty AccountLookup → Account
PartyPanParty PANText
PaymentCodePayment CodeNumber
RateRateCurrency
RecordTypeIdRecord TypeGuid, hidden
RemarksCodeRemarks CodePickListReturn remarks: A (lower-rate certificate applied), B (nil certificate), C (penal no-PAN rate). Empty means deducted at the normal statutory rate. A and B cite the lower-deduction certificate linked via LdcCertificateId. Values: A — Lower deduction (s.395), B — Nil deduction (s.395), C — Higher rate (PAN missing).
SectionCodeSection CodeText
SourceEntityNameSource Entity NameText
SourceRecordIdSource RecordGuid
StatusStatusPickListComputed (levy recorded, not yet deposited), Deposited (a posted challan covers it, via its allocation), or Reversed. Challan preparation picks up only undeposited rows. Values: Computed, Deposited, Reversed.
TaxableBaseTaxable BaseCurrencyThe portion of the transaction actually subjected to the levy - the full value for ordinary sections, or only the excess over the annual threshold for excess-levy sections. TaxAmount = TaxableBase times Rate; do not recompute from TransactionAmount.
TaxAmountTax AmountCurrency
TdsSectionIdTDS SectionLookup → TdsSection
TransactionAmountTransaction AmountCurrency
UIPropsUI PropsText
UpdatedDateTimeUpdated OnDateAndTimeYes

Actions

ActionLabelTypeWhat it does
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
EditEditEditInlineEdit
NewNewNewNew