Meal Penalties
Note: This integration is an extension that is developed outside the normal release schedule to meet specific customer needs. To request one of these extensions, you must submit a Salesforce Service Request to UKG. After the extension is delivered to your tenant, you can edit it to meet your needs.
Enterprise agreements can define that when a break rule is violated, employees are entitled to extra payments that are known as meal penalties. Each enterprise agreement defines its own set of meal penalties.
Example meal penalites:
- LATE MEAL PENALTY: The employee takes a break after the maximum consecutive hours someone can work without taking a break. You can configure late-penalty amounts for up to 3 breaks.
- MISSED MEAL PENALTY: The employee works a long shift without taking a meal break.
- EARLY MEAL PENALTY: The employee takes a break before having worked the minimum number of hours that is required to take the break.
- SHORT MEAL PENALTY: The employee takes a break that is shorter than the legal length.
The system monitors worked shifts and validates whether breaks are being taken according to the rules as follows:
- Rule sets are linked to pay rules.
- When a break rule is violated, the system adds a Penalty paycode A category of time or money that employees earn, for example, Regular Hours, Bonus, or Sick. to the employee’s timecard.
- The monetary value of the penalties can be configured in the paycode or by adjustment or percent allocation rules.
- A comment in the Penalty paycode provides information about which penalty was triggered.
- Break validation is done for the current and previously unsigned off pay periods. Validation can be configured to work with the elapsed shift length for late meals, or worked length excluding already taken breaks, instead of the fixed interval.

Late meal
If the employer does not allow an employee to take a 60-minute meal break for a shift of more than 6 hours, the employee is paid a penalty at the rate of 150% of the hourly base rate for each hour or part of an hour from 6 hours after the employee started work until the employer gives the employee the unpaid meal break, or until the shift ends. Breaks should not be taken earlier than 3 hours, or later than 6 hours, after start of the shift.
Parameters:
- IsLateMealPenaltyRequired = TRUE
- FirstLate = Late Meal Penalty paycode
- MealBreakAmount = 1440 to generate a penalty amount until the end of shift
- MinWorkLength = 180, the minimum work length in minutes before triggering a meal penalty
- MaxWorkLength = 360, the maximum work length in minutes before triggering a meal penalty
- MinShiftLengthFor1stMealBreak = 360, the minimum shift length in minutes to be eligible for a first meal break
Multiple late meals
Employees are entitled to the following meal breaks according to the actual time worked. Each time an employee cannot take a break within the thresholds, the employee is awarded a late-meal penalty.
- Break 1 = 15 minutes taken no later than after 4 hours of worked time.
- Break 2 = 30 minutes taken no later than after 6 hours of worked time.
- Break 3 = 15 minutes taken no later than after 9 hours of worked time.
An employee worked from 8 am—7 pm but could not take any of the 3 breaks on time.
The integration inserts a Late Meal Penalty for the time worked over 4, 6, and 9 hours until the employee took the breaks.
Because the penalties are configured to use actual hours worked and not the elapsed shift length, the penalties are at 12 pm, 2:15 pm, and 5:45 pm.
Missed meal
If the employer does not allow an employee to take a 60-minute meal break during a shift of more than 6 hours, the employee is paid a penalty at the rate of 150% of the hourly base rate for the time of the missed break.
Parameters:
- IsMissedMealPenaltyRequired = TRUE
- FirstMissed = Missed Meal Penalty paycode
- MealBreakAmount = 60, length of the break and penalty amount
- MinWorkLength = 180, the minimum work length in minutes before triggering a meal penalty
- MaxWorkLength = 360, the maximum work length in minutes before triggering a meal penalty
- MinShiftLengthFor1stMealBreak = 360, the minimum shift length in minutes to be eligible for a first meal break
Early meal
Employees cannot be required to take their break earlier than 3 hours, or later than 6 hours, after the start of the shift. If the employer requires an employee to take the break earlier, the employee is paid a penalty at the rate of 50% of the hourly base rate from the start of their break until the official start time of the break.
Parameters:
- IsEarlyMealPenaltyRequired = TRUE
- FirstEarly = Early Meal Penalty paycode
- MealBreakAmount = 180 to generate a penalty amount for a maximum of 3 hours
- MinWorkLength = 180, the minimum work length in minutes before triggering a meal penalty
- MaxWorkLength = 360, the maximum work length in minutes before triggering a meal penalty
- MinShiftLengthFor1stMealBreak = 360, the minimum shift length in minutes to be eligible for a first meal break
Short meal
Employees are entitled to a 60-minute meal break for a shift of 6 hours and longer. If the employer requires an employee to shorten the break, the employee is paid a penalty at the rate of 150% of the hourly base rate for the length of the short break.
Parameters:
- IsShortMealPenaltyRequired = TRUE
- FirstShort = Short Meal Penalty paycode
- MealBreakAmount = 60, the maximum penalty
- MinWorkLength = 180, the minimum work length in minutes before triggering a meal penalty
- MaxWorkLength = 360, the maximum work length in minutes before triggering a meal penalty
- MinShiftLengthFor1stMealBreak = 360, the minimum shift length in minutes to be eligible for a first meal break

At a high level, set up of integrations follows an Access > Deploy > Configure > Install > Run and Test > Migrate process.