Washington (WA) State Rest and Meal Breaks Compliance

The Washington (WA) State Rest and Meal Breaks Compliance extension delivers a mechanism for employees, who work in healthcare organizations within Washington State, to report missed meal and rest breaks.

Note: This business process is an extension model that is developed outside the normal release schedule to meet specific customer needs. To request one of these models, you must submit a Salesforce Service Request to UKG. After the model is delivered to your tenant, you can edit it to meet your needs.

Accumulated attestation data gathered by the workflow provides employers with the ability to comply with quarterly reporting requirements stipulated by Washington Department of Labor and Industries regulations. This reporting requirement ensures that hospitals meet certain compliance thresholds (KPI %) that compare required and missed break periods.

An additional benefit of this extension is that employers now have insight into potential problem areas within the organization where breaks are frequently missed.

How it works

When the employee punches out at the end of the day, this workflow calculates the worked shift length and then prompts the employee with a series of questions. In response, the employee attests to the number of rest or meal breaks that were missed, and the premium zone in which the missed breaks occurred.

The attestation data, gathered in accordance with defined configurations, is utilized to calculate the compliance rate.

Thresholds

Thresholds, which are configured in Attestation settings to define when rest and meal breaks must be taken, provide the workflow with appropriate credit and penalty values that are added to the Timecard.

Default threshold values are included in a gold template provided with this extension.

Default threshold values

Time worked	Rest breaks	Meal breaks
>= 03:00	One 15-minute break	-
>= 05:30	Two 15-minute breaks	One 30-minute break
>=10:30	Three 15-minute breaks	Two 30-minute breaks
>=15:30	Four 15-minute breaks	Three 30-minute breaks
>=20:30	Five 15-minute breaks	Four 30-minute breaks

Credit and compensation (penalties)

After the employee attests that they missed a rest or meal break, the full duration of the missed break is credited to the Timecard.

Employees receive penalty pay as additional compensation for each missed rest and meal break. Penalty pay is enabled by default in the gold template provided with the extension; however, you can disable this option in accordance with policies that exist in your organization.

Meal break waiver

Some employees opt to voluntarily waive their right to a second meal break. You must configure and assign a different Attestation profile that includes a reduced number of breaks to these employees.

Compliance Rate

The Washington State Department of Labor and Industries requires healthcare facilities to submit the compliance rate percentage on a quarterly basis to determine if the state standards are met by the entire facility. This single rate, which represents the facility’s compliance, is measured using the following formula:

Compliance Rate KPI (%) = 100 –(Missed Rests + Missed Breaks * 100)/(Required Rests + Required Meals)

For example, assume that a registered nurse (RN) works 70 shifts during the previous quarter. The total length of the worked shifts entitles the RN to a total of 70 meal breaks and 140 rest breaks.

Over the course of the quarter, the RN attests that one meal break and two rest breaks were missed.

Compliance Rate KPI (%) = 100 – ((1 + 2) * 100) / (70 + 140) = 98.57%

The Washington State Department of Labor and Industries requires that the compliance rate be reported for the entire facility; however, the Dataview can provide details at various levels of the organization, even at the employee level.

Tracking functionality

Standard Attestation only captures the number of missed rest or meal breaks, as reported by the employee. However, to calculate the compliance rate, the system must determine the number of breaks to which the employee is entitled based on their working shift length.

This logic is incorporated into the workflow and requires four tracking paycodes that must be configured in UKG Pro Workforce Management (UKG Pro WFM). Additionally, for reporting purposes, the workflow records the number of worked shifts with a fifth tracking paycode.

Tracking Required Rests
Tracking Required Meals
Tracking Missed Rests
Tracking Missed Meals
Tracking Worked Shifts

This workflow is designed to utilize money-based paycodes for tracking, and each of the five noted tracking paycodes must be configured as money-based. The primary reason for this configuration is that money-based paycodes are best suited to represent the occurrence metric in the Compliance KPI Dataview and Charts.

Caution: The five tracking paycodes do not represent any monetary value, and are used only in the backend to calculate the Compliance KPI. We recommend that you configure these paycodes as hidden.

Attestation logic – Meals

The workflow expects that meal breaks are configured as automatic deductions in the work rules. When the employee attests that they missed a meal break, the workflow adds paycodes to the Timecard as follows:

A credit paycode for each missed break to restore the time that was deducted.
(optional) A compensation paycode for each missed break, if the organization chooses to apply penalty pay for missed meals.
A shift premium paycode for each missed meal break that falls within a shift premium zone.

Contents in the table below summarize workflow actions taken for multiple missed meal breaks.

Multiple meal breaks actions

Meals missed	Missed Meal Credit	Missed Meal Compensation	Missed Meal Shift Premium 1, 2, or 3
1	0:30	0:30	0:30
2	1:00	1:00	1:00
3	1:30	1:30	1:30
4	2:00	2:00	2:00

Note: The workflow accommodates a maximum of four (4) meal breaks.

Attestation logic – Rests

Rest breaks are paid and therefore not configured as deductions in the work rules.

When the employee attests that a rest break is missed, the workflow adds paycodes to the Timecard as follows:

