Schedule compliance rules

Updated by Daniel Sjögren

The article below pertains to editing your schedule within our Manager portal, not when using our APIs or scheduling on Mobile. To see validations done when scheduling on mobile, please take a look at Schedule Validations page.

When you create, edit, or delete shifts in the Manager portal, Quinyx automatically checks those shifts against the compliance rules you’ve configured. These rules come from the Schedule Compliance settings and can be linked either to the unit or to an employee’s agreement.

The table below provides an overview of all available rules. For each rule, you’ll see:

  • The category it belongs to (e.g., Working Time, Breaks, Rest)
  • The name of each rule
  • A short description of what the rule does
  • The key settings that influence how the rule is validated

Some rules can either be configured to use the setup on agreements or custom values in the rule itself. In the cases of using agreement value, the system will look at the employee in question and use that value to validate compliance.

Rule category

Rule name

Rule description

Configurable settings

Break

Exceeding working time without break

This rule refers to situations where an employee is scheduled to work beyond permitted number of consecutive hours without having a break.

This rule can be completely configured using Custom configuration, or using Agreement value.

For unassigned shifts it uses Advanced unit settings.

Location

Setting

What it controls

Allowed values/tips

Schedule Compliance > Rule set > Exceeding working time without break [rule]

Maximum time without a break

Max amount of time an employee is allowed to be scheduled without a break.

Hours and minutes

Agreement / Agreement template > Advanced setting categories > Break rules and schedule changes

Maximum work hours w/o breaks (h)

Max amount of time an employee is allowed to be scheduled without a break.

Hours - Float value minutes defined in hundreds of one hour

Account settings > Group management > Unit > Advanced unit settings

Maximum work hours w/o breaks (h)

Max amount of time an unassigned shift is allowed to be created/edited without a break.

Hours - Float value minutes defined in hundreds of one hour

Break

Max break duration

This rule establishes the upper limits for the maximum duration of any single break taken during a shift.

This rule can be completely configured using Custom configuration, or using Agreement value.

For unassigned shifts it uses Advanced unit settings.

Location

Setting

What it controls

Allowed values/tips

Schedule Compliance > Rule set > Maximum break duration [rule]

Maximum break time

Maximum break duration which can be scheduled in a shift.

Hours and minutes

Agreement / Agreement template > Rules for hours

Maximum break

Maximum break duration which can be scheduled in a shift.

Minutes - Integer value

Account settings > Group management > Unit > Advanced unit settings

Maximum break

Maximum break duration which can be scheduled in an unassigned shift.

Minutes - Integer value

Break

Max breaks per shift

This rule sets a limit on the number of separate break periods an employee is permitted to take during a single shift.

Location

Setting

What it controls

Allowed values / tips

Schedule compliance > Rule set > Max breaks per shift [rule]

Maximum number of breaks per shift

Maximum amount of breaks that are allowed to be scheduled

Integer

Account settings > Group management > Unit > Advanced unit settings

Breaks/shift

Maximum amount of breaks allowed within a single shift

Amount of breaks - Integer value

Break

Min. break duration

This rule limits the minimum duration for any single break taken during a shift and will be triggered if a shift's break duration is shorter than required.

This rule can be completely configured using Custom configuration, or using Agreement value.

For unassigned shifts it uses Advanced unit settings.

Location

Setting

What it controls

Allowed values / tips

Schedule Compliance > Rule set > Min break duration [rule]

Minimum total break duration per shift

System support when creating or editing assigned shifts

Hours and minutes

Agreement > Agreement template > Break rules and schedule changes

Minimum break

System support when creating or editing assigned shifts

Minutes - Integer value

Account settings > Group management > Unit > Advanced unit settings

Minimum break

System support when creating or editing unassigned shifts

Minutes - Integer value

Break

Double break requirement

This rule ensures that long shifts include one or two breaks, based on shift duration. Short gaps between two shifts may count as breaks, treating multiple shifts as one.

Location

Setting

What it controls

Allowed values / tips

Schedule Compliance > Rule set > Double break requirement [rule]

First-break trigger Required

How long a shift may run before the first break becomes mandatory.

Hours and minutes ( ≥ 0)

Must be < Second-break trigger

Schedule Compliance > Rule set > Double break requirement [rule]

Second break trigger Required

