Skip to content
Voxbi Cockpit APIs
API Guides

Overtime periods

An overtime period in Tempus is a bounded window of time (typically a month or a quarter) during which overtime hours accumulate and at the end of which they are reconciled: paid out, converted to compensatory time-off, or rolled forward.

Overview

A period is the settlement boundary for overtime. Each company configures its own cadence, so multi-company tenants can run separate cadences, though most pick one (monthly or quarterly) across all companies. The page lists periods with their dates, company, status, and note, and lets you create, open, close, or submit them.

What it does

A period moves through three states:

Status Meaning
Open Accumulating overtime. Employees file declarations and see their running count. Time-point edits within the period count toward the balance.
Closed No longer accumulating. Time-point edits inside the period are locked. The system generates one decision per employee in the company.
Submitted The submission has been sent to payroll. Balance changes hit the contract, cash payouts go out, and the period is read-only.

A period usually stays Open for its duration, moves to Closed a few days after the end date so pending corrections can settle, then to Submitted once payroll runs.

How to close a period and send it to payroll

  1. Let pending corrections settle first. Closing locks time-point edits inside the period, and a late correction then needs an HR override.
  2. Close the period. One decision per employee in the company is generated at close.
  3. Work through the decisions, setting how much is paid out and how much is banked as time off. Decision preferences seed each employee's usual split so you are not retyping it.
  4. Bundle them into a submission and send it. Submitting writes balance changes to the contract, releases cash payouts, and makes the period read-only.
  5. Create the next period before it starts. Periods do not auto-create, and creating a full year each December is the common practice.

See also

Updated