Skip to content
Voxbi Cockpit APIs
API Guides

Employee work shifts

An employee work shift is the assignment of a work shift template to one or more employees over a date range, for example "Employees A, B, and C on the Full-Time 40h pattern from 1 January through 30 June". It records who, which shift, when, and whether it is the default.

Overview

Assignments are managed from the Assign work shift page (also the Assign button on the Work shifts list). The form targets one or more employees, a whole department, or a group at once via the assignment type selector. The work-shift dropdown is filtered to shifts whose weekly total matches the targets' contracts.

What it does

The assignment type decides the target population:

Type What it targets
All Every active employee in the chosen company.
Departments Every active employee whose contract names one of the chosen departments.
Groups Every active employee linked to one of the chosen Cockpit groups.
Users Specific employees you pick by hand.

The is default flag is what time-tracking consults. An employee needs exactly one active default assignment at any time. Without it, the employee appears to have no expected hours and overtime is computed wrong. A non-default assignment is essentially documentation.

On save, one row is created per matched employee and a compilation job expands the assignment into per-day expected-hours rows. To change a shift mid-employment, end the current assignment the day before the switch and create a new default assignment from the switch date. The most recent overlapping default wins.

See also

  • Work shifts - the template this entity assigns.
  • Employees - the population receiving assignments.
  • Contracts - the contract's hours constrain assignability.
  • Employee onboarding - the wizard that creates the initial assignment for a new hire.
  • Time points - where the expected hours derived from the assignment are consumed.

Updated