Skip to content
Voxbi Cockpit APIs
API Guides

Employees

An employee in Tempus is one person on the payroll: their HR record, holding legal name, birthdate, matricule (registration number), documents, and links to contracts, work shifts, and time tracking.

Overview

Employees are the foundation of Tempus. Every contract, work shift, time-point, and holiday request traces back to one employee. A Tempus employee is the HR mirror of the same person Cockpit (telephony) calls a User. The two are separate identities and can be linked.

Aspect User (telephony) Employee (Tempus)
Purpose Identity, phone routing, login HR, payroll, time tracking
Identifier Email Matricule

Linking is optional but recommended: a linked employee gets a Voxbi account for the time-tracking app, an unlinked one is a pure HR record with no system access.

What it does

Use the Onboard new employee button for new hires. The wizard creates the employee, their first contract, work-shift assignment, and document records in one transaction. The standard edit form gives access to every field for corrections and mid-employment changes.

Key behavior:

  • Active = off stops the employee clocking in or seeing their data, but retains history for payroll and legal needs.
  • Birthdate drives age-based rules such as youth-work hour limits.

The editor has four tabs: General (personal details and user link), Contracts, Work shifts, and Employee documents.

See also

Form fields

Fields available in the create and edit forms.

General

System user

Links this employee to a Cockpit user account so they can log in to Tempus and view their own data.

First name

Employee's legal first name as it appears on official documents.

Last name

Employee's legal family name as it appears on official documents.

Birthdate

Employee's date of birth. Used for age-related rules and reports. Must fall between 16 and 80 years from today.

Matricule

Unique employee registration number used in payroll, HR systems, and reports (for example, EMP-001). Must be unique on the tenant.

Is active

When off, the employee is excluded from time tracking and active reports but their history is retained.

Employee documents

Attachments

HR documents for this employee such as ID cards, passports, residence permits, and certificates.

Updated