TABLE OF CONTENTS

• Employee Category Dashboard — Lunch settings
• Configure Lunch
  • Global Lunch Settings
  • Employee Category-Specific Lunch Settings
• Lunch Settings
  • Auto-Deducted Lunch
  • Manual Lunch
    • Schedule Lunches (for Manual Lunch)
    • Customize Lunch Notifications (for Manual Lunch)

Employee Category Dashboard — Lunch settings

Use the Employee Categories dashboard to configure auto-deducted lucnh, manual lunch, “Lunch Coming” push notifications in the mobile app. 

For now, the dashboard is accessible only to specific users in the Administrators user group.

Configure Lunch

Global Lunch Settings

Lunch settings can be applied globally across the entire instance or configured specifically for individual employee categories.

To set global lunch settings:

1. Go to the Employee Categories dashboard.
2. Click the Gear icon in the top-right corner.
3. In the window that opens, configure the lunch settings (details below).

Employee Category-Specific Lunch Settings

To configure lunch rules for a specific employee category:

1. In the Employee Categories dashboard, click the Edit icon on the row of the desired category.
2. In the window that opens, adjust the lunch settings as needed.

Lunch Settings

Auto-Deducted Lunch

To enable automatic lunch deduction:

1. In the Common Settings section, turn OFF the “Allow manual lunch” toggle. (All manual lunch options will then be hidden.)
2. Turn ON the “Auto deduction” switch.

Scheduled Lunches (Auto-Deduction Rules)

In the Scheduled Lunches section, click + Add Lunch to create auto-deduction rules. Example: deduct 30 minutes after 4 hours worked.

• Duration – Deduction time in minutes.
• Apply for workshifts longer than (hh:mm) – The rule applies only to shifts exceeding this duration.
• Count approved time only (optional) – If enabled, the deduction is based only on approved hours (not clocked hours).

Approved vs. Clocked Hours: Approved hours may be lower than clocked hours due to audits (e.g., time spent in unauthorized locations is zeroed out).

• Turn ON “Make auto deduction” to automatically subtract the specified duration from clocked or approved time.
  • If turned OFF, no automatic deduction occurs; the system only creates an audit notification. A Time Card Reviewer or TK Manager can then deduct time manually via the Time Card Adjustment interface.

Manual Lunch

To allow employees to record lunch manually:

1. Turn ON the “Allow manual lunch” toggle. (Auto-deduction options will be hidden.)

Common Settings for Manual Lunch

• Allow waive lunch – Employees can skip lunch (comments required). Waived lunches appear on the GPS timeline with a flag and 0 hours duration. There is no limit on how many times an employee may waive lunch.
• Require confirmation – Employees must manually end their lunch break.
• Minimum duration (in minutes) – Default/minimum lunch length employees can select in the mobile app (max 100 minutes). Leave blank if there is no minimum.

Lunch Compliance Alerts

Enable these alerts to flag manual lunches that do not meet category requirements. When triggered, the system creates audit results.

• Late Lunch – Lunch taken later than scheduled.
• Waived Lunch – Any shift with a waived lunch.
• Insufficient Lunch duration – Lunch shorter than the minimum duration.
• Missed Lunch – No lunch recorded when one was scheduled.
• Extra Lunch – More lunches recorded than scheduled.
• Meal Premium – Audits meal compliance and applies meal premium hours (must be used together with “Missed Lunch”).

Schedule Lunches (for Manual Lunch)

In the Scheduled Lunches section, click + Add Lunch to define expected lunch times, default duration, notifications, etc.

• Duration (in minutes) – Default duration pre-filled in the mobile app. Employees may take a shorter lunch if allowed by the minimum duration setting.
• Time after clock-in (hh:mm) – When the lunch break should start.

Meal Premium Audit Settings

• Apply for workshifts longer than (hh:mm) – Only shifts exceeding this length are audited for meal compliance.
• Count approved time only (optional) – Uses approved hours instead of clocked hours for the duration check.
• Add meal premium – Automatically adds premium hours when compliance rules are violated.

Customize Lunch Notifications (for Manual Lunch)

In the Notifications section, configure push notifications for each scheduled lunch:

• In advance – Turn on to send a reminder before the expected lunch time. Enter the notification text and how far in advance it should be sent.
• On deadline – Turn on to notify the employee when the lunch window is about to close. Enter the notification text.