How long the same shift may run before a second break becomes mandatory.

Hours and minutes ( ≥ First-break trigger).

Value must exceed First break trigger; otherwise the rule is ignored

Schedule Compliance > Rule set > Double break requirement [rule]

Minimum break length

Minimum duration considered a valid break.

Hours and minutes

Schedule Compliance > Rule set > Double break requirement [rule]

Max gap to merge shifts

Long-day scheduling trick: if two shifts are separated by a gap ≤ this value, theyʼre treated as one shift and the gap as a break.

Hours and minutes ( ≥ 0). Set 0 to disable merging

Availability

Scheduled on bank holiday

This rule prevents employees from being scheduled on bank holidays unless explicitly permitted, indicated in the agreement or agreement template.

Location

Setting

What it controls

Allowed values / tips

Agreement / Agreement template > Rules for hours

Schedule bank holidays

When set to true (checked), employees can be scheduled on bank holidays

True or false

Availability

Consecutive bank holiday scheduling

This rule prevents an employee from being scheduled to work on multiple consecutive bank holidays in two consecutive years.

Location

Setting

What it controls

Allowed values / tips

Bank holidays > Bank holiday

Employees can work on this bank holiday two years in a row

When set to true (checked), employees can be scheduled on consecutive bank holidays of that type

True or false

Availability

Incompatible scheduling across bank holiday dates

This rule is triggered when scheduled on a date that has been configured not to be scheduled for the employee if there's a shift on a certain bank holiday for that same employee.

Location

Setting

What it controls

Allowed values / tips

Agreement / Agreement template > Bank holidays > Bank holiday

Excluded dates for scheduling

Selected dates which canʼt be scheduled if the employee is scheduled the bank holiday

Date picker

Availability

Employee skill is missing

This rule triggers when an employee is scheduled for a shift requiring a skill they do not possess or have not been certified for.

Location

Setting

What it controls

Account settings / Group settings > Shift types

Skills

Skills required for en employee to be eligible to work the shift

People > People details

Skills

Skills which an employee has, constitutes which shifts that employee can work

Availability

Employee unavailable

This rule is violated when an employee is scheduled during a time they have marked as unavailable in their agreement.

Location

Setting

What it controls

Allowed values / tips

Agreement / Agreement template > Rules for hours

Check availability

Turning on availability feature for the agreement

Checkbox

Agreement / Agreement template > Rules for hours

Week

Weekly rotation

Set to an integer, minimum of 1

Agreement / Agreement template > Rules for hours

Weekdays

What time ranges should be available

Time of day, start and end

Availability

Late schedule change

This rule prevents changes to an employeeʼs schedule after a defined cut-off (lock) period.

This rule can be completely configured using Custom configuration, or using Agreement value.

Location

Setting

What it controls

Allowed values / tips

Schedule Compliance > Rule set > Late schedule change [rule]

Lock period

Cut-off period

Integer to set amount for the selected period

Schedule Compliance > Rule set > Late schedule change [rule]

Period

Granularity to validate

Drop-down list with selectable options; Days, Weeks or Months

Agreement template > Rules for hours > Schedule changes

Lock period

Cut-off period

Integer to set amount for the selected period

Agreement template > Rules for hours > Schedule changes

Period

Granularity to validate

Drop-down list with selectable options; Days, Weeks or Months

Availability

No overlapping absence shifts

This rule prohibits assigning a shift to an employee who already has a recorded absence shift for the same time, preventing conflicts.

For this rule to work, the agreement template needs to have Allow override on overlapping shifts setting turned on. See configurable settings.

Location

Setting

What it controls

Allowed values / tips

Agreement / Agreement template > Rules for hours

Allow override on overlapping shifts

Decides on agreement level if the rule is valid or not

On or off

Availability

No overlapping absences

This rule prohibits assigning a shift to an employee who already has a recorded absence for the same time, preventing conflicts.

For this rule to work, the agreement template needs to have Allow override on overlapping shifts setting turned on. See configurable settings.

Location

Setting

What it controls

Allowed values / tips

Agreement / Agreement template > Rules for hours

Allow override on overlapping shifts

Decides on agreement level if the rule is valid or not

On or off

Availability

No shift during pending leave request

This rule is triggered when an employee is scheduled to work during a period for which they have submitted a leave request that has not yet been approved or rejected

