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

TDS Challan — entity reference

A vendor-TDS/TCS deposit challan (ITNS 281) - one per company, deduction month, payment code and major head (0020 company deductees / 0021 others; mixed groups are split). Prepared as Draft from the month's undeposited TdsTransaction rows with the deductions linked through TdsChallanAllocation; posting computes both interest legs as of the deposit date (1 percent per month for late deduction, 1.5 percent per month for late deposit), posts the deposit journal (debit the withholding payable and interest expense, credit bank) and marks the allocated transactions Deposited. The CIN recorded after bank payment - BSR code, tender date, challan serial - is what the quarterly return's challan rows cite, and it can be verified against the portal's CSI file. The salary-TDS analog is PayrollStatutoryChallan.

Fields

FieldLabelTypeRequiredWhat it does
BankGLAccountIdBankGL Account IdLookup → GLAccount
BranchIdBranchLookup → Branch
BsrCodeBsr CodeText
ChallanSerialChallan SerialText
CorrectionCountCorrectionsNumber
CorrectionLogCorrection LogLongMultiLineTextAppend-only JSON audit of every post-deposit correction: when, the bank/portal reference, and each corrected field's old and new value. Amounts are immutable in a correction - only head, payment code or CIN fields change - and CorrectionCount tracks how many corrections were applied.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated OnDateAndTimeYes
CsiVerifiedCsi VerifiedBooleanTrue once the challan's CIN (BSR code + tender date + serial) has been matched against the portal's Challan Status Inquiry file via the verify action - the pre-filing proof that the bank actually reported the deposit.
DepositDateDeposit DateDate
DueDateDue DateDateStatutory deposit due date: the 7th of the month following the deduction month, except March TDS which is due 30 April. Deposits after this date accrue the 1.5 percent per month late-deposit interest.
FeeAmountFee AmountCurrency
GLIdGL IdLookup → Journal
IdIdGuidYes
InterestAmountInterest AmountCurrencyThe late-DEPOSIT interest leg: 1.5 percent per month or part thereof from the deduction month to the deposit month. Kept separate from LateDeductionInterestAmount so the two statutory interest heads stay auditable; TotalAmount carries both.
LabelLabelText
LastCorrectionReferenceLast Correction RefText
LateDeductionInterestAmountLate-Deduction InterestCurrencyThe late-DEDUCTION interest leg: 1 percent per month or part thereof from the date the tax became deductible to the date it was actually deducted (driven by the gap between a transaction's DocumentDate and DeductionDate). Separate from the 1.5 percent late-deposit leg in InterestAmount.
MajorHeadMajor HeadPickListITNS 281 major head derived from the deductees' classification: 0020 Corporation Tax for company deductees, 0021 Income Tax Other than Companies. One challan carries exactly one major head - preparation splits a payment-code group with mixed deductee types into two challans. Values: 0020 — Corporation Tax (Companies), 0021 — Income Tax (Other than Companies).
MinorHeadMinor HeadPickListValues: 200 — Regular, 400 — Demand.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYes
NatureNaturePickListValues: TDS — deducted on payables, TCS — collected on receivables.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner Account IdLookup → Account
PayableGLAccountIdPayableGL Account IdLookup → GLAccount
PaymentCodePayment CodeNumber
PeriodMonthPeriod MonthNumber
PeriodYearPeriod YearNumber
RecordTypeIdRecord TypeGuid, hidden
SectionCodeSection CodeText
StatusStatusPickListValues: Draft, Deposited, Verified.
SubscriptionKeySubscription KeyGuid, hiddenYes
TaxAmountTax AmountCurrency
TotalAmountTotal AmountCurrency
UpdatedDateTimeUpdated OnDateAndTimeYes

Actions

ActionLabelTypeWhat it does
CorrectTdsChallanCorrect ChallanServerAction (CorrectTdsChallan)Records a bank/portal challan correction in the books: head, payment code or CIN fields may change while amounts stay immutable. Appends the change to the challan's correction log with the correction reference, increments the correction count, and resets CSI verification so the corrected CIN must be re-verified.
DeleteListRowDeleteDeleteDelete
EditHeaderEditEditInlineEdit
EditListRowEditEditEdit
GenerateChallanGenerate ChallanUIActionGenerate Challan
NewNewNew, inactiveNew
PostTdsChallanDeposit ChallanServerAction (PostTdsChallan)Posts the deposit: computes both interest legs as of the deposit date (1 percent per month late-deduction, 1.5 percent per month late-deposit), posts the journal debiting the TDS/TCS payable control for the tax and interest expense for interest/fee against a bank credit for the total, links the journal via GLId, and marks the allocated transactions Deposited.
PrepareTdsChallansPrepare Monthly ChallansServerAction (PrepareTdsChallans)Drafts the month's deposit challans from undeposited TdsTransaction rows: one challan per payment code (legacy rows: per section code) and ITNS 281 major head, linking each deduction through a TdsChallanAllocation and stamping the branch from the allocated deductions. Reports how many challans were created or topped up and how much tax was allocated; re-runs pick up only still-undeposited transactions.
VerifyTdsChallanCsiVerify Against CSIServerAction (VerifyTdsChallanCsi)Matches deposited challans' CINs (BSR code, tender date, serial) against the content of the portal's Challan Status Inquiry file supplied by the caller, setting CsiVerified on matches - the pre-filing tie-out that the bank reported each deposit.