A credit paycode for each missed break to restore the time that was deducted.
(optional) A compensation paycode for each missed break, if the organization chooses to apply penalty pay for missed meals.
A shift premium paycode for each missed meal break that falls within a shift premium zone.

Contents in the table below summarize workflow actions taken for multiple missed rest breaks.

Multiple rest breaks actions

Rests missed	Missed Rest Credit	Missed Rest Compensation	Missed Rest Shift Premium 1, 2, or 3
1	0:15	0:15	0:15
2	0:30	0:30	0:30
3	0:45	0:45	0:45
4	1:00	1:00	1:00
5	1:15	1:15	1:15

Note: The workflow accommodates a maximum of five (5) rest breaks.

Attestation questions – Meal and rest breaks

Depending on the length of the worked shift, the workflow initiates different forms and questions during the Attestation process.

You configure the phrasing and language of the questions in the locale policy decision table referenced by the workflow. A gold template includes questions appropriate to the missed meal and rest breaks.

The process logic for missed meal and rest break questions takes two possible flows.

First, the employee must respond as to whether all meal or rest breaks were taken.

If the response is Yes, no further questions are required.

If the response is No, the employee must provide the number of missed breaks and the start time of the missed scheduled break.

Shift premiums

The workflow adds an additional paycode for the missed shift premium when the employee misses a meal or rest break that falls within a shift premium zone. To determine the applicable shift premium, the workflow uses the break start time provided by the employee during attestation.

Premium zones, configurable in the workflow, are provided in a gold template with the following default values:

Zone 1 (07:00 AM – 03:00 PM)
Zone 2 (03:00 PM – 11:00 PM)
Zone 3 (11:00 PM – 07:00 AM)

Cost center and labor category transfers

Beginning with version 2.1 of the workflow, the business process honors transfers that impact the assignment of credit, compensation, and shift premium paycode entries in the Timecard.

When an employee is scheduled to work a shift segment in a different cost center or labor category, the hours are assigned to the corresponding cost center or category.

For example, an employee works across two different cost centers and contributes to two projects. Each are tracked with a unique labor category.

During the first part of the shift, the employee works in their primary cost center and labor category.

For the remainder of the shift, while working in another cost center, the employee misses a rest break. The workflow automatically assigns the credit, compensation, and shift premium paycodes to the transferred cost center and labor category to ensure accurate payment allocation.

Manual attestation

When an employee fails to punch Out, and subsequently misses the attestation process, they can retroactively attest by launching attestation from the My Business Processes tile. The employee selects the past date, and then proceeds to answer the same questions that are presented during an Out punch.

For example, an employee forgets to punch Out at the end of their shift. The manager adds the missing Out punch in the employee's Timecard.

When the employee returns to work on the following day, they launch Rest and Meal Breaks Compliance from their home page to attest for the previous day.

Note: Attestation is not available on signed-off dates.

Considerations and limitations

An attestation profile must be assigned to employees.
The punch interpretation rule that is assigned to the employee's pay rule must be configured to accept Out punches for the maximum shift length an employee can work.
Deduction rules must be configured with matching meal break deduction amounts. By default, meal breaks are set as 0:30.
Work rules must be configured with deduction rules that cover meal breaks.
The application system setting site.timekeeping.service.attestation.lookback.minutes must be configured such that attestation conditions apply when shift durations exceed the defined value.
This attestation workflow supports only one scheduled shift during a day. When multiple shifts are scheduled, only the first shift initiates attestation.
When editing is enabled in the signed-off pay period, meal and rest break compliance attestation is allowed.
When an employee misses a break that is scheduled during a Cost Center or Labor Category transfer segment, the workflow assigns the paycode to the transfer string.
The workflow determines the appropriate zone and transfer string based on the employee-provided break start time in the attestation form.
If a manager corrects an employee's missing Out punch, the employee must complete meal and break compliance attestation for the past shift from the My Business Processes tile.
With the introduction of version 2.1, the workflow no longer cancels the first meal deduction, but instead assigns a credit.

User experience

Attestation

A Registered Nurse (RN) who works for a hospital in Washington State completes a 12-hour shift. The shift length entitles the RN to three 15-minute rest breaks and two 30-minute meal breaks.

The shift is extremely hectic and causes the RN to miss two rest breaks and the second meal break. When the RN punches out, the following Meal Break Attestation questions are presented.

Were you able to take all of your breaks?
How many breaks did you miss?
When were you supposed to take your missed meal break?

These are followed with Rest Break Attestation questions.

Were you able to take all of your breaks?
How many breaks did you miss?
When were you supposed to take your missed rest break?
When were you supposed to take your second missed rest break?

After all questions are answered, the workflow adds paycode edits to the Timecard.

Note: It is possible for the employee to miss multiple breaks within the same zone.

Timecard results

To illustrate the Timecard results, we continue to follow the RN from the Attestation scenario.

After navigating to the Timecard, we observe the Credit and Compensation (or penalty) paycodes added to the Timecard by the workflow. Tracking paycodes are also added to the Timecard.

