Skip to content
Docs
Voxbi Cockpit APIs
API Guides

Absences

An absence in Tempus is a recorded period when one employee was not working, carrying an employee, a type, a date range, an approval status, and optional documents.

Absences are how the system knows "on this day, this person was off" when computing expected hours, leave balances, and the time point overview. Public holidays cover everyone-is-off days, absences cover the per-employee cases.

Overview

An absence reaches this list two ways. The common path is employee-initiated: someone files a holiday request in the Voxbi app and a manager approves it. The admin path is HR-initiated: on the create form HR picks the employee, the type, the period, and a status. Approved records the absence immediately (no validation step); Pending opens the same validation workflow as an employee request and emails the configured validators. Both paths produce the same record; the difference is the audit trail - requests carry approval history, HR-direct approved records carry HR as creator.

The period is chosen on a calendar that also lets HR mark the first and last day as half days for part-day absences.

What it does

The type drives balance impact (vacation deducts from quota, sick leave often does not), whether an evidence upload appears, calendar color, and the reporting bucket. The date range is intersected with the holiday calendar and public holidays to compute working days consumed, so a vacation spanning a public holiday does not consume quota for that day.

The status drives whether the absence is in effect:

Status Meaning
Pending Awaiting manager decision. No balance impact.
Accepted Approved. Shows on calendar. Balance reduced for quota-consuming types.
Removed Rejected or canceled. No effect on balance.
Removed requested An accepted absence the employee asked to cancel. Awaiting decision.

Approve a pending absence from the row, or use Reject and Cancel rather than setting the status directly so a manager identity is captured. To cancel an accepted absence, the employee files a cancellation from the Voxbi app (status becomes Removed requested) which a manager then approves or refuses. HR can also cancel directly.

See also

Form fields

Fields available in the create and edit forms.

Absence details

Employee

The employee this absence is recorded for.

Status

Whether the absence is recorded straight away or sent for validation. On the create form only Approved and Pending can be chosen. Editing an existing absence keeps the full set of states.

  • approved Approved Records the absence immediately with no validation step. The balance is settled right away and no email is sent.
  • pending Pending Opens the validation workflow and emails the configured validators. There is no balance impact until the request is approved.
Absence type

The category of leave. Drives the balance impact, the calendar color, and the reporting bucket. When the chosen type has sub-types, a second dropdown appears for the finer breakdown, and the sub-type is what gets recorded.

Absence sub-type

A finer breakdown within the chosen absence type, such as a specific kind of illness or special leave. Only appears for types that define sub-types. When set, the sub-type is what gets recorded in place of the parent type.

Period

The days the absence covers. Click one day for a single-day absence, or a start day then an end day for a range. The first and last day can each be marked as a half day. A half day can carry a time, the start time being when the absence begins and the end time being when you are back, which lets a morning and an afternoon absence share the same day. Public holidays and non-working days inside the range are not counted as leave taken.

Notes

Optional context for the validators, such as the reason or coverage arrangements. Shown to whoever reviews the request.

Updated