A statutory deposit for a payroll period — the PF, ESI, PT, salary-TDS or LWF payment that clears the company-level liability payroll posting accumulated. It is company-level and period-level, not per employee; for per-employee withholding use PayrollRunComponentLine or PayrollRunDetail. The salary-TDS challan can be drafted from a payroll run, which sums TDS across every POSTED run detail of the period (a period may carry several runs) and is idempotent per company and period: it refreshes a Pending draft's amount, and reports rather than alters an already-deposited challan. Posting writes a two-line journal, Dr the statutory payable control / Cr Bank, then sets Status to Paid and stamps PaidDate and GLId. The quarterly salary TDS return picks up only challans of type TDS whose Status is exactly Paid, and cites their BSR code, challan serial and paid date as the CIN.
Fields
| Field | Label | Type | Required | What it does |
|---|
Amount | Amount | Currency | | The sum being deposited, and the exact figure posted to the journal — the Dr to the payable control and the Cr to bank both use it. When drafted from a payroll run it is the total TDS over every POSTED run detail of the period; edited afterwards it is taken at face value, since posting does not re-check it against what payroll actually withheld. Posting refuses a zero or negative amount. |
BankGLAccountId | BankGL Account | Lookup → GLAccount | | The bank account credited by the deposit. |
BsrCode | BSR Code | Text | | The receiving bank branch's seven-digit BSR code — the first part of the CIN that identifies the deposit to the tax department. The quarterly salary TDS return copies it onto its challan annexure, and its checklist counts any challan missing the BSR code, challan serial or tender date as incomplete. |
ChallanNumber | Challan Number | Text | | The bank or portal reference for the deposit. For salary TDS it is the legacy fallback for the challan serial: the quarterly return uses ChallanSerial when present and otherwise takes the first ten characters of this value. |
ChallanSerial | Challan Serial | Text | | The bank's challan serial number, the third part of the CIN alongside the BSR code and the deposit date. When blank the return falls back to a truncated ChallanNumber, which will not match the tax department's records unless that field happens to hold the serial. |
CreatedById | Created By | Lookup → UserAccount | Yes | |
CreatedDateTime | Created Date | DateAndTime | Yes | |
GLId | GL | Lookup → Journal | | The journal produced when the challan was posted. It doubles as the posted flag: a challan carrying a journal is refused a second post, and the salary-TDS draft routine treats it as already deposited and will not refresh its amount. |
Id | Id | Guid | Yes | |
Label | Label | Text | | |
ModifiedById | Modified By | Lookup → UserAccount | Yes | |
Name | Name | Text, unique | Yes | |
OwnerId | Owner | Lookup → UserAccount | Yes | |
PaidDate | Pa Date | Date | | The deposit date, which drives the journal date when the challan is posted — if blank at posting time, today's date is used and stamped back onto the record. It also becomes the tender date on the quarterly return's challan annexure, so an incorrect date here misstates whether the deposit was late. |
PartnerAccountId | Partner Account | Lookup → Account | | |
PayableGLAccountId | PayableGL Account | Lookup → GLAccount | | The statutory payable control account to debit. Optional: when blank, posting resolves the control from StatutoryType, and only fails if no control account is configured for that type on the company. Setting it explicitly overrides that resolution. |
PayrollPeriodId | Payroll Period | Lookup → PayrollPeriod | | The payroll period whose liability this deposit clears, and the key that makes the salary-TDS challan idempotent — one challan per company and period, even where the period carries several runs such as off-cycle or correction runs. The return generator also groups deducted-detail rows to a challan through this period. |
RecordTypeId | Record Type | Guid, hidden | | |
Status | Status | PickList | | The deposit's lifecycle. In practice only two values are produced by code: a drafted or newly created challan is Pending, and posting sets it to Paid. The quarterly salary TDS return picks up only challans whose status is exactly Paid, so a challan sitting on any other value is invisible to return filing. Values: Draft, Paid, Reconciled. |
StatutoryType | Statutory Type | PickList | | PF, ESI, PT, TDS or LWF. More than a label: when PayableGLAccountId is not set, posting resolves the control account from this value (PF to PfPayable, ESI to EsiPayable, PT to ProfessionalTaxPayable, TDS to TdsSalaryPayable, LWF to LwfPayable), falling back to the general Payroll Payable control for anything else — including Gratuity, which the picklist offers but posting has no dedicated control for. It is also the filter the salary TDS return uses to find deposit challans. Values: PF, ESI, PT, TDS, LWF, Gratuity. |
UIProps | UI Props | Text | | |
UpdatedDateTime | Modified Date | DateAndTime | Yes | |
Actions
| Action | Label | Type | What it does |
|---|
Clone | Clone | ServerAction (Clone) | Create a copy of this record |
Delete | Delete | Delete | Delete this PayrollStatutoryChallan. |
DeleteEntity | Delete | Delete | Delete |
DeleteHeader | Delete | Delete | Delete |
Edit | Edit | Edit | Edit this PayrollStatutoryChallan. |
EditEntity | Edit | Edit | Edit |
EditInLine | Edit | EditInline | Edit |
New | New | New | Create a PayrollStatutoryChallan. |
PostChallan | Post Challan | ServerAction (PostChallan) | Invoking it saves the record and returns without writing a journal or changing Status. The posting logic itself exists in the platform and is exercised by tests, but the only routes that reach it today are the payroll run's own prepare/post actions. Do not tell a user that pressing this posts the challan. |
View | View | View | View this PayrollStatutoryChallan. |
Lookup filters
| Filter | Lookup field | Notes |
|---|
| PartnerAccountFilter | PartnerAccountId | |
