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

TDS Return — entity reference

A quarterly withholding-tax return header (Income-tax Act 2025 numbering): Form 140 for resident non-salary TDS (ex-26Q), Form 143 for TCS (ex-27EQ), Form 138 for salary (ex-24Q, sourced from posted payroll) - one header per company, form and financial-year quarter, with the deductor TAN snapshotted from the company account. The compute action idempotently wipes and rebuilds the child challan (CD) rows and deductee (DD) rows from the TdsTransaction ledger - the return reports what the ledger recorded and never recomputes tax; deposits are mapped through the challan allocations and a deduction with no allocation becomes an unmapped row for validation to flag. Status runs Draft, Computed, Validated, Filed; a Filed return is guarded against recompute and is what certificate generation and the year-end books reconciliation read. Corrections are separate headers (ReturnType Correction) linked to the original via OriginalReturnId.

Fields

FieldLabelTypeRequiredWhat it does
AckNumberAck NumberText
ChallanCountChallan CountNumber
ComputedOnComputed OnDate
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated OnDateAndTimeYes
DeducteeCountDeductee CountNumber
DueDateDue DateDate
FiledOnFiled OnDate
FormCodeForm CodePickListWhich quarterly statement this is, in Income-tax Act 2025 numbering: 140 resident non-salary TDS (ex-26Q), 143 TCS (ex-27EQ), 138 salary (ex-24Q); 144 (non-resident) is a later phase. Determines the source ledger slice, the FVU record layout and which certificate kind is generated. Values: 138, 140, 143, 144.
FyStartYearFy Start YearNumber
IdIdGuidYes
LabelLabelText
LateFeeLate FeeCurrencyLate-filing fee computed when the filing is recorded after the due date: 200 rupees per day of delay, capped at the return's tax amount (the erstwhile s.234E fee).
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYes
OriginalReturnIdOriginal Return IdLookup → TdsReturn
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner Account IdLookup → Account
QuarterQuarterNumber
RecordTypeIdRecord TypeGuid, hidden
ReturnTypeReturn TypePickListRegular or Correction. A Correction statement is drafted against a Filed regular return via the correction action and points back through OriginalReturnId; it is a new header, not an edit of the filed one. Values: Regular, Correction.
StatusStatusPickListDraft, Computed (CD/DD rows rebuilt from the ledger), Validated (pre-file checklist ran), Filed (acknowledgment recorded; recompute refused). Certificates and the year-end reconciliation only consider Filed returns. Values: Draft, Computed, Validated, Filed.
SubscriptionKeySubscription KeyGuid, hiddenYes
TanTanText
TotalTaxDeductedTotal Tax DeductedCurrency
TotalTaxDepositedTotal Tax DepositedCurrency
UpdatedDateTimeUpdated OnDateAndTimeYes
ValidationResultsValidation ResultsLongMultiLineText
ValidationStatusValidation StatusPickListOutcome of the pre-file checklist: Pass, Warnings or Fail, with the individual findings (code, severity, message, count) serialized into ValidationResults. Covers PAN structure and coverage, challan mapping and tie-out, and CIN completeness. Values: Pass, Warnings, Fail.

Actions

ActionLabelTypeWhat it does
AddToReturnAdd to ReturnServerAction, hiddenReconciliation remedy: ensure the quarter's return exists and recompute it from the ledger.
AllocateToNextChallanAllocate to Next ChallanServerAction, hiddenReconciliation remedy: attach an unallocated deduction to its month's Draft challan.
CarryForwardChallanBalanceCarry Forward BalanceServerAction, hiddenReconciliation remedy: earmark a challan's unconsumed deposit for a later period.
ComputeTdsReturnCompute ReturnServerAction (ComputeTdsReturn)Idempotent wipe-and-rebuild of the return's challan (CD) and deductee (DD) child rows from the TdsTransaction ledger for the header's financial-year quarter (salary returns source from posted payroll). Never recomputes tax - the ledger already carries the assessed amounts. Deposits are mapped through the challan allocations; deductions with no allocation become unmapped rows the validation flags. Refused on a Filed return. Returns row counts, deducted/deposited totals and the unmapped count.
CreateTdsCorrectionReturnCreate CorrectionServerAction (CreateTdsCorrectionReturn)Drafts a Correction statement against this Filed return: a new TdsReturn header with ReturnType Correction and OriginalReturnId pointing back, ready to be computed and filed independently. The filed original stays frozen.
DeleteListRowDeleteDeleteDelete
EditHeaderEditEditInlineEdit
EditListRowEditEditEdit
ExportTdsFvuTextExport e-Return FileServerAction (ExportTdsFvuText)Renders the computed return as the caret-delimited e-TDS/TCS statement text - one file-header line, one batch-header line, then the challan and deductee record lines in sequence - the structural skeleton the Protean RPU imports and the FVU validates. Returns the file name, format version, line count and content; amounts are plain decimals, dates ddMMyyyy.
GenerateSourceDocumentGenerate Source DocumentServerAction, hiddenReconciliation remedy: raise the missing Bill/Invoice as a Draft from a filed deductee line.
GenerateTdsCertificatesGenerate CertificatesServerAction (GenerateTdsCertificates)Generates the withholding-certificate register from this FILED return: one TdsCertificate per deductee (Form 131 for Form-140 returns, Form 27D for Form-143, Form 16 register rows for Form-138), numbered TAN/kind/FY/quarter/sequence, stamping the certificate number back onto the underlying TdsTransaction rows so the ledger and register cite the same reference. Regeneration wipes Draft certificates and rebuilds; a return with Issued certificates is locked.
ImportPanVerificationResultsImport PAN VerificationServerAction (ImportPanVerificationResults)Imports the TRACES bulk PAN verification result file: each row's verdict (Verified, Invalid, Name Mismatch) is applied so PAN problems surface before filing rather than as portal rejections afterwards.
MarkTdsReturnFiledMark FiledServerAction (MarkTdsReturnFiled)Records the portal filing: stamps the acknowledgment number and filed date, computes the late-filing fee when overdue (200 rupees per day capped at the tax amount), and advances Status to Filed - after which recompute is refused. Filing itself happens on the government portal; this records the outcome.
NewNewNewNew
OpenTdsReconciliationConsoleReconciliation ConsoleUIActionOpen the books-vs-returns-vs-challans console: drill into a period and resolve each case.
RebuildStrictLineRebuild Line (Strict)ServerAction, hiddenReconciliation remedy: align a non-filed return line's rate and tax to its ledger row.
ReconcileBooksVerify Books vs ReturnsUIActionPick company, financial year and nature, then reconcile the withholding ledger against the filed returns and their challan deposits.
ReconcileTdsBooksReconcile Books vs ReturnsServerAction (ReconcileTdsBooks), hiddenYear-end deductor-side reconciliation for one company, financial year and nature: ties the TdsTransaction ledger quarter by quarter to what the FILED returns reported and what their challans deposited, surfacing unreturned ledger rows, orphan return lines with no live ledger row behind them, and challans whose deposits are under- or over-consumed by filed returns.
ValidateTdsReturnValidate ReturnServerAction (ValidateTdsReturn)Runs the pre-file checklist over the computed rows - PAN structure and coverage, deduction-to-challan mapping, challan utilization tie-out, CIN completeness - and stores the findings on the header (ValidationStatus plus the itemized ValidationResults JSON).
← TDS Challan Allocation TDS Return Challan →