Skip to content
Voxbi Cockpit APIs
API Guides

Work shifts

A work shift in Tempus is a reusable weekly working pattern: the hours an employee is expected to work Monday through Sunday. It is the template you assign to employees through an employee work-shift assignment.

Overview

A shift is a title, seven daily hour values, and an optional description. There is no per-day start/end time or rotating multi-week pattern. For alternating weeks or location-specific shifts, create several shifts and switch the employee's assignment over time. The shift's expected baseline is compared against actual time-points to compute overtime, lateness, and absence.

What it does

Each day's hours are picked from a fixed-step H:mm dropdown (weekdays default 8:00, weekends 0:00). The weekly total must match the contract's weekly expected working time for the shift to be assignable, so a 38-hour shift will not appear for a 40-hour contract.

Common patterns:

Goal Shape Weekly total
Full-time Mon-Fri 8:00 / 8:00 / 8:00 / 8:00 / 8:00 / 0:00 / 0:00 40h
38-hour week (Lux. standard) 8:00 / 8:00 / 8:00 / 8:00 / 6:00 / 0:00 / 0:00 38h
80% (4 days) 8:00 / 8:00 / 8:00 / 8:00 / 0:00 / 0:00 / 0:00 32h
Saturday only 0 / 0 / 0 / 0 / 0 / 8:00 / 0 8h

A shift change applies from the next nightly recalculation, not retroactively. The Usage tab shows who is assigned and their date ranges, so check it before editing.

See also

  • Employee work shifts - the assignment binding a shift to an employee over a date range.
  • Contracts - the weekly-hours value that must match the shift's total.
  • Employees - the people the shifts are assigned to.
  • Time points - the actual hours compared against the shift's expected hours.
  • Tempus schedules - a separate concept: recurring status schedules, not work shifts.

Updated