Skip to main content
How to configure an absence type?

This article will guide you through the configuration of the new request type.

Agata Skowrońska avatar
Written by Agata Skowrońska
Updated over 2 weeks ago

Calamari administrator can configure and adjust all types of absences/requests in Configuration → Absence types.

Below, you'll find step-by-step instructions on how to do it and what is specifically important in each section. Let's get it started!

General

  • In this section you can decide if this absence type has its entitlement, or whether it's a subtype of a different absence, using its entitlement. For example, you have one main request type - Business trips, but it can be divided into Incentive travel, Client meetings, Seminars, etc. and they all take off the main Business trip pool.

  • Consider as - this allows you to choose if the request is treated as

    - Time off

    - Remote work

    By choosing the option to consider the request as remote work you can also turn on transferring to the timesheet as worked hours.

  • Duration unit - here's where you chose the basic unit for absence calculation:

    • hours - absences will be requested in hours with the possibility to present them as days according to users' work schedules,

    • days - absences will be requested in days (with the minimum leave duration of 1/4 or 1/2 of a day).

    IMPORTANT NOTE: Once you save the configuration, the Duration unit cannot be changed later. Please remember this when applying your policies.

    For employees working part-time, we recommend the configuration in line with this article:

Absence type internal ID (optional) - here, you can enter your absence type code, for internal purposes. It can be used to integrate with external systems of choice. The code you entered here, can be found in the reports.

Note - this code has to be unique for each absence type!

Accrual

Entitlement:
In this section, you can choose how to determine entitlement limits:

  • Limited - based on defined rules, employees are given a certain number of days/hours to use.

  • Unlimited - in this case, there is no specified number of days/hours to use.

  • Undefined - in this case there is no specified number of days/hours to use.

    Both Unlimited and Undefined types work the same way, but they give a slightly different feel of how the absence is treated. Whether it's typically unlimited or just without a particular number of days/hours to use, but with a sense that it's only for specific occasions.

Calculations:
In this section you can choose how the system will accrue and how employees will request leave in the future.

  • Estimate future entitlement - in this case system will accrue entitlement up to the end of the possible requesting period, and employee will be allowed to request days in future based on the future entitlement.

  • Calculate as of the current day - in this case, the system will accrue entitlement up to the current day, and the employee will be allowed to request days in the future based on the entitlement already earned.

Accrual Cap:
In Calamari, an accrual cap is the maximum amount of leave time an employee can save up. Employees earn leave based on a set schedule, like monthly or yearly. Once they reach this cap, they stop earning more leave until they use some of what they’ve saved. This helps the company keep leave balances clear and encourages employees to take their time off regularly.

If you select the Accrued option, the entitlement will be based on accrual rules. The main principles that are useful when configuring rules are:

  1. Rules work independently. Each rule accrues limits according to its configuration, which allows several rules to calculate limits for one employee at the same time.

  2. Restricted to - the rule works for all employees who meet the conditions.

  3. If an employee does not meet the time conditions of the rule, the absence type will be available for them with a limit equal to zero. If, on the other hand, the employee is not included in the "Restricted for" list in any of the rules for the absence type, then the type becomes unavailable to them.

  4. Changes in the accrual rule - changing the rule's parameters triggers an automatic recalculation (including deletion) of all accruals resulting from the rule's current setup. The system recalculates all accruals so that the current state of limits results from the newly added/changed accrual rule.

Gaining the eligibility

Here you can determine the moment from which the accrual of the entitlement begins:

  • From the first day at work - the date of employment (the day of employment is already the day when the employee has the entitlement), here is the article describing it.

  • After hire (X years, months, weeks, days) - you can choose the time after the hire date when the employee becomes eligible for absence.

  • When overall seniority reaches (X months) - here you can configure the vesting based on the "Pre-employment experience" field.

  • From the moment of adding employee - should be used when the calculation is not related to the date of employment, but to the date the employee was added to the system.

  • After working full calendar years (X years)

  • From the beginning of the probation period

  • After the probation period is over

Losing eligibility

When an employee loses their entitlement, further accruals cease:

  • Last day at work - With the date of dismissal

  • After hire (X years, months, weeks, days) - you can choose the time after the hire date when the employee loses entitlement to accrue balance for certain absences.

  • When overall seniority reaches (X months) - you can configure the loss of entitlement based on the "seniority before hire" field.

  • Full calendar years worked (X years)

  • When probation finishes

Accrue periods

Each rule has its accrual period. You can choose between one-time or recurring accrual. The recurring cycle can be based on:

  • Annual or anniversary (according to carry-over) - this accrual period is related to the annual leave year cycle, which is configurable in the Carry-over tab.

  • Anniversary - this type of accrual is based on the anniversary of employment or the anniversary of gaining eligibility

  • Monthly, weekly, and yearly - selecting one of these options gives you the option to accrue in shorter cycles.

