Setting up time off booking validations

For each time off type, you can specify which requirements the booking must meet before it can be submitted. For example, you can prevent a user from booking more vacation time than is available to them. If the booking doesn’t meet the requirements, when the user attempts to submit it they will see an error and the booking will remain unsubmitted.

These requirements are specified by adding booking validations to the time off type. To add a validation, edit the time off type and click Add Booking Validation. You can add multiple validations to each time off type; all of the selected validations will be applied when a booking is submitted for that time off type.

This option is only available to customers using the TimeOff Plus or TimeOff Enterprise. products. The TimeAttend and TimeOff products include similar validations, but many of them are automatically applied.

About the default validations

Replicon offers multiple validation options by default, as outlined below. In addition to being available for selection within a time off type, the list of validations may also be available at Adminstration > Time Off  > Time Off Booking Validation Rules.

If you are a TimeOff Enterprise customer, we can help you create custom validations to meet your business requirements. Please contact your Customer Success Manager for more information.

Validation name

This validation…

Booking must be exactly 14 calendar days

Only allows submission if the booking is exactly 14 calendar days long

Error for booking more than scheduled hours

Prevents submission if the user tries to book more time off than they are scheduled to work, based on their assigned office schedule. For example, if the user is scheduled to work 7 hours and tries to book 8 hours off, they will be prevented.

If the user is not scheduled to work, either because there are no hours in his office schedule or the day is a holiday, a booking can’t be submitted for that day.

We recommend adding this validation for all time off types except the type used to create holiday bookings. If the validation is assigned to that time off type, bookings cannot be created on holidays.

This validation does not take into account shift schedules. It should not be used with shift workers as it will prevent them from submitting any time off.

Error for overlapping bookings

Prevents the user from submitting a booking that overlaps with an existing booking. An error is shown:

  • If either the new booking or the existing booking includes a full day off on the overlapping day
  • If both bookings have a start time specified for the overlapping day
  • In the case of one booking ending on the same day that the other booking starts, if the end time of the first booking is later than the start time of the second booking

We recommend adding this validation for all time off types.


Limit amount of time off taken

Lets you limit annual sick time to a value you specify. For example, with this rule you could specify that employees can’t take more 48 sick hours in a year.

Employees assigned this rule can still accrue more than this set amount, they just won’t be able to book additional time off. Any remaining accrued amounts can be carried over to the next year.

Note that:
  • The ‘year’ can be the calendar year, your fiscal year, or based on the employee’s anniversary – you can choose
  • This rule is most useful in states that allow employers to limit how much sick time employees can take in a year
  • It would most commonly be used when time off accruals are based on hours worked or paid (e.g. worker accrues 1 hour of sick time per 30 hours worked)

Prevent balance overdraw

Prevents the user from submitting if they try to book more time off than they have available in their time off balance. For example, if a user only has 3 days available and tries to book 5 days off, they will be prevented from submitting.

When booking time off for the future, the user's available balance is calculated as of the time off date. When adding or editing a booking for past dates, the balance is calculated as of the current day.

When calculating the balance, future bookings are taken into account; unsubmitted and rejected bookings are ignored.

Prevent overdraw at the end of year

Prevents users from overdrawing their end of year balance for a time off type. This is useful in companies that allow employees to overdraw their current time off balance, but don't allow them to overdraw their yearly entitlement.

For example, imagine that this rule is applied to a user who accrues one day of vacation time each month. In July, the user has accrued 7 days off, and they're allowed to book 12 days off for their summer vacation. But, if they tried to book off 13 days, they’d be blocked from submitting that booking, since they’d exceed their year-end balance by 1 day.

Prevent use during probationary period

Prevents users from taking time off for a specified probationary period, beginning from their first day of employment. Time off can still accrue during the probationary period. Employees can book future time off that falls after the probationary period.

For example, this rule would be useful in companies that allow sick time to accrue from an employee’s first day, but don’t allow employees to use sick time for the first 90 days.


How does validation work when multiple bookings are made on the same day?

Any validation you assign to a time off type is only checked when you submit a booking for that type. If the validation is not assigned to other time off types, you may not see the desired results when users create multiple bookings on a single day.

Consider this example:

  1. The user has two time off types: Vacation and Flex Days.
  2. The Vacation type has a validation to prevent bookings that are more than the user’s scheduled hours, but the Flex Days type does not.
  3. The user is scheduled to work 7 hours.
  4. The user books 4 hours using the Vacation type. Because the amount of time off is less than 7 hours, the booking is successful.
  5. The user now books 4 hours using the Flex Days type. Because there is no validation assigned to the Flex Days type, the booking is successful, even though the user has booked more time off than they are scheduled to work.
  6. If the user had booked the Flex Days time off first, and then the Vacation time off, they would have been prevented from booking the Vacation time.

If you allow users to book partial days off and are using either of the following validations, we recommend adding the validation to all of the user’s assigned time off types.

  • Error for booking more than scheduled hours
  • Error for overlapping bookings

If I add a validation, are existing bookings affected?

Validations are checked when a booking is submitted. Existing bookings won’t be affected unless someone edits and resubmits them. Then the booking will need to meet the assigned validations.

What validations are available in TimeAttend and TimeOff?

Many similar validations are available in the TimeAttend and TimeOff products. If you have either of these products, time off bookings are automatically validated to:

  • Prevent users from booking more than their scheduled hours
  • Prevent overlapping bookings

You can also prevent users from overdrawing their balance using the Maximum Overdraw option in the time off policy.