Configurable Pay
The Configurable Pay (PAYCONF) page allows you to define automated pay rules to be applied to certain sets of employees in specific scenarios. Rules can be defined for various evaluation periods within a given pay period, with an employee meeting a rule condition resulting in the defined payout being generated.
When the Process Configurable Pay batch process is executed, eligible employees are evaluated against the rules that are active for the given effective date, and pending payments are generated as applicable. Additional information on this process can be found in the CGI Advantage HRM Paycycle Proc Run Sheets Guide.
Field InformationField Information
The Configurable Pay page contains the following fields:
Field Name |
Field Description |
Configurable Pay ID |
A unique identifier for the rule being created. |
Configurable Pay |
Description A description for the rule. |
Home Department, Home Unit, Pay Policy, Union Local |
These fields are used to define organizational values that should be considered when selecting eligible employees for automatic step increase processing. Employees that have a Home Department, Home Unit, Pay Policy, or Union Local that matches the value entered in the associated pick list will be selected for processing. These pick lists support wildcard (“*****”) entries to indicate that the organizational value should not be included in the selection criteria. When a value is entered in the Home Unit pick list, a non-wildcard value is required in the Home Department pick list. |
Generated Pay Event |
The pay event to be used in the generated pending payment if an employee meets the rule conditions. The event entered must have Event Type ID= Pay Type on Pay and Leave Event (EVNT). |
Evaluation Period |
The time period over which a rule will be evaluated for an employee. If multiple instances of the selected evaluation period fall within the current pay period, then the rule will be evaluated for each complete instance of the evaluation period (example., daily will evaluate each day in the pay period). |
Supplemental Pay Cycle |
Identifies if payments generated by the rule should be flagged for a supplemental run. |
Hold Pending Payment |
Identifies if payments generated by the rule should be placed in a hold status. |
State Tax Withholding Option |
This field has two values: Primary State (P) and Withhold based on entered time (E). The State Tax Withholding Option can only be set to E if the Evaluation Period is Daily or Daily Specified. The default value is set to Primary State (P). When the MULTI_STATE_TAX Application Parameter is enabled, this field determines if the generated payment should be assigned to the employee’s primary state code or assigned to the state code associated with the pending payments in the Evaluation Period. |
Multi-Day Setup |
Works in conjunction with the selected Evaluation Period to specify the specific days of the week that should be evaluated. At least one entry is required when Evaluation Period = Daily Specified or Multi-Day. |
Pay Rule Formula |
This formula definition determines if the employee meets the pay rule. This formula must return a true/false result. The formula must be built using the standard JEXL script and can utilize the methods defined on Configurable Pay Method and the lists defined on User List for this process. |
Pay Output Formula |
This formula definition identifies the amount (hours, dollars, etc.) of the Generated Pay Event that need to be generated. This formula will only be considered if the Pay Rule Formula returns a ‘true’ for the employee. The formula must be built using the standard JEXL script and can utilize the methods defined on Configurable Pay Method and the lists defined on User List for this process. |
Method Grid |
This grid displays the details of all methods defined on Configurable Pay Method that can be utilized in the Pay Rule and Pay Output Formulas. |
Configuration ExamplesConfiguration Examples
The following tables provides guidance on how to configure various types of pay rules. Note that exact configuration may vary depending on site specific information. A value of LIST in the formulas denotes that the acceptable values would be configured in a list with a unique List ID on ULIST to be called in the method.
Scenario 1: Generate weekly overtime premium for hours over 40 in a week that were charged to specific events (in list defined on ULIST). |
|
Eval Period |
Weekly |
Multi-Day Setup |
N/A |
Pay Rule Formula |
this.hasEventIn("LIST"); if(this.getHours() > 40.0B){return true;} |
Pay Output Formula |
this.hasEventIn("LIST"); if(this.getHours() > 40.0B){return true;} |
Scenario 2: Generate daily overtime premium – one rate for hours over 8 and another rate for hours over 10 reported for a given day. [Note – this is configured using 2 rules for the 2 different premium payments.] |
|
PAYCONF Entry #1 |
|
Eval Period |
Daily |
Multi-Day Setup |
N/A |
Pay Rule Formula |
this.hasEventIn("LIST"); if(this.getHours() > 8.0B){return true;} else{return false;} |
Pay Output Formula |
this.hasEventIn("LIST"); if(this.getHours() > 10.0B){return 2.0B;} else{return this.getHours() - 8.0B;} |
PAYCONF Entry #2 |
|
Eval Period |
Daily |
Multi-Day Setup |
N/A |
Pay Rule Formula |
this.hasEventIn("LIST"); if(this.getHours() > 10.0B){return true;} else{return false;} |
Pay Output Formula |
this.hasEventIn("LIST"); return this.getHours() - 10.0B; |
Scenario 3: Generate a weekend differential payment for all hours reported on Saturdays or Sundays. [Note that currently, multi-day rules can only be executed for weekly/biweekly pay period employees.] |
|
Eval Period |
Multi-Day |
Multi-Day Setup |
Check: Saturday, Sunday |
Pay Rule Formula |
this.hasEventIn("LIST"); if(this.getHours() > 0.0B){return true;} else{return false;};} |
Pay Output Formula |
this.hasEventIn("LIST"); return this.getHours(); |
Scenario 4: Generate premium or shift differential for unscheduled hours worked by an employee on a weekend. |
|
Eval Period |
Daily Specified |
Multi-Day Setup |
Check: Saturday, Sunday |
Pay Rule Formula |
this.hasEventIn("LIST"); if(this.getScheduledWorkHours() == 0.0B && this.getHours() > 0.0B) { return true; } else { return false; } |
Pay Output Formula |
this.hasEventIn("LIST"); return this.getHours(); |
Scenario 5: Generate a location premium for any hours reported with a work location in the designated list. |
|
Eval Period |
Pay Period |
Multi-Day Setup |
N/A |
Pay Rule Formula |
this.hasLocationIn("LIST"); if(this.getHours() > 0.0B) {return true;} else {return false;} |
Pay Output Formula |
this.hasLocationIn("LIST"); return this.getHours() - 8.0B; |