Rules & violations and substitute days off
Create working-time rules, detect and process violations in the duty roster, and document substitute days off
Artwork checks shifts and individual working times against the working-time rules defined in your organisation. The markers support planning but do not replace a professional or legal assessment. Which rule applies to a person follows from the contract assigned to them on the respective day.
Rules are maintained under System → Shift settings → Rules & violations (called "Shift warnings" up to version 1.7.6). Detected violations are collected in the Open violations tab; the resulting entitlements are tracked in the Compensation days overview in the Shift plan menu.
Both tabs require the permissions Shift settings and Plan shifts; in granular mode additionally View shift rules or Edit shift rules. Editing, ignoring and resolving violations as well as the compensation days overview require Plan shifts.
Creating and maintaining rules
A rule consists of:
| Field | Meaning |
|---|---|
| Name | Free label as shown in the duty roster and in violations |
| Description | Explanation of the rule, a required field in the dialog. The text later appears in the Edit rule violation dialog below the rule name |
| Rule type | What is checked (see Rule types). The type cannot be changed after the rule has been created |
| Value | Threshold in the unit of the type: hours, days, count, or time of day. The weekly average adds Period (weeks); some types need no value or take it from the contract |
| Warning colour | Colour of the marker in the duty roster |
| Default substitute days off and Default compensation deadline (days) | Defaults proposed when processing a violation. The deadline counts in days from the date of the violation. If the rule has no deadline, Artwork proposes the deadline from the person's contract (see Editing a violation) |
| Notify on rule violation | People notified about new violations. Only people with the permission View duty rosters or Plan shifts and artwork admins can be selected. Anyone who no longer has one of these permissions receives no message and drops off the list the next time the rule is saved |
| Assign contracts | Searchable multi-select of the contract templates the rule applies to |
Without a contract the rule checks nobody
A rule without assigned contracts applies to nobody. Only people who have one of the assigned contracts in their profile are checked.
Above the rule list, the toggle By rule / By contract switches the view. By rule shows the rule list. By contract lists the contract templates with the columns Active for (people with this contract) and Assigned rules; via Edit rule assignment you tick the rules that apply to everyone with this contract. Changes to rules or contracts immediately trigger a re-check of the affected people; nothing needs to be started manually.
When you delete a rule, Artwork removes its active, automatically detected violations. Processed, ignored and manually recorded violations are kept as history.
Creating legal default rules
The button Create legal default rules creates the rule set according to the German Working Hours Act (ArbZG) in one step and assigns it to the selected contract templates:
- daily maximum 10 h,
- weekly maximum 48 h,
- rest time 11 h,
- at most 6 consecutive working days,
- work on Sunday with replacement rest day (default: 1 substitute day off within 14 days),
- work on special days with replacement rest day (default: 1 substitute day off within 56 days),
- 15 free Sundays per calendar year,
- weekly average 48 h over 24 weeks,
- night work maximum 8 h.
In the dialog all rules and all contract templates are preselected. Under Rules to create you tick or untick the rules, choose the contracts and confirm with Create selected rules. If a rule with the same type and the same value already exists (for the weekly average also the same period), it is only assigned to the contracts still missing and not created twice; a deactivated rule is reactivated in the process. A rule of the same type with a different value, for example a daily maximum of 9 h, does not count as existing: the default rule is then created in addition. The created rules are ordinary rules afterwards: name, values, colour, and assignment can be adjusted.
Check the default values
The default rules reflect the Working Hours Act. If a collective agreement or works agreement with different thresholds applies in your organisation, adjust the values after creating them.
Rule types
| Rule type | What Artwork checks |
|---|---|
| Daily maximum of hours | Total planned working time of a person per day (shifts plus individual times) |
| Weekly maximum of hours | Total planned working time per week (Monday to Sunday, shifts plus individual times) |
| Maximum consecutive working days | Number of working days without a day off in between. Every day with a shift or an individual time counts as a working day |
| Rest time before a working day | Interval between the end of work on the previous day and the first start of work on a working day (neither Sunday nor special day), plus the gap between two assignments on the same day |
| Rest time before a Sunday or special day | The same check when the day on which work starts is a Sunday or special day |
| Rest time between shift groups | Minimum interval between consecutive shifts of different shift groups that start on the same day. Shifts without a shift group are left out |
| Work on Sunday | Creates a violation for every Sunday with a shift, documenting the entitlement to a replacement rest day (no value required) |
| Work on special day | Like work on Sunday, for public holidays flagged as special day with the contract switch active |
| Minimum free Sundays per calendar year | Whether the person can still reach the minimum number of free Sundays in the year; empty = legal default of 15 |
| Average weekly hours over a compensation period | Rolling average of planned weekly hours over the last n weeks (Period (weeks)) |
| Daily maximum on days with night work | Maximum working time on days with at least 2 hours within the night window of the shift settings; empty = 8 hours |
| Minimum whole free days per week | Whole free days per calendar week; empty = "free whole days per week" from the contract |
| Overtime reduction deadline | Warns before open overtime exceeds its reduction deadline; applies to contracts with the overtime rule active |
| Minimum free Sundays with Saturday/Monday per season half | Whether the target of free Sundays with a free Saturday or Monday per season half is still reachable; empty = target from the contract |
| Conflict: half day off / shift | Whether a shift collides with a half day off; the value is the time-of-day threshold |
| No half day off on special days | Reports a half compensation day that was granted on a special day. Granting it remains possible; the dialog points out the rule beforehand |
| Minimum days before binding commitment | Reports the person's shifts that start within the configured number of days from today and are not yet committed |
The hint below each rule type in the interface explains how to read the value. Some rules create violations without a shift, for example on the last Sunday of the year when the free Sundays are no longer reachable, or on the deadline day of the overtime reduction deadline.
Automatically detected violations have the severity Warning. They only become an Error for four rule types, once nothing can be changed any more: free Sundays per calendar year after the end of the year, free days per week after the week has passed, free Sundays per season half after its end, and the overtime reduction deadline after the deadline day. The follow-up violation for an expired compensation-day deadline is an error as well.
Details people stumble over in daily work:
- Work on Sunday counts the day on which the shift starts. A shift from Saturday evening to Sunday morning therefore creates no violation. Individual times on a Sunday do not trigger the rule.
- Rest time: the comparison only looks at the directly preceding calendar day; individual times count as work. Two assignments on the same day with a gap shorter than the rest time also create a violation on the later shift, for example with split duties. If you plan split duties, a rest time of 11 hours therefore produces violations regularly.
- Weekly maximum: once the limit is exceeded, every further working day of that week gets a violation, not only the first one.
- Maximum consecutive working days: the violation is created on every day above the limit on which the person has a shift. Days with only an individual time extend the streak but carry no violation.
- Minimum days before binding commitment: once the shift is committed, the next automatic check removes the violation.
- Conflict: half day off / shift: with a morning off the shift must start at the configured time at the earliest, with an afternoon off it must end by then at the latest.
- Overtime reduction deadline: the value is the number of days before the deadline from which a warning is created. After the deadline the warning becomes an error.
- Minimum whole free days per week: the week runs from Monday to Sunday. A day is free if it has neither a shift nor an individual time; shifts past midnight occupy both days. The violation appears on the Sunday of the week. If the contract says 0, the rule does not apply to that person.
- Average weekly hours: one violation is created per week, on the last shift of that week. Weeks whose period has less than half of its weeks planned are not reported.
- Minimum free Sundays with Saturday/Monday per season half uses the season from the tool settings. If none is stored there, Artwork falls back to the current calendar year; the hint text on the rule type says so as well Coming with the next update. The violation sits on the last Sunday of the half; a half that has not started yet is not evaluated.
How the check calculates
- All checks use the person's individual shift times. If a person has deviating times in a shift, their own time counts.
- Daily and weekly maximum count shifts and individual times; violations are also reported without a shift when individual times alone exceed the limit.
- The night-work rule evaluates shifts past midnight as a whole.
- Breaks are applied according to the break rules, including the 9-hour threshold.
- Special days only count if the public holiday carries the flag Treat as special day. The rule Work on special day additionally requires Special day rule active in the person's contract (see Public holidays and special days).
- People without a contract are not checked.
When the check runs: as soon as you assign, remove or replace people, change shift times, delete shifts or change rules and contracts, Artwork checks the affected people. In addition, a check over the next 14 days runs every five minutes. A violation caused by an individual time alone appears with the next of these checks; if the day lies further in the future, at the latest when it moves into the 14-day window.
Violations disappear on their own as soon as the conflict is resolved by changes to shifts or individual times and the next check has run. Processed, ignored, and manually recorded violations are kept, as are follow-up violations for an expired deadline (see Substitute days off).
Why two people may be evaluated differently
Rules are assigned to contract templates, and a person's contract has a validity period. Two people in the same shift may therefore receive different markers. If an expected marker is missing, check:
- Is the rule assigned to the correct contract template?
- Was a contract with this template valid on the relevant day (timeline under Contract & working hours)? Coming with the next update Daily rules such as daily maximum, rest times, weekly maximum, consecutive days, weekly average, night work, and work on Sundays and special days follow the contract of the day the violation is booked on. Rules over a period (free days per week, free Sundays per season half and per calendar year) follow the last day in the counted period on which a contract applies, even if that contract ends before the booking day. The overtime reduction deadline follows the contract the overtime comes from; the warning continues after someone leaves. No rules apply on days without a contract.
- Are all shifts, breaks, and individual working times complete?
- For special-day rules: does the holiday carry the special-day flag? For Work on special day also: is the special day rule active in the contract?
Markers in the duty roster
While assigning staff, Artwork surfaces conflicts as early as possible. Besides working-time rules this includes overlaps, missing qualifications, absences, or multiple assignments. Depending on configuration, planners may still continue. That only means the action is technically possible, not that the conflict is resolved.
In the duty roster the person cell shows rule violations with two markers:
- a warning triangle in the rule's warning colour; from two open violations on that day the number is shown next to it,
- a check chip with the number of violations already processed.
Ignored violations are not shown in the cell. The tooltip names rule, status, and measured value, for example "17 h of max. 10 h"; a click opens the person's day. The legend is in the duty roster's help panel. Employees also see their own open violations in My operational plan.
Open violations
The Open violations tab under System → Shift settings lists all violations with person, date, rule, severity, status, and measured value. Use the filters to narrow the list:
- Period (From / To): at most one year; longer periods are cut with a notice; without a period all violations of the selected status are listed,
- Crafts, Person, and Rule,
- Severity (Warning / Error) and Status (Active / Processed / Ignored / All statuses). Active is preselected, so the list initially shows only open violations,
- Sort (Newest first / Oldest first).
The chips above the list count the active violations in total and separately as Errors and Warnings; long lists are paginated. Export as Excel outputs the filtered list; without a period Artwork exports the current month. An export covers at most one year.
Each active violation offers three actions:
| Action | Effect |
|---|---|
| Edit | Opens the dialog in which you set substitute days off and the deadline (see Editing a violation). The days are credited to the person's account |
| Resolve | Marks the violation as done, without further consequences and without substitute days off |
| Ignore | Discards the violation with a reason (required, at most 500 characters) that remains visible on the violation |
Resolve cannot be undone: for a resolved violation the dialog no longer offers to book substitute days off. Choose Edit if an entitlement is meant to arise. You can still open an already processed violation via Edit to see details and history.
Several selected active violations can be ignored together with one reason, at most 200 at once.
A case Artwork does not detect automatically is recorded in the duty roster: open the person's day in the workforce panel and choose Add rule violation. Choose a rule or Other (without rule) with your own title (at most 120 characters) and enter date, severity, and reason. The manual violation then appears in the list like any other.
Ignoring remains a documented decision
An ignored violation disappears from open processing but does not make the plan compliant with the rule. Use a specific reason so the decision remains understandable later.
Editing a violation
The dialog Edit rule violation shows the details of the violation (measured values such as planned hours, rest hours, or consecutive days) and the History tab with all previous steps. When editing you define:
- the number of substitute days off in half steps (0.5; 1; 1.5 …). The rule's default is prefilled, otherwise half a day. 1.5 days become one whole and one half entitlement,
- the deadline by which the substitute day off must be granted. It is required and must lie in the future. The hint Default according to rule: n days or Default according to contract applies the stored default. The default from the contract is only offered when you open the violation from the person's day in the duty roster or from their profile; in the Open violations tab the field stays empty if the rule has no deadline,
- a reason (optional),
- whether it is a Compensation day for public holiday, which reduces the daily target. For violations of the rule Work on special day the checkbox is preselected.
Saving books immediately
The substitute days off you enter are credited to the person's account when you save. This is a booking that affects the account, not just a display.
After saving, the violation carries the note Processed/approved by … on …. It can be edited again as long as no substitute day off has been granted; after that the violation is locked. You can also ignore an active violation directly from this dialog.
Recommended order
Substitute days off: entitlement versus actual time off
Recording the entitlement and granting the actual free period are two separate steps. The Compensation days overview in the Shift plan menu (permission Plan shifts) shows Overdue, Open, and Granted compensation days with counters and Recent activity. The lists can be filtered by Person, Craft, Deadline from / until, and Status and are paginated; Export as Excel outputs the filtered list. The same entitlements appear in the person's profile under Substitute days off.
Via Grant compensation day you choose the date. A substitute day off can be granted as a full day or, morning or afternoon, as a half day. Both turns a half entitlement into a whole day off; for this Artwork uses a second open half day of the person. For the chosen date, Artwork checks whether shifts or special day conditions already exist. If there are shifts on that day, you choose between Remove shifts and grant and Grant without removing shifts; alternatively pick another day. You can only remove the shifts if you may plan their crafts. Granted days appear in the person cell of the duty roster.
Review shifts that are removed
If a substitute day off is granted despite an existing assignment and the shifts are removed, new staffing gaps may arise. Check the affected shifts afterwards and inform everyone involved.
A grant can be taken back with Revoke. The entitlement is then open again and must be scheduled anew; the history remains traceable. Delete removes an entitlement entirely and requires a Reason for deletion, which is shown in the recent activity.
If the deadline passes without the day being granted, the entitlement is listed under Overdue compensation days. In addition, the automatic rule check creates a new violation with severity error and the measured value Compensation deadline expired, which refers to the original violation. This follow-up violation does not disappear on its own. Grant or delete the overdue entitlement and resolve, ignore or process the follow-up violation. For the same deadline the check does not create a new follow-up violation afterwards Coming with the next update. If you process the original violation again and the new deadline passes, a follow-up violation is created again.
Public holidays and special days
The rules Work on special day, Rest time before a Sunday or special day, and No half day off on special days, as well as the target reduction in the hours account, share one definition: a day is a special day if the public holiday in the event settings carries the flag Treat as special day. School holidays without the flag are never special days. The contract switch Special day rule active additionally decides whether the rule Work on special day and the target reduction apply to the person. The other two rules do not evaluate the switch: they apply to everyone whose contract has the rule assigned. For No half day off on special days the hint text on the rule type says so as well Coming with the next update. Work on special day evaluates every special day in the period separately within a check run, even if an earlier special day does not count for the person Coming with the next update. Shift planners can maintain the special-day checkboxes on the holidays page themselves, even without write access to the other settings.
A violation on a special day can be processed as Compensation day for public holiday; the granted day then reduces the daily target (see Special days).
Responsibilities in practice
| Role | Typical task |
|---|---|
| Administration / HR | Maintain rules, thresholds, and contract assignment |
| Shift planning | Check markers while assigning and correct working times |
| Approval / management | Understand deliberate deviations and reasons |
| HR administration | Track entitlements to substitute days off, deadlines, and actual days off |
| Employee | Review own operational plan and report incorrect times |
Before closing a period
- Are all open violations processed or explained?
- Do manual violations have a meaningful title and reason?
- Are entitlements to substitute days off and deadlines complete?
- Were granted days off checked against existing shifts?
- Have post-commitment changes reached the approval workflow?
Last updated on