Skip to content
Docs
Voxbi Cockpit APIs
API Guides

Calendar view

The Tempus calendar view is the per-employee monthly calendar that visualises one person's whole working life in a single layout: working days, scheduled hours, absences, time-points, public holidays, company calendar entries, home-office days, and balance changes.

The calendar is a report rather than a CRUD entity: the day cells are read-only, and to change a number you edit the underlying entity and refresh. The one exception is the More actions menu, which can correct a whole year at once - see Recalculating a year after a work shift changes. Reached at Tempus > Calendar, it opens on the current month with your own employee record pre-loaded. From there you switch employee, navigate months, filter by department, country, or status type, or click a day to drill into its entries.

What it does

Each day cell carries several markers:

Visual element What it means
Day-cell background Colored by dominant status: green fully worked, blue home-office, yellow partial, red absence, gray non-working.
Hour totals Consumed vs expected hours, on partial days.
Absence badges Colored pills for approved absences.
Holiday markers Flag icons for public holidays and company calendar days.
Home-office badge House icon for approved home-office days.

The employee picker is filtered to those you have permission to see: yourself for end users, your department for managers, everyone for HR. The URL carries ?employee_id=... so the view is bookmarkable.

Recalculating a year after a work shift changes

When someone's work shift changes - and especially when the change is entered after the fact - two things in that year become wrong:

  • Holidays already taken were charged at the old day length. Ten days off booked while the employee was on 8 hours a day still cost 80 hours even after the shift drops to 4 hours a day.
  • The legal holiday entitlement was credited for the whole year at the old rate. An employee granted 26 days at 8 hours holds 208 hours of rights, even if they actually worked half-time for six months of it.

More actions > Recalculate from work shift corrects both for one employee and one selected year.

It asks three times before it writes

  1. What it will do. Plainly stated, before anything is calculated.
  2. What it found. A dry run listing every entry it intends to write: which bookings get re-sized, how many days stop being charged, the entitlement correction with its amount and direction. Nothing has been written at this point. If the year already matches the work shift, this step says so and offers no Apply button.
  3. Confirmation. One last check before the write.

What it changes, and what it deliberately does not

  • Days the new shift does not schedule - a Friday the shift sets to 00:00, for example - stop being charged, and those hours come back. Half days stay half days rather than being rounded up.
  • The entitlement correction is booked as a new adjustment entry, not by editing the original credit. Nothing is deleted, so the history of what was granted stays intact and readable.

Undoing a recalculation

Every run is recorded with who ran it, when, and a full before-and-after snapshot. More actions > Recalculation history lists them, newest first.

Selecting a run shows what reverting it would restore, then puts the ledger back exactly as it was before that run - the per-day charges, the amounts, the balances, and the adjustment entries the run created.

Three rules keep this safe:

  • Only the most recent run for a given year can be reverted. If you ran the recalculation twice for the same year, undo the second before the first. Runs for different years are tracked separately.
  • Rows changed since the run are flagged as conflicts. If someone edited an entry the run had touched, reverting would overwrite their change, so the conflict is listed and you have to confirm you want it overwritten.

See also

Updated