Rest

Min consecutive rest between shifts

This rule enforces a minimum number of hours an employee must have off between two consecutive shifts on different days.

This rule can be completely configured using Custom configuration, or using Agreement value.

Location

Setting

What it controls

Allowed values / tips

Schedule Compliance > Rule set > Min consecutive rest between shifts [rule]

Minimum consecutive rest per day

Minimum consecutive rest required per day

Hours and minutes

Agreement / Agreement template > Rules for hours

Min rest per day

Minimum consecutive rest required per day

Hours - Float value minutes defined in hundreds of one hour

Agreement / Agreement template > Rules for hours

Rest must be in connection with the daybreak

If the checkbox is ticked, the rule behaves differently; the employee needs to have a consecutive rest period on each day matching or longer than the minimum defined on the agreement

Rest

Min consecutive rest per week

This rule ensures that employees receive a continuous block of rest (e.g., 24+ hours) during a defined weekly period.

This rule can be completely configured using Custom configuration, or using Agreement value.

Location

Setting

What it controls

Allowed values / tips

Schedule Compliance > Rule set >Min consecutive rest per week [rule]

Minimum consecutive rest per week

Minimum consecutive rest required per week

Hours and minutes

Agreement / Agreement template > Rules for hours > Rules for working time

Min rest per day

Minimum consecutive rest required per week

Hours - Float value minutes defined in hundreds of one hour

Agreement / Agreement template > Rules for hours > Rules for working time

Check minimum rest/week during any consecutive 7 day period

If checked, it validates any 7 days period connected to the scheduled shift

Rest

Min days off after working a set of days in a row

This rule requires employees to have a certain number of days off after working a specific number of consecutive days.

This rule can be completely configured using Custom configuration, or using Agreement value.

Location

Setting

What it controls

Allowed values / tips

Schedule Compliance > Rule set > Min days off after working a set of days in a row [rule]

Minimum consecutive rest days

Amount of days off required consecutively

Days - Integer value

Schedule Compliance > Rule set > Min days off after working a set of days in a row [rule]

Working day period threshold

Max amount of consecutive days possible to schedule an employee

Days - Integer value

Agreement / Agreement template > Rules for hours

Free days

Amount of days off required consecutively

Days - Integer value

Agreement / Agreement template > Rules for hours

Max days

Max amount of consecutive days possible to schedule an employee

Days - Integer value

Rest

Min average consecutive weekly rest per period

This rule ensures that over a defined multi-week period, employees receive an average amount of consecutive rest per week that meets or exceeds the minimum requirement. It helps ensure compliance with long-term rest standards even if weekly rest varies.

Location

Setting

What it controls

Allowed values / tips

Schedule Compliance > Rule set > Min average consecutive weekly rest period [rule]

Period (weeks) required

Defines the number of consecutive weeks over which the rest average is calculated.

Weeks - Integer value

Schedule Compliance > Rule set > Min average consecutive weekly rest period [rule]

Average rest (per week) required

Minimum number of consecutive rest hours per week, averaged across the selected period.

Working time

Exceeding salary limit of employee's cost period

This rule is triggered when an employeeʼs scheduled or actual working hours result in total compensation that exceeds the predefined salary cap for their designated cost period. It is primarily used to support compliance with wage restrictions for Minijobbers in Germany, where strict earnings thresholds must not be surpassed within a monthly or yearly timeframe

Location

Setting

What it controls

Allowed values / tips

Agreement template > Working hours and periods

Cost periods

Period with Start date and length

Date picker and length [numeric]

Agreement template > Working hours and periods

Cost period values

Cost value for created cost period(s)

Working time

Max consecutive working days

This rule limits the number of days an employee can be scheduled to work in a row without a rest day.

This rule can be completely configured using Custom configuration, or using Agreement value.

Location

Setting

What it controls

Allowed values / tips

Schedule Compliance > Rule set > Max consecutive working days [rule]

Maximum consecutive working days threshold

Maximum amount of days that can be scheduled for en employee in a row

Days - Integer value

Agreement / Agreement template > Rules for hours

Max days

Maximum amount of days that can be scheduled for en employee in a row

Days - Integer value

Working time

Max hours per day

This rule sets the maximum number of working hours an employee can be scheduled for in a single day.

