Entering the annual leave quota in hours or days
The Shift planner shows how much leave is left from a person’s annual leave quota and the leave days taken in the schedule. The system does not calculate the quota: payroll sets it (from age, children and other entitlements), you only enter it. You can enter it in hours or in days — it is stored in hours, and the two fields always show the same value.
Before you start
Section titled “Before you start”- Permission: saving the quota requires the Shift planner management right — scheduler:manage.
- Prerequisite: the person is on the roster, and the site has a shift pattern (Settings → Site tab). Converting days needs the pattern’s hours.
- Open Shift planner → Settings → Leave quota, and pick the year with the year switcher.
- In the person’s row the Quota column has two fields: h and days. Enter the figure you received from payroll — the other field fills in by itself.
- Click Save quotas.
For a new person you can do the same when adding them: on the Roster tab the add row’s Leave quota (h) and Leave quota (days) fields record the quota for the current year. For someone joining mid-year, enter the pro-rata number of days payroll gave you.
How days become hours
Section titled “How days become hours”One day is as many hours as the person’s working day:
| Person | One day | 20 days |
|---|---|---|
| 12-hour shift worker | 12 hours | 240 hours |
| 8-hour day worker | 8 hours | 160 hours |
A shift worker’s day comes from the site’s shift pattern, a day worker’s (and a day-standby person’s) from the day-worker pattern. Hours are rounded to whole hours, so half days work too (21.5 days × 8 hours = 172 hours).
If it worked
Section titled “If it worked”- After saving, the row’s Left column shows the remaining leave in days; hover over it to see the exact hours.
- After a reload the hours and days fields still show the same value.
Common problems
Section titled “Common problems”| What you see | Why | What to do |
|---|---|---|
| The days field is greyed out | the person’s daily hours cannot be read right now (the scheduling engine’s pattern list is not available, or the site has no pattern) | enter the quota in hours; you can enter days later |
| “The quota entered in days could not be converted to hours…” | the daily hours could not be read while saving | enter it in hours, or try again later |
| A 12-hour shift worker’s 20 days show as 160 hours | the person is a day worker on the roster | fix their type on the Roster tab, then enter the days again |
Worth knowing
Section titled “Worth knowing”An empty field means no quota is recorded for this year — that is not the same as zero. Leave is consumed by the schedule: a leave day costs as many hours as the person would have worked that day under the rotation. The remainder is not carried over to the next year automatically.