xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField Sales & SFACRMRewardsClaimsInventoryProcurementWarehouse 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
Auto DMSConsumer Goods DMSSales Force Automation (SFA) 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

One deposit challan for vendor TDS or customer TCS: the payment that hands one month's withheld tax of one company to the government. Challans are drafted from the month's undeposited withholding transactions, one per nature, payment code and major head, with each deduction linked to the challan. Depositing a Draft challan computes the statutory interest as of the deposit date, posts the deposit journal and marks the linked deductions Deposited. The bank's challan identification details (BSR code, tender date, challan serial) recorded on the challan are what the quarterly return quotes. Salary TDS uses the payroll statutory challan instead.

Fields

FieldLabelTypeRequiredWhat it does
BankGLAccountIdBankGL Account IdLookup → GLAccountBank account the deposit is paid from; credited with the total when the challan is deposited. Required to deposit: Deposit Challan asks for it.
BranchIdBranchLookup → BranchBranch the deposit journal posts under. Taken from the first deduction that carries a branch when the challan is drafted; if empty at deposit time, the branch of an allocated deduction is used.
BsrCodeBsr CodeTextPart one of the challan identification number: the seven-digit BSR code of the receiving bank branch. Must be exactly seven digits.
ChallanSerialChallan SerialTextPart three of the challan identification number: the bank's challan serial number, up to five digits.
CorrectionCountCorrectionsNumberHow many post-deposit corrections have been recorded on the challan with Correct Challan.
CorrectionLogCorrection LogLongMultiLineTextHistory of recorded corrections: when each was recorded, its reference, and the old and new value of every field it changed. Shown on the challan's Overview tab under Corrections.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated OnDateAndTimeYes
CsiVerifiedCsi VerifiedBooleanOn when the challan's identification number and amount have been matched against the Challan Status Inquiry file downloaded from the tax portal. Cleared again when a correction changes the BSR code, serial or deposit date.
DepositDateDeposit DateDateDate the challan was paid at the bank (the tender date in the challan identification number). Deposit Challan uses the value on the record, or today when it is empty, and saves the date it used. Interest is calculated as of this date.
DueDateDue DateDateStatutory deposit due date: the 7th of the month after the deduction month, except March TDS, which is due on 30 April (March TCS stays on 7 April). Filled from Period Year and Period Month when left empty.
FeeAmountFee AmountCurrencyAny fee paid with the challan. Entered by hand; it is added to the total and posted to the interest expense account together with the interest.
GLIdGL IdLookup → JournalThe deposit journal posted by Deposit Challan. Set once the challan is deposited; a challan with a journal cannot be deposited again.
IdIdGuidYes
InterestAmountInterest AmountCurrencyLate-deposit interest, calculated when the challan is deposited: 1.5 percent per month or part of a month for each deduction, counted from the month of deduction to the month of deposit, and zero for a deduction deposited by its due date. Zero while the challan is Draft.
LabelLabelTextDisplay label. Filled from the challan number when left empty.
LastCorrectionReferenceLast Correction RefTextReference of the latest recorded correction, such as the bank acknowledgement or portal request number.
LateDeductionInterestAmountLate-Deduction InterestCurrencyLate-deduction interest, calculated when the challan is deposited: 1 percent per month or part of a month for each deduction whose deduction date is later than its document date, counted from the document month to the deduction month. Zero in the normal case where tax is deducted on the document date.
MajorHeadMajor HeadPickListChallan major head, from the deductees' classification: 0020 Corporation Tax when the deductees are companies, 0021 Income Tax Other than Companies otherwise. One challan carries one major head, so a month's deductions under one payment code are split into two challans when they mix company and non-company deductees. A challan created by hand defaults to 0021. Values: 0020 — Corporation Tax (Companies), 0021 — Income Tax (Other than Companies).
MinorHeadMinor HeadPickListChallan minor head: 200 (regular payment) or 400 (payment against a demand). Defaults to 200. Values: 200 — Regular, 400 — Demand.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYesChallan number. Numbered automatically when the challan is created, starting with the series CHLN followed by a date and a six-digit counter.
NatureNaturePickListTDS for tax deducted on payables (bills and vendor payments) or TCS for tax collected on receivables. Defaults to TDS. Any other value is refused on save. Values: TDS — deducted on payables, TCS — collected on receivables.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner Account IdLookup → AccountThe company (deductor) whose withholding the challan deposits. Set when the challan is drafted; the payable control account and the challans considered in a CSI verification are those of this company.
PayableGLAccountIdPayableGL Account IdLookup → GLAccountOptional override for the withholding payable account debited with the tax on deposit. When empty, the company's account tagged as the TDS Payable or TCS Payable control account is used.
PaymentCodePayment CodeNumberPayment code of the deductions the challan deposits, taken from the withholding transactions. Deductions with a payment code are grouped by it; older deductions without one are grouped by Section Code instead.
PeriodMonthPeriod MonthNumberCalendar month (1 to 12) of the deductions this challan deposits. A value outside 1 to 12 is refused on save.
PeriodYearPeriod YearNumberCalendar year of the deduction month this challan deposits.
RecordTypeIdRecord TypeGuid, hidden
SectionCodeSection CodeTextTax section of the deductions. Used for grouping only when the deductions carry no payment code.
StatusStatusPickListDraft while the challan is being prepared, Deposited once Deposit Challan has posted it, and Verified once its identification number has been matched against the Challan Status Inquiry file. Only Deposited and Verified challans are reported in quarterly returns. A challan saved as Verified must carry its BSR code, deposit date and challan serial. Values: Draft, Deposited, Verified.
SubscriptionKeySubscription KeyGuid, hiddenYes
TaxAmountTax AmountCurrencyTax being deposited: the sum of the deductions allocated to the challan. Recalculated from the allocations when the challan is deposited.
TotalAmountTotal AmountCurrencyTax plus late-deposit interest, late-deduction interest and fee: the amount paid from the bank and credited to the bank account when the challan is deposited.
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.