This rule can be completely configured using Custom configuration, or using Agreement value.

Location

Setting

What it controls

Allowed values / tips

Schedule Compliance > Rule set > Max hours per day [rule]

Maximum time per day

Maximum amount of time (hours and minutes) an employee can be scheduled in a day.

Hours and minutes

Agreement / Agreement template > Rules for hours

Max hours/day

Max hours an employee can be scheduled in a day

Hours - Float value minutes defined in hundreds of one hour

Working time

Max hours per period

This rule enforces a cap on the total number of working hours over a specific period (e.g., per month).

Location

Setting

What it controls

Allowed values / tips

Schedule Compliance > Rule set > Max hours per period [rule]

Period (weeks) required

Period length which to validate max hours

Drop-down list with selectable period of 1 - 12 weeks

Schedule Compliance > Rule set > Max hours per period [rule]

Maximum time required

Maximum hours allowed.

Hours and minutes

Working time

Max hours per week

This rule sets a maximum number of hours an employee is allowed to work in a given week.

This rule can be completely configured using Custom configuration, or using Agreement value.

Location

Setting

What it controls

Allowed values / tips

Schedule Compliance > Rule set > Max hours per week [rule]

Maximum time per week

Max hours an employee can be scheduled in a week.

Hours and minutes

Agreement / Agreement template > Rules for hours

Max hours per week

Max hours an employee can be scheduled in a week.

Hours - Float value minutes defined in hundreds of one hour

Working time

Max workdays over X hours

This rule limits how many days within a defined time window an employee can work shifts that exceed a certain number of hours.

This rule can be completely configured using Custom configuration, or using Agreement value.

Location

Setting

What it controls

Allowed values / tips

Schedule Compliance > Rule set > Max workdays over X hours [rule]

Working time limit

Time limit

Hours and minutes

Schedule Compliance > Rule set > Max workdays over X hours [rule]

Maximum number of exceeding days

Amount of occasions that max can occur

Needs to be ≤ Period length

Schedule Compliance > Rule set > Max workdays over X hours [rule]

Period length (days)

Time window for which the max should apply

Needs to be ≥ Maximum number of exceeding days

Agreement / Agreement template > Rules for hours

With over hours

Time limit

Hours - Float value

Agreement / Agreement template > Rules for hours

Maximum days

Amount of occasions that max can occur

Needs to be ≤ Period length

Agreement / Agreement template > Rules for hours

During days

Time window for which the max should apply

Needs to be ≥ Maximum number of exceeding days

Working time

Min shift length

This rule ensures that shifts meet a minimum duration, preventing excessively short work periods.

Location

Setting

What it controls

Allowed values / tips

Schedule Compliance > Rule set > Min shift length [rule]

Minimum shift duration

Minimum length of a scheduled shift

Hours and minutes

Agreement / Agreement template > Rules for hours

Minimum shift length (h)

Hours - Float value minutes defined in hundreds of one hour

Working time

Nominal hours can't be exceeded

This rule restricts employees from working more than their assigned or contracted nominal hours over a given time period.

Location

Setting

What it controls

Allowed values / tips

Schedule Compliance > Rule set > Nominal hours can't be exceeded [rule]

Maximum working time per schedule period

Amount of hours to validate within the scheduling period which canʼt/shouldnʼ t be breached

Hours and minutes

Agreement / Agreement template > Working hours and periods

Working hours full time working hours

Amount of hours to validate within the scheduling period which canʼt/shouldnʼ t be breached

Hours - Float value minutes defined in hundreds of one hour

Agreement / Agreement template > Working hours and periods

Schedule period

The period length and start which the nominal hours should be validated against

Start and length of a scheduling period.

See article for more information.

Working time

Time punch exists

This rule verifies that a recorded time punch exists for a scheduled shift. It is triggered when attempting to modify or delete a shift that already has a time punch. The rule is ignored when you delete the underlying punch as well.

General

Tag validity period

This rule enforces that specific tags assigned to the shift type of a shift are within their valid date range and not expired.

Location

Setting

What it controls

Allowed values / tips

Account settings / Group settings > tags

Create/Edit/Delete

Edit and add available tags

See article for more information.

Account settings / Group settings > Shift Types

Tags

Add relevant tags to shift types

See article for more information.


How Did We Do?