Overrides: PF, ESIC, PT, TDS

An override is a recorded deviation: reason required, effective-dated, audited, revocable, and stamped into every run executed under it.

Two kinds

• Pin to a platform set (stay on an older version)
• Custom parameters — the same JSON shape as the platform set; for PT a slab editor

Switches

• Professional Tax deduction — off records an override with no slabs; the payslip carries no PT row
• TDS deduction — off records an override on both regime scopes; employee-level exclusion lives on the employee
• Levies — each state/country levy has its own switch

Common custom overrides

Need	Scope	Key
PF on the full gross	pf	"wageFloorPctOfGross": 1 — PF wage = max(Basic+DA, gross × pct). Raise ceiling for 12 % of the entire gross; keep 15000 for the statutory cap
ESIC on the full gross	esic	"strategy": "pre-coss" — vs "coss-2088", whose wage is max(Basic+DA, 50 % of gross)
A state PT slab change ahead of the platform	pt:<State>	Slab editor
Older ESIC rates for a period	esic	Pin to the earlier set

Use Start from today's values in the editor to seed the JSON, then change the one key.

Effective dates

An override applies to run periods on or after its effective date. A month already processed keeps what it used until it is re-run.