Note: As a best practice, tracking paycodes used in the attestation workflow are typically configured as hidden. The tracking paycodes noted in this example are for illustration purposes only.

Timecard paycode edits

Paycode name	Paycode amount	Description
Missed Meal Compensation	0:30	Compensation for the missed meal break.
Missed Meal Credit	0:30	Credit to restore the time for the missed meal break.
Missed Meal Shift Premium 1	0:30	Shift Premium 1 since the missed meal break occurred in Zone 1.
Missed Rest Compensation	0:15	Compensation for the first missed rest break.
Missed Rest Compensation	0:15	Compensation for the second missed rest break.
Missed Rest Credit	0:15	Credit to restore the time for the first missed rest break.
Missed Rest Credit	0:15	Credit to restore the time for the second missed rest break.
Missed Rest Shift Premium 1	0:15	Shift Premium 1 since the first missed rest break occurred in Zone 1.
Missed Rest Shift Premium 2	0:15	Shift Premium 2 since the first missed rest break occurred in Zone 2.
Tracking Missed Meals	USD1.00	(Hidden) Tracks the one missed meal response captured during the Attestation workflow.
Tracking Missed Rests	USD2.00	(Hidden) Tracks the two missed breaks response captured during the Attestation workflow.
Tracking Required Meals	USD2.00	(Hidden) Tracks the number of required meals based on the shift length worked by the RN.
Tracking Required Breaks	USD3.00	(Hidden) Tracks the number of required breaks based on the shift length worked by the RN.
Tracking Worked Shifts	USD1.00	(Hidden) Tracks the number of shifts worked by the RN.

Compliance Report - Basic

Since both required and missed rest and meal breaks are tracked using paycodes, a basic Employee Dataview provides the paycode totals needed to calculate the Compliance Rate KPI (%).

Note: A gold template contains the basic compliance Dataview.

Navigate to the Dataview Library and open the WA State Rest and Meals Compliance Report. After the Dataview opens, use the Share option to generate a CSV export file that you can open in Excel™, where you then calculate the compliance rate.

Note: The Employee Dataview allows you to focus on specific locations or employees so that you can identify areas where breaks are often missed.

Compliance Report with KPI and Charts

Alternatively, if your organization utilizes the Analytics feature in UKG Pro WFM, you can automate the KPI calculation through use of the Compliance Dataview with KPI and Charts provided in a gold template.

With the KPI Builder options, tracking paycodes are mapped into Metrics, and you then configure the KPI Definition with the following KPI Formula:

100 – (((SM<MISSEDMEALS>+SM<MISSEDRESTS>) * 100) / (SM<REQUIREDMEALS> + <REQUIREDRESTS>))

Note:

The gold template requires grouping by the following three business structure types: Facility, Service Line, and Department.

If these do not exist or your organization requires grouping on different types, the SDM JSON must be updated. Reach out to a professional services consultant for assistance, when needed.

Before you start

Before you implement this business process, you must configure the following:

System settings: Adjust the system setting site.timekeeping.service.attestation.lookback.minutes to the maximum look back in minutes for Attestation. For example, if the employee is allowed to extend their worked shift up to 24 continuous hours, adjust this system setting to 1440.
Attestation buttons: Create an attestation button that the employee uses to register the out-punch. See the Attestation Buttons topic.

For example:

Button Name: Punch

Button Type: Punch

Show Assignment as devices: Employee selects Assignment

Punch Collection Time: Capture time before attestation

Timecard Timeframe: Today

Display Type: Web and Clock
Attestation conditions: Create an attestation condition that initiates the attestation model based on the length of the shift at every out-punch.
See the Attestation Conditions topic.

Name: Punched In

Condition Type: Punch Status

Condition Operator: Punched In
Attestation assignments: Create an attestation assignment that connects the Attestation model (business process) with the punch button to initiate the appropriate workflow based on the assigned conditions. Use this attestation assignment in the Attestation Profile.
See the Attestation Assignments topic.

Name: WA State Rest and Meal Breaks

Button: Punch

Condition: Punched In

Punch Button Workflow: WAStateRestAndMealBreaksCompliance_v2.2
Attestation profiles: Create an attestation profile. See the Attestation Profiles topic. Assign the attestation profiles to employees who punch using a timeclock or timestamp.

Name: WA State Rest and Meal Breaks
Paycodes: Create multiple standard hours and money-based paycodes that you add to decision tables for reference by the workflow process. Hours paycodes credit or compensate the employee for missed rest and meal breaks; and money paycodes track the number of required rest and meal breaks then calculate the compliance ratio. Required standard paycodes and associated unites are listed below.
See the Paycode definition topic.
Note: We suggest that you configure the money-based paycodes that are intended for use with this extension as hidden from the Timecard and reports.
Tracking Required Meals: Tracks the number of required meals assigned to the employee during a worked shift.

Name: Tracking Required Meals

Unit: Money

Tracking Required Rests: Tracks the number of required rests assigned to the employee during a worked shift.

Name: Tracking Required Rests

Unit: Money

Tracking Missed Meals: Tracks the number of missed meals during a worked shift as attested by the employee.

Name: Tracking Missed Meals

Unit: Money