The amount and the moment of the accrual:

Amount

This is the number of days/hours that will be added for all employees who meet the conditions of the rule.

Accrual moment

There are moments of the billing period when you can configure the addition of new days to the pool:

  • When the period begins - the value will be added on the first day of the cycle and immediately available to the employee.

  • When the period ends - the value will be assigned on the last day of the accrued period (often used in monthly and weekly accruals).

First accrual for the new employees

  • You can choose when and how to make the first accrual immediately after acquiring entitlements, such as admission to work

    • In the period when the employee gains eligibility - in the cycle in which the employee acquired entitlements. This option is related to the annual leave year cycle, which is configurable in the Carry-over tab.

    • In the next period after gaining the eligibility - this option allows you to assign the initial value manually, and start the rules engine from the second accrual period.

    • In the day when gains eligibility - if you select this option, the accrual will take place when the employee acquires the entitlement. At the same time, you can choose whether the first accrual will be proportional or the full value.

Last accrual

Here you can choose how to calculate the last accrual - whether it will be prorated or the full value, respectively.

Effective date

The moment when the rule becomes active. Here, you can set the date when the rule will start accruing. If the employees' employment dates are before the effective date, the rule will start accrual from the effective date, but it will also use their hire dates to calculate for individual employees.

It is possible to expire the accrual rule if your absence policy is changing.

Restricted to...

Here you can specify for whom the absence type will be available. You can limit the visibility of an absence type to specific individuals, teams, contract types or genders. By default, it is available to all employees.

Requesting

Minimum leave duration

  • For absence calculated in days, we can specify whether the minimum length of the request will be a whole day, 1/2, or 1/4 day.

  • On the other hand, for absence calculated in hours, we can specify whether it will be a full day, half day, 1, 2 hours, 30, or 15 minutes, here is the article about it.

Include ... in leave request length

Here we can decide how to calculate the length of the request. We choose one of the ways:

  • Working days - in this case, the system takes into consideration only working days based on the work schedule assigned to the employee when calculating the length of the request.

  • Calendar days - the length is calculated in calendar days, taking into consideration weekends as well. If you choose hours as the calculation mode for absences, it is required to specify the number of hours to be converted into one whole day.

Include public holidays in leave request length

Check this box if you want the system to include public holidays in the leave request length.

Allow negative entitlement/taking in advance

By checking this option, we can allow under-limit requests and also set the maximum under-limit value (days or hours, depending on the duration unit).

Requesting is possible in...

Here, we can decide if requesting is possible only in:

  • the current absence year

  • the current and the following absence year

  • in the selected period in the future

Activate the new year ... months in advance

Here, we can set up how many months in advance, the system activates/allows requesting in the next absence year. For more details, please check this article.

When the employee requests for the next year, deduct the entitlement

While requesting in the future, we can decide from which pool the request will deduct the appropriate number of days/hours:

  • Deduct first the days/hours earned in the previous vacation year

  • Deduct proportionally from each day (this is very useful at the turn of the year when you want the request to take, for example, 3 days from the old pool, and 2 days from the new one).

Carry-over

Here, you can configure whether the absence year starts cyclically on the indicated date or the employee's employment anniversary.

In addition, we decide whether unused days will be carried over to the next year. If we select this option, we can also specify the maximum number of days/hours that will be carried over and enable the option to expire these days if unused after X months (maximum 12 months).

Fields & visibility

In this section, you can decide on additional fields when submitting the request (reason, substitute, and comment fields) whether they will be required, optional, or disabled, and for whom they will be visible.

In addition, the reason can be arbitrary or selected from a pre-defined list of reasons.

In the following articles, we describe the possibilities:

Attachments

Here, you can find more information about the attachments that need to be included with the requests.

Display

Here, we can decide whether the absence type will be presented first (during requesting and in the entitlement section) and set the color of requests presented in the calendar. Absences will be visible on the calendar when we set the option "Highlight absence type with color on the calendar" in the configuration.

Messages

Here, we can add a message that will be displayed to the employee before the request is submitted, as well as a short description of the type of absence, which can contain additional requirements or information and will be displayed in the Entitlement tab next to the limit.

The "Short description of absence type" field can also be expanded graphically using mark-down tags. Tags can make the text more readable and clearer.

An example description of an absence policy might look like this:

More about using mark-down tags → LINK

Restrictions

Here, we can create restrictions for a specific type of request in terms of length of requests, days in advance when the request has to be submitted, past reporting, or availability after the hire date.

We can select 2 levels of restrictions:

  • Display warning - the system will allow the addition of a request violating a restriction but will present a message/warning during the request + information about the restriction violation in the request details (for the manager/administrator/reporter)

  • Block the request - the system will not allow submitting the request violating a restriction


If you have any questions or concerns regarding the right configuration - drop us a line via chat or by sending a message to [email protected]

We're happy to help!

Did this answer your question?