/settings/erp/finance/payroll-settings). Accrual runs automatically; settlement happens through the separation flow.
📷 Screenshot: the gratuity section of payroll settings — the “Accrue gratuity monthly” toggle and the months-per-year rate — to be added.
Multi-business: the gratuity policy is set per business (per accounting book). Each business accrues against its own settings and posts to its own ledger.
The two settings that control gratuity
Both live in Payroll settings:Important: turning the toggle off only stops the monthly accrual. It does not stop gratuity being paid at separation. Whether gratuity is owed at all is governed by the rate — set it to 0 if your business owes no gratuity.Setting
payroll:config is needed to change either value.
Monthly accrual (automatic)
Once a business has enabled accrual, Hitaji 360 runs a monthly job (early on the first of each month) that, for every active employee in that business, posts one month’s worth of gratuity provision. The amount per employee is:(1,000,000 × 1.5) ÷ 12 = 125,000 each month.
The job skips an employee when the business hasn’t enabled accrual, when the rate is zero, when there’s no active salary assignment, or when it can’t resolve the employee’s accounting contact (so it never posts a liability it couldn’t later release). Each month is posted once per employee — re-runs never double-accrue.
A privileged user can also trigger accrual manually (for example to back-fill months right after enabling it). The manual run is an HR-admin action.
Settlement (at separation)
When an employee separates, their gratuity is computed and paid through the terminal (off-cycle) payroll run as part of their final settlement. The amount is:Permissions
Behind the scenes — the accounting
Monthly accrual
Each month the provision is recognised as an expense and a liability:
The payable is stamped with the employee’s contact so the balance can be isolated and released for that specific leaver at separation.
Settlement draw-down
When the employee separates, the provision built up for them is released:
The actual cash payout of the gratuity flows through the terminal payroll run (and is subject to PAYE like other terminal pay). The draw-down above ensures you don’t expense the same gratuity twice — the years of monthly accrual net against the settlement.
The draw-down is a reconciliation refinement: if the gratuity accounts aren’t set up or the provision is zero, it safely does nothing and the terminal run expenses the gratuity directly.
Related
- Payroll settings — where the toggle and rate live
- Separation (offboarding) — the leaver process that pays gratuity
- Running payroll — terminal/off-cycle runs that disburse it
- Payroll overview — the whole chain