Statutory rule sets

Each rule holds one statutory value — a rate, ceiling, threshold or slab table — for your country or for a specific state, with an effective date and a source citation. Pay runs use whichever version is in force on the pay date.

Rule key

The rule’s name, such as epf_employer_rate or professional_tax_slab.

Jurisdiction

The state the rule applies to. Blank means National. A state rule overrides the national rule with the same key for employees working in that state.

Formula shape

How the amount is calculated — see the table below.

Wage base

What the rate applies to: Gross Wages, or the earnings carrying a wage-base tag such as epf_wage_base.

Line code and label

The payslip line the rule produces, such as “EPF - Employee Contribution”.

The list shows each rule’s key, formula shape, jurisdiction, current value and effective date. Search by rule key or state, and click a row to see its current value, effective period, source and full version history.

Rules are never edited or deleted — you add a new version from the date the change takes effect, and past pay runs keep the old value.

1. 1

   Click the rule, then Add New Version of This Rule. You need payroll create permission.

2. 2

   The rule key, jurisdiction, formula shape, wage base and line codes are locked. Enter the new values — percentages as percent, so 12 means 12%.

3. 3

   Set Effective From to the date the new value applies. Leave Effective To blank.

4. 4

   Enter the Source / Citation, for example the circular or notification number and date.

5. 5

   Click Save Rule Version. The previous version ends automatically the day before.

Use Add Rule Version to add something that isn’t set up yet — for example a state’s Labour Welfare Fund.

1. 1

   Enter the Jurisdiction exactly as the state appears in the Work State list (for example “Maharashtra”, not “MH”), or leave it blank for a national rule.

2. 2

   Enter a Rule Key using lowercase letters, numbers and underscores, such as labour_welfare_fund.

3. 3

   Choose the Formula Shape and Wage Base, then fill in the fields for that shape.

4. 4

   Check the employee and employer line codes and labels — they’re suggested from the rule key.

5. 5

   Set Effective From and Source / Citation, then click Save Rule Version.

Gratuity, EDLI and PF administration charges aren’t calculated automatically.

LOP day-count convention

By default, working days are calendar days minus week offs and holidays. To start from a fixed number of days per month instead, add the loss_of_pay_day_count_convention rule with formula shape None and a raw JSON value such as {"convention":"fixed_days_per_month","fixed_days":26}. Week offs and holidays are still subtracted. Always include fixed_days — without it, calendar days are used.