Adjustments

Payroll → Pay Runs → Adjustments (/adjustments) — one-off changes to a component for a single pay run. Requires payroll:read to view, payroll:manage to create/edit.

Adjustments — per-run, per-employee, per-component

What an adjustment does

An adjustment moves what a run pays without rewriting the employee's revision. It is scoped to:

• Pay Run (runId — kept in URL ?run=) — the run it applies to.
• Employee (employeeCode + employeeName).
• Pay Component (payComponentCode) — e.g. BONUS, LOP_DEDUCTION.
• Amount — signed: +₹2,000 (add) vs −₹1,500 (deduct). Shown via signedMoney.
• Status — PENDING → APPLIED (after re-compute) or CANCELLED.

Column	Meaning
Employee	employeeName + mono employeeCode
Component	payComponentName + payComponentCode
Original	computedAmount (blank until a compute has run — zero would claim the component is worth nothing)
Adjustment	Signed amount (green / red)
Final	finalAmount (computed + adjustment)
Status	StatusBadge
Reason / Created by	Free text + createdBy

Working with adjustments

• Pay Run (select) — picker from usePayRunOptions() (runCode — periodCode). Choosing a run sets ?run= so returning from the form lands on the same run. New Adjustment is disabled until a run is selected — the run is the scope.
• Component (filter) and Status (PENDING / APPLIED / CANCELLED) filters.
• Row actions (when not CANCELLED, payroll:manage):

Action	Route
Edit	/adjustments/:id/edit?run=
Remove	useCancelAdjustment(runId) — confirm modal warns “The run needs recomputing for this to reach the payslip.”

• Help overlay (ADJUSTMENT_HELP_SECTIONS) explains “what an adjustment changes, and when it takes effect”.

Lifecycle

1. Create adjustment → PENDING.
2. Re-compute the run ([All Runs](pay-runs) → Sync & Compute / Re-compute). On compute, APPLIED and finalAmount is written; computedAmount appears.
3. Payslip shows Final.

:::note Adjustment is same permission as compute “An adjustment moves what a run pays, so it takes the same right that computes one.” — requires payroll:manage-level ability (same as sync-and-compute). :::