Skip to content
Docs
Voxbi Cockpit APIs
API Guides

Contracts

A contract in Tempus is the formal employment relationship between one employee and one company. It is what activates the employee for payroll, time tracking, holiday quotas, and overtime.

Overview

Without an active contract an employee has no holiday quota, overtime accrual, expected hours, or time-attendance scope. An employee can hold several contracts over time, but only currently active ones drive day-to-day computations. The usual way to create one is Employee onboarding, which builds the employee, contract, and first work-shift assignment together. Use the standalone form for mid-employment changes.

What it does

The contract is the gate to the rest of Tempus: holiday quotas use its company and holiday calendar, overtime uses its weekly hours as the baseline, time-point validation compares clock-ins against the work shift assigned under it, and approval routing uses its department to find the manager.

Three settings deserve care:

  • Contract type signals which legal rules apply and whether an end date is required (fixed-term types require one).
  • Contract start date is the baseline for the work-shift assignment. If the shift starts later, the employee has no expected hours for the gap and time-point validation flags it. Match the two unless deliberate.
  • Compensatory balance sets the starting credit or debit of time owed. Set it only when migrating from another system: a wrong value permanently displaces every future overtime calculation.

Contract transfer

When a tenant has two or more companies, a Transfer button appears on each contract row. It closes the source contract on a date you pick, opens a new one on the target company the next day, and preserves work-shift assignments, balances, and history. Use transfer for internal reorganizations and the end-and-recreate flow for unrelated job changes.

How to activate a new employee for time tracking

Until an active contract exists, the employee has no holiday quota, no expected hours, and no overtime accrual, so most "Tempus is not showing anything for this person" questions are a missing or mis-dated contract.

  1. Use Employee onboarding rather than building the pieces separately. It creates the employee, the contract, and the first work-shift assignment together, which is where they most often end up out of step.
  2. Pick the contract type first. Fixed-term types require an end date.
  3. Give the contract start date and the work-shift assignment start the same date unless you mean otherwise. A shift starting later leaves a gap with no expected hours, and time-point validation flags every day in it.
  4. Leave the compensatory balance at zero unless you are migrating from another system. A wrong opening value displaces every future overtime calculation permanently.
  5. Confirm the department, since approval routing reads it to find the manager.
  6. Verify the employee now has a holiday quota and expected hours before moving on.
  7. For a later change in weekly hours, end this contract and create a new one. Editing the hours in place does not recompute historical overtime.

See also

Form fields

Fields available in the create and edit forms.

Contract details

Employee

The employee this contract belongs to. Only active employees appear in the dropdown.

Company

The legal entity employing this person. Determines applicable labor regulations and the holiday calendar.

Department

Department within the company. Drives approval routing for the employee requests. Filtered by the selected company.

Contract type

Type of employment contract. Fixed-term types require an end date.

  • permanent_contract Permanent contract Open-ended (CDI). No end date required.
  • fixed_term_contract Fixed-term contract Fixed-term (CDD). An end date is required.
  • temporary_agency_contract Temporary agency contract Employee sent by an agency for a specific mission.
  • apprenticeship_contract Apprenticeship contract Combined work and study contract.
  • adaptation_contract Adaptation contract Tailored contract for workers with a disability.
  • internship_contract Internship contract Short-term placement, often unpaid or low-paid.
  • part_time_contract Part-time contract Reduced-hours employment.
  • seasonal_contract Seasonal contract Tied to a specific season.
  • occasional_contract Occasional contract On-call work with no guaranteed hours.
  • telework_agreement Telework agreement Addendum documenting a remote-work arrangement.
Job title

Free-text or ESCO-sourced job title. Start typing for autocomplete from the European job-title catalog.

Contract start

Legal start date of the contract. Also used as the baseline for the first work-shift assignment.

Contract end

Legal end date. Required for fixed-term contract types. Leave empty for open-ended permanent contracts.

Participation

Employment percentage (0-100%) representing the workload commitment relative to the company full-time hours.

Weekly expected working time

Contractual weekly hours in H:mm format (for example, 40:00). The legal reference used for overtime calculation.

Compensatory balance

Starting credit or debit of time owed in H:mm format. Positive for credit, prefix with - for debit. Set only when migrating from another system.

Home-office balance

Starting count of available home-office days for this contract.

Updated