Tracking Missed Rests: Tracks the number of missed rests during a worked shift as attested by the employee.

Name: Tracking Missed Rests

Unit: Money

Tracking Worked Shifts: Tracks the number of shifts worked by the employee.

Name: Tracking Worked Shifts

Unit: Money

Missed Meal Credit: Awards compensation to the employee for missed meals.

Name: Missed Meal Credit

Unit: Hours

Missed Meal Credit Premium 1: Credits the employee with a premium for missed meal in Zone 1.

Name: Missed Meal Credit Premium 1

Unit: Hours

Missed Meal Credit Premium 2: Awards premium compensation to the employee for a missed meal that falls in Zone 2.

Name: Missed Meal Credit Premium 2

Unit: Hours

Missed Meal Credit Premium 3: Awards premium compensation to the employee for a missed meal that falls in Zone 3.

Name: Missed Meal Credit Premium 3

Unit: Hours

Missed Meal Penalty: Awards compensation to the employee for missed meals when penalties apply.

Name: Missed Meal Penalty

Unit: Hours
Note: If you require unique compensation paycodes to represent missed meal penalties for each premium zone, you must create additional hours-based paycodes.

Missed Rest Credit: Credits the employee for a missed rest break.

Name: Missed Rest Credit

Unit: Hours

Missed Rest Credit Premium 1: Credits the employee with a premium for missed rest in Zone 1.

Name: Missed Rest Credit Premium 1

Unit: Hours

Missed Rest Credit Premium 2: Credits the employee with a premium for missed rest in Zone 2.

Name: Missed Rest Credit Premium 2

Unit: Hours

Missed Rest Credit Premium 3: Credits the employee with a premium for missed rest in Zone 3.

Name: Missed Rest Credit Premium 3

Unit: Hours

Missed Rest Penalty: Awards compensation to the employee for missed rest when penalties apply.

Name: Missed Rest Penalty

Unit: Hours
Note: If you require unique compensation paycodes to represent missed rest penalties for each premium zone, you must create additional hours-based paycodes.
Bonus/Deduction rules: Create deduction rules associated with different shift lengths (10:30, 15:30, and 20:30) that automatically deduct the meal breaks. For example, create a deduction rule such as WA 30 Minutes First Meal Break that initiates when the employee works for 5:30 hours. Add the deduction rules to the employee work rule to automatically deduct the meal amount when the employee does not take the assigned meal break.
See the Bonus and Deductions topic.
Note: Break deduction amounts must match across all deduction rules created for use with this extension.
Punch interpretation rules: Create a punch interpretation rule that qualifies whether an out-punch meets required shift duration. The rule must be configured such that it does not initiate the missed-out punch exception when the employee extends their worked shift. For example, if an employee is allowed to extend their worked shift up to a 24-hour continuous span, set Missed Out Limit= 24:00.
See the Punch Interpretation Rules topic.

Configure the WA State Rest and Meal Breaks Compliance business process model

Migrate the business process models to the tenant: Migrate the WA State Rest and Meal Breaks Compliance process models to the customer tenant using Setup Data Manager (SDM).
1. Log in to the appropriate tenant.
2. Go to Main Menu > Administration > Setup Data Manager.
3. Select the Source tenant where the Process Model resides, and select the template to copy. It is a .zip file. A message appears in the Source column: Source: Import from <filename>.zip.
4. Click Tap Review and Publish. The Publish Summary panel appears.
5. Review the Publish Summary panel. It lists the items that were extracted from the migration file. If you approve, click tap Publish with Comment or just Publish.
6. Click Tap Go to Publish History at the bottom of the panel to view the status of the data transfer. The Publish History page contains a table that lists the items you have published. If there were errors during the transfer, the button under the Errors column for that row is black.
7. To view details, click tap the appropriate row and click tap View Selected.
8. On the History for publish run page, click tap Show all to view the setup data that you published, and the errors that occurred, if any, listed by item type and name.

Configure the WA State Rest and Meal Breaks Compliance decision tables:

Note: Decision tables are configurable based on user requirements and can be changed accordingly. These tables are dynamic and can be updated at any time without redeployment of the process model.

Go to Main Menu > Administration > Application Setup > Business Process Setup > Process Models.
Select the WAStateRestAndMealBreaksCompliance_v2.2 process model and click tap Edit. The process model enters edit mode.
Select the Decision Tables tab.
Click Tap Everyone's, and then select the decision table to edit.
Click Tap Decision Table Editor to add or update the rows in the table.
Click Tap Save and Close.

Edit the following decision tables:

Caution:

Values entered in the decision tables are case-sensitive, and must match configured values in the application.
Do not remove variables, variable names, or variable types from any decision table.

WARestAndMealCompliance_v2_2_InternalParameter— Provides the workflow system configuration variables. Default values are configured to optimize the performance of the workflow.

Caution: Do not change parameters or values in the _InternalParameters decision table.

WA State Rest and Meal Compliance — Internal Parameters decision table structure

Parameter name	Description	Default value
employee	Stores the employee id of the employee who initiates the workflow.	Employee
admin	Specifies the admin user who applies the paycodes.	SERVICES-LEVEL3

WARestAndMealCompliance_v2_2_Parameter— Identifies application setup information that the WA State Rest and Meal Breaks Compliance workflow requires for processing. The gold template includes the default values shown below.

WA State Rest and Meal Compliance — Parameter decision table structure

Attestation profile	Parameter name	Default value	Description
!=empty	TrackingWorkedShiftPayCodeName	Tracking Worked Shifts	Hidden money-based paycode that tracks the number of shifts worked by the employee.
!=empty	TrackingRequiredMealPayCodeName	Tracking Required Meals	Hidden money-based paycode that tracks the number of meal breaks assigned to the employee based on length of worked shift.
!=empty	TrackingRequiredRestPayCodeName	Tracking Required Rests	Hidden money-based paycode that tracks the number of rest breaks assigned to the employee based on length of worked shift.
!=empty	TrackingMissedMealPayCodeName	Tracking Missed Meals	Hidden money-based paycode that tracks the number of meal breaks missed by the employee in each shift.
!=empty	TrackingMissedRestPayCodeName	Tracking Missed Rests	Hidden money-based paycode that tracks the number of rest breaks missed by the employee in each shift.
!=empty	RestFirstConditionThresholdValue	03:00	The number of hours that the employee must work to qualify for the first rest break.
!=empty	RestSecondConditionThresholdValue	05:30	The number of hours that the employee must work to qualify for the second rest break.
!=empty	RestThirdConditionThresholdValue	10:30	The number of hours that the employee must work to qualify for the third rest break.
!=empty	RestFourthConditionThresholdValue	15:30	The threshold of hours that the employee must work to qualify for the fourth rest break.
!=empty	RestFifthConditionThresholdValue	20:30	The number of hours that the employee must work to qualify for the fifth rest break.
!=empty	MealFirstConditionThresholdValue	05:30	The number of hours that the employee must work to qualify for the first meal break.
!=empty	MealSecondConditionThresholdValue	10:30	The number of hours that the employee must work to qualify for the second meal break.
!=empty	MealThirdConditionThresholdValue	15:30	The number of hours that the employee must work to qualify for the third meal break.
!=empty	MealsFourthConditionThresholdValue	20:30	The number of hours that the employee must work to qualify for the fourth meal break.
!=empty	RestAssignedLessThanFirstMeal	1	Number of rest breaks assigned for the RestFirstConditionThresholdValue.
!=empty	RestAssignedFirstMeal	2	Number of rest breaks assigned for the RestSecondConditionThresholdValue.
!=empty	RestAssignedSecondMeal	3	Number of rest breaks assigned for the RestThirdConditionThresholdValue.
!=empty	RestAssignedThirdMeal	4	Number of rest breaks assigned for the RestFourthConditionThresholdValue.
!=empty	RestAssignedFourthMeal	5	Number of rest breaks assigned for the RestFifthConditionThresholdValue.

WARestAndMealCompliance_v2_2_QuestionConfiguration— Provides the questions that populate the forms for the process model. Depending on the locale policy, questions can be tailored to suit the preferred language of employees and reviewers. When multiple locale policies exist, insert data in sequential order with the least restrictive locale policy (!=empty) values at the bottom. Do not alter values in the InternalKey column. The gold template includes the default values shown below.

WA State Rest and Meal Compliance — Question Configuration InternalKey descriptions

InternalKey	Description
Meals	The process model utilizes the questions associated with this key. Question 1 asks the employee to confirm if they took their assigned meal break. Question 2 asks the employee the number of meal breaks missed.
Rests	The process model utilizes the questions associated with this key. Question 1 asks the employee to confirm whether they took their assigned rest breaks. Question 2 asks the employee the number of rest breaks missed.
MealsMTE	The process model utilizes the questions associated with this key when the employee completes attestation for a past shift or date. Question 1 asks the employee to confirm if they took their assigned meal break. Question 2 asks the employee the number of meal breaks missed.
RestsMTE	The process model utilizes the questions associated with this key when the employee completes attestation for a past shift or date. Question 1 asks the employee to confirm if they took their assigned rest break. Question 2 asks the employee the number of rest breaks missed.

WA State Rest and Meal Compliance — Question Configuration default pre-configured values

InternalKey	Locale Policy	Question 1	Question 2
Meals	!=empty	Did you take all your meal breaks?	How many breaks did you miss?
Rests	!=empty	Did you take all of your rest breaks?	How many breaks did you miss?
MealsMTE	!=empty	Did you take all of your meal breaks <shift> on <shift_date>?	How many breaks did you miss?
RestsMTE	!=empty	Did you take all of your rest breaks <shift> on <shift_date>?	How many breaks did you miss?

Note:

The <shift> and <shift_date> tags used in Question 1 display schedule information and the date for which attestation is requested for meal and rest breaks, respectively.
The !=empty rows must always be the last rows in the Question Configuration decision table; do not edit or remove these rows. These are the default messages and labels.
Names of the parameters in the InternalKey column of the Question Configuration decision table must be used as is. If any parameter value needs to be localized for a different Locale Policy, copy the InternalKey with the "not empty" Locale Policy, add a new row to the table with the appropriate Locale Policy, and then add the localized values in the Question 1 and Question 2 decision table columns.

WARestAndMealCompliance_v2_2_ZoneConfiguration— Provides the zone configuration that populates the forms for every process model. Do not alter values in the Zone InternalKey column. The gold template includes the default values shown below.

WA State Rest and Meal Compliance — Zone Configuration decision table structure

Column	Description
Workrule Internal Key	Identifies work rule names.
Zones Internal Key	Identifies zone names. Accepted values include `ZoneOne`, `ZoneTwo`, `ZoneThree`. Caution: Do not alter values in the ZonesInternalKey column.
Zone Start Time	Zone start time. Caution: Must adhere to the HH:mm format.
Zone End Time	Zone end time. Caution: Must adhere to the HH:mm format.
Missed Meal Premium Pay Code	Premium paycode that compensates for a missed meal break in the corresponding zone.
Missed Meal Premium Amount (HH:mm)	The amount of time that the Missed Meal Premium Pay Code adds to the timecard. Caution: Must adhere to the HH:mm format.
Missed Meal Penalty Pay Code	Penalty paycode that compensates for a missed meal break in the corresponding zone.
Missed Meal Penalty Amount (HH:mm)	The amount of time that the Missed Meal Penalty Pay Code adds to the timecard. Caution: Must adhere to the HH:mm format.
Missed Meal Credit Pay Code	Credit paycode that compensates for a missed meal break in the corresponding zone.
Missed Meal Credit Amount (HH:mm)	The amount of time that the Missed Meal Credit Pay Code adds to the timecard. Caution: Must adhere to the HH:mm format.
Missed Rest Premium Pay Code	Premium paycode that compensates for a missed rest break in the corresponding zone. Caution: Enter `None` if you choose to not configure this parameter.
Missed Rest Premium Amount (HH:mm)	The amount of time that the Missed Rest Premium Pay Code adds to the timecard. Caution: Must adhere to the HH:mm format.
Missed Rest Penalty Pay Code	Penalty paycode that compensates for a missed rest break in the corresponding zone. Caution: Enter `None` if you choose to not configure this parameter.
Missed Rest Penalty Amount (HH:mm)	The amount of time that the Missed Rest Penalty Pay Code adds to the timecard. Caution: Must adhere to the HH:mm format.
Missed Rest Credit Pay Code	Credit paycode that compensates for a missed rest break in the corresponding zone. Caution: Enter `None` if you choose to not configure this parameter.
Missed Rest Credit Amount (HH:mm)	The amount of time that the Missed Rest Credit Pay Code adds to the timecard. Caution: Must adhere to the HH:mm format.

WA State Rest and Meal Compliance — Zone Configuration default pre-configured values

Workrule Internal Key	Zones Internal Key	Zone Start Time	Zone End Time	Missed Meal Premium Pay Code	Missed Meal Premium Amount (HH:mm)	Missed Meal Penalty Pay Code	Missed Meal Penalty Amount (HH:mm)	Missed Meal Credit Pay Code	Missed Meal Credit Amount (HH:mm)	Missed Rest Premium Paycode	Missed Rest Premium Amount (HH:mm)	Missed Rest Penalty Paycode	Missed Rest Penalty Amount (HH:mm)	Missed Rest Credit Paycode	Missed Rest Credit Amount (HH:mm)
Washington Healthcare	ZoneOne	06:00	14:00	Missed Meal Premium 1	00:30	Missed Meal Penalty 1	00:30	Missed Meal Credit 1	00:30	Missed Rest Premium 1	00:15	Missed Rest Penalty 1	00:15	Missed Rest Credit 1	00:15
Washington Healthcare	ZoneTwo	14:00	22:00	Missed Meal Premium 2	00:30	Missed Meal Penalty 2	00:30	Missed Meal Credit 2	00:30	Missed Rest Premium 2	00:15	Missed Rest Penalty 2	00:15	Missed Rest Credit 2	00:15
Washington Healthcare	ZoneThree	22:00	06:00	Missed Meal Premium 3	00:30	Missed Meal Penalty 3	00:30	Missed Meal Credit 3	00:30	Missed Rest Premium 3	00:15	Missed Rest Penalty 3	00:15	Missed Rest Credit 3	00:15

WARestAndMealCompliance_v2_2_SecondMealWaiver — Provides the second meal waiver configuration. This table contains only those profiles for which the second meal waiver is applicable.

WA State Rest and Meal Compliance — Second Meal Waiver

Column	Description
Attestation Profile	Attestation profile name.
Second Meal Waiver	Indicates whether the second meal break waiver is allowed for an attestation profile. The value must be configured as Yes when the second meal break is waived for the corresponding profile.

WARestAndMealCompliance_v2_2_Locale— Provides the configuration of labels, messages, and error keys for application in the WA State Rest and Meal Breaks Compliance workflow. Configurations can be tailored to accommodate the preferred language of employees and reviewers. When multiple locale policies exist, insert data with the least restrictive values at the bottom.

WA State Rest and Meal Compliance — Locale decision table structure

Parameter name	Description
Locale Key	Key for which localization is defined.
Locale Policy	Locale Policy. You can use an asterisk ( `*`) as a wildcard, but put the less-restrictive locale policy names at the bottom of the table because the integration scans cross-reference tables from the top.
Message	Form label or message shown as the result of a processing error.
Description	(Optional) Customized description.

Note:

Localization of business process workflows remains optional, but is supported.
You can translate some or all messages by adding lines to the table in their preferred translation for specific locales. Decision tables are scanned from top to bottom; therefore, place messages for the most commonly used Locale Policy at the top of the decision table and less-restrictive locale policies at the bottom.
Text within tags ("<>") must not be changed.
The decision table holds all messages represented with standard English labels; these apply to all locales when the Locale Policy is set to !=empty.
Names of the parameters in the decision table column Parameter Name must be used as is. If any parameter value needs to be localized for a different Locale Policy, copy the Parameter Name with the !=empty Locale Policy, add a new row to the decision table with the appropriate Locale Policy, and then add the localized value in the Message column.
Decision tables support operators like "Contains," "Starts with," "Ends with," and "Is Not Empty." You can achieve your preferred results by following these examples:
- To match any non-empty or any string (like *), use the "Is Not Empty" operator.
- To match a string starting with "ABC" (like "ABC*"), use the "Starts with" operator and set the value to "ABC".
- To match a string containing "English" as substring, use the "Contains" operator with the value "English".
The last row in the decision table must remain empty ("!=empty".)

WA State Rest and Meal Compliance — Locale sample content

Key	Locale	Message	Description
Error_MissingParameterValue	!= empty	Value not defined for parameter <PARAMETERNAME> in decision table <DTNAME>.	Error message that displays when a parameter in a decision table is not defined. Use tag <NL> for a new line.
Error_InvalidTimeStampValue	!= empty	Invalid time format for parameter <PARAMETERNAME> in decision table <DTNAME>. Please use time format HH:mm.	Error message that displays when a time parameter is not formatted correctly. Time values must adhere to the HH:mm format. Use tag <NL> for a new line.
Label_ SubmitButton	!= empty	Submit	Submit button label.
Label_ NextButton	!= empty	Next	Next button label.
Label_ CancelButton	!= empty	Cancel	Cancel button label.
Label_ TerminateButton	!= empty	Terminate	Terminate button label.
Label_Yes	!=empty	Yes	Yes button label.
Label_No	!= empty	No	No button label.
Label_MealFormHeader	!= empty	Meal Break Attestation	Meal break attestation form header label.
Label_RestFormHeader	!= empty	Rest Break Attestation	Rest break attestation form header label.
Label_Unscheduled	!= empty	Unscheduled shift	Label that displays when a schedule does not exist for the employee.
Label_ShiftError	!= empty	Attestation is not required. You were not scheduled on <shift date>.
Label_noAttestationRequired	!= empty	Attestation is not required. You were not scheduled on <shift date>.	Label that displays when an employee attempts attestation on a non-scheduled day.
Label_Goback	!= empty	Go Back	Go Back checkbox label.
Label_GoBackButton	!= empty	Go Back	Go Back button label.
Label_CarefulMessage	!= empty	Error - Attestation is not allowed in signed-off pay periods.	Label that displays a warning message when an employee attempts attestation in a signed-off pay period.
Label_ContinueButton	!= empty	Continue	Continue button label.
Label_noPunchoutFounds	!= empty	Please update your punch before proceeding to attestation.	Label that displays when an employee attempts attestation before punching out.
Label_SubmitButton	!= empty	Submit	Submit button label.
Label_UserBreak1TimeMeal	!= empty	When were you supposed to take your missed meal break?	First meal break start time label.
Label_UserBreak2TimeMeal	!= empty	When were you supposed to take your second missed meal break?	Second meal break start time label.
Label_UserBreak3TimeMeal	!= empty	When were you supposed to take your third missed meal break?	Third meal break start time label.
Label_UserBreak4TimeMeal	!= empty	When were you supposed to take your fourth missed meal break?	Fourth meal break start time label.
Label_UserBreak1TimeRest	!= empty	When were you supposed to take your missed rest break?	First rest break start time label.
Label_UserBreak2TimeRest	!= empty	When were you supposed to take your second missed rest break?	Second rest break start time label.
Label_UserBreak3TimeRest	!= empty	When were you supposed to take your third missed rest break?	Third rest break start time label.
Label_UserBreak4TimeRest	!= empty	When were you supposed to take your fourth missed rest break?	Fourth rest break start time label.
Label_UserBreak5TimeRest	!= empty	When were you supposed to take your fifth missed rest break?	Fifth rest break start time label.
LabelBreakTimeOutOfRange	!= empty	Error - The time you entered for your missed break is outside your worked hours. Please enter a valid time.	Label that displays when an employee enters a break start time that falls outside of the scheduled shift.
Label_SignoffErrorMessage	!= empty	Error - Attestation is not allowed in signed-off pay periods.	Label that displays an error message when an employee attempts attestation in a signed-off pay period that is not enabled for editing.

Deploy the updated WA State Rest and Meal Breaks Compliance business process model:

Process models must be redeployed every time changes are made to an existing model. Re-deployment is not required for decision table changes.

Follow these steps to deploy the updated process models. For detailed information, see the online help topic Deploy Business Process Models .
1. Go to Main Menu > Administration > Application Setup > Business Process Setup > Process Models.
2. Select the process model and click tap Edit
3. On the Business Process page, configure the required parameters and deployment dates.
  - (Optional) In Description, enter the process model name.
  - In Display Name, enter the process model name.
  - In Start Effective, select the effective start date.
  - In End Effective, select Forever to make the Business Process available indefinitely.
  - In Status, select Active.
  - In Action List, select Hide.
  - In Tile List, select Show.
  - In GoTo List, select Hide.
  - From Template Categories, select Attestation.
4. Click Tap Save and then Return to deploy.
Assign the deployed process, WAStateRestAndMealBreaksCompliance_v2.2, to the employee's process profile.

APIs

API details

API name	Type	Resource path	Description
Update Timecard as Manager	POST	/v1/timekeeping/timecard	Updates a Timecard for an employee as a manager.
Retrieve User Preferences for Current User	GET	v1/commons/user_preferences/locale_policy	Returns user preferences for the current user or tenant.
Retrieve Timecard as Manager	GET	/v1/timekeeping/timecard	Returns a manager Timecard. Required parameters include employee ID or person number and a date range or symbolic period ID.
Assign Attestation Profiles	GET	/v1/commons/persons/attestation_profile_assignments?person_number=${personNumber}	Returns a list of assigned attestation profiles.
Person Extension	POST	{{vanity_url}}/v1/commons/persons/extensions/multi_read	Retrieves person details, such as work rule, pay rule, and locale.

Gold templates

SDM zip files that contain all required gold template configuration parameters are available for download with this extension.

If you choose to import the configuration templates, you must adhere to the sequence order noted in the table below; this ensures that the building block parameter order is respected.

Reach out to your Professional Services Consultant for assistance, if needed.

SDM zip files — Configuration gold templates — WA State Rest and Meal Breaks Compliance

SDM zip files — WA State Rest and Meal Breaks Compliance

Sequence	SDM file	Additional notes
01	SDM WA State Rest and Meals-01-Tracking Pay Codes.zip
02	SDM WA State Rest and Meals-02-Credit and Compensation Pay Codes.zip
03	SDM WA State Rest and Meals-03-Attestation Process Models.zip
04	SDM WA State Rest and Meals 04-Attestation Workflow.zip
05	SDM WA State Rest and Meals -05- Attestation Assignment.zip
06	SDM WA State Rest and Meals-06-Mapping Category Definitions.zip	Only import when the KPI Dataview is used.
07	SDM WA State Rest and Meals-07-Metric Definitions.zip
08	SDM WA State Rest and Meals-08-KPI Definition.zip
09	SDM WA State Rest and Meals-09-Compliance Dataview Basic.zip	Use either of the two Dataviews provided. When using the KPI version, Location Types Facility, Service Line and Department must be present in business structure types.
09	SDM WA State Rest and Meals-10-Compliance Dataview with KPI and Charts.zip

Version history - WA State

Version history

Version	Description
2.0	Initial release. Process models include: WA State First Meal Break_v2 WA State Second Meal Break_v2 WA State Third Meal Break - Second Meal Waived_v2 WA State Third Meal Break_v2 WA State Fourth Meal Break - Second Meal Waived_v2 WA State Fourth Meal Break_v2 WA State Rest Breaks_v2
2.1	The Washington State Rest and Meal Breaks Compliance extension now: Combines all previous process models into a single business process. Supports shift premiums for missed meal breaks. Allows employees to launch the process by way of My Business Processes tile to retroactively attest to missed rest and meal breaks. Honors Cost Center and Labor Category transfers by assigning credit, premium and penalty paycodes for missed breaks to the appropriate transfer string. Prompts the employee for the start time of the missed break, which allows the workflow to detect the appropriate premium zone.
2.2	The Washington (WA) State Rest and Meal Compliance extension generated script errors when processing night shifts and shifts that included meal breaks.

Version

Description

2.0

Initial release.

Process models include:

WA State First Meal Break_v2
WA State Second Meal Break_v2
WA State Third Meal Break - Second Meal Waived_v2
WA State Third Meal Break_v2
WA State Fourth Meal Break - Second Meal Waived_v2
WA State Fourth Meal Break_v2
WA State Rest Breaks_v2

2.1

The Washington State Rest and Meal Breaks Compliance extension now:

Combines all previous process models into a single business process.
Supports shift premiums for missed meal breaks.
Allows employees to launch the process by way of My Business Processes tile to retroactively attest to missed rest and meal breaks.
Honors Cost Center and Labor Category transfers by assigning credit, premium and penalty paycodes for missed breaks to the appropriate transfer string.
Prompts the employee for the start time of the missed break, which allows the workflow to detect the appropriate premium zone.

2.2

The Washington (WA) State Rest and Meal Compliance extension generated script errors when processing night shifts and shifts that included meal breaks.