Leave
Goal
Configure leave types and policies, track balances, and approve employee leave requests.
Who it is for
HR clerks (leave.view / .manage), approvers (leave.approve), admins (leave.admin). Employees/managers also use ESS for self-service requests.
Preconditions
- Module leave_management enabled.
- Active employees exist.
- Leave types created before requests.
Steps
- Open HR & Time → Leave.
- Under Leave types, add types (paid / statutory / accrues / carryover flags as offered).
- Create a leave request for an employee: type, start/end, hours, notes → status pending.
- Approvers Approve or Reject (denial reason may be required per Leave setup).
- Requesters or clerks may Cancel a request when allowed → cancelled.
- Review Leave balances; run Accrue for all active or Carry over balances when your process calls for it (also scheduled via
hr:accrue-leave/hr:carry-over-leave). - Maintain Leave policies (accrual rate, max balance, carryover max, effective dates).
- Admins use Leave setup for accrual method, carryover, blackout enforcement, approval chain levels, denial reasons.
Result
Approved leave updates balances; pending counts appear on the HR workspace and ESS manager queues.
Hard stops
- Request actions only valid in allowed statuses (pending → approved/rejected/cancelled).
- Module off → 422.