This chapter provides an overview of earnings and discusses how to:
Modify and update delivered earnings.
Create new earnings.
This section discusses:
Delivered earnings.
Delivered supporting elements.
User fields.
Earnings assignments.
Required supporting elements.
Process lists and sections.
How to viewing delivered elements.
PeopleSoft Global Payroll for United States delivers a number of earnings for the U.S. that demonstrate the flexibility of Global Payroll rules to meet common processing requirements such as the calculation of wages and overtime.
In this table, the first column combines the name and description of the delivered earnings. The other columns indicate the calculation rule components, such as Unit, Rate, Percent, and Amount, and the pre-process and post-process formulas for each earning.
Name/Descr. |
Unit |
Rate |
% |
Amount |
Pre- and Post- Process Formula |
REGULAR Regular Hourly |
Payee-level |
K1GCRH (rate code) |
NA |
NA |
NA |
WAGES Exception Hourly Wages |
ERN FM SALARY HOURS (formula) |
K1GCRH (rate code) |
NA |
NA |
Post-ERN FM RED HRS/AMT |
SALARY |
NA |
NA |
NA |
K1GCRS (rate code) |
Post-ERN FM RED SALARY |
OVT 1.5 Overtime Pay |
Payee-level |
ERN FM OVT RATE (formula – monetary and decimal) |
150% |
NA |
NA |
OVT 2.0 (D Double - Time Pay |
Payee-level |
ERN FM OVT RATE (formula – monetary and decimal) |
200% |
NA |
NA |
PREMIUM Premium Over Time |
Payee-level |
ERN FM OVT RATE (formula – monetary and decimal) |
50% |
NA |
NA |
BONUS |
NA |
NA |
NA |
Payee-level |
NA |
COMPANY CAR Personal Use of Company Car |
NA |
NA |
NA |
Payee-level |
NA |
SHIFT - R Shift Differential - Hourly |
SHIFT DIFF UNIT (accumulator) |
ERN BR SHIFT DIFF (bracket) |
NA |
NA |
NA |
SHIFT PCT Shift Differential - Percentage |
SHIFT DIFF UNIT (accumulator) |
HOURLY RT (system element - numeric) |
ERN VR SHIFT D PCT (variable - numeric) |
NA |
Pre-ERN FM SHIFT D PCT |
Note. These elements are defined as PS Delivered/Not Maintained. This means that you can use them as delivered, modify them, or replace them with new elements.
Note. PeopleSoft Global Payroll for United States also delivers absence-related earnings. These are discussed in a separate chapter in this PeopleBook.
See Setting Up Absence Elements.
PeopleSoft Global Payroll for United States delivers two types of earnings for calculating regular pay:
REGULAR
Use this earning to calculate pay for hourly payees who require positive input.
WAGES
Use this earning to calculate pay for hourly payees who need to report only exceptions to their standard hours.
The calculation rule for both REGULAR and WAGES is Unit × Rate.
Both earnings use the rate code K1GCRH for the Rate component. This rate code is used to calculate pay for all hourly payees.
The Unit component differs for these two earnings:
The REGULAR earning assumes that the Unit (time paid) is recorded at the payee level through positive input.
The WAGES earning assumes that payees are paid a standard set of hours for each pay period, and that only exceptions need to be reported through positive input. The Unit component for this earning includes a formula—ERN FM SALARY HOURS—that calculates the standard hours.
This formula:
Multiplies the STD HRS system element by the STD HRS FREQ FACTOR system element to calculate the ANNUAL HOURS (stored as a variable).
Divides the ANNUAL HOURS variable by the PRD FREQ FACTOR (pay period frequency factor) system element to calculate the pay period standard hours.
The post-process formula for the WAGES earning, ERN FM RED HRS/AMT, reduces the pay period standard hours by any absence or holiday hours. This formula requires the use of the REDUCE SAL H accumulator to sum up the hours for all earnings, such as vacation, that should reduce the standard hours.
In addition, this formula ensures that the WAGES earning is not reduced by absences to a negative amount.
Use the SALARY earning to pay salaried employees.
The calculation rule for SALARY is Amount, with the amount defined as the rate code K1GCRH.
The post-process formula for the SALARY earning, ERN FM RED SALARY, performs two functions:
It calculates standard hours and reduces these hours by the number of absence hours.
It ensures that the salary amount is not reduced by absences to a negative amount.
PeopleSoft Global Payroll for United States delivers two overtime earnings: OVT 1.5 for overtime calculated at 1.5 times the regular pay rate, and OVT 2.0 for overtime calculated at twice the regular pay rate.
The calculation rule for both overtime earnings is Unit × Rate × Percent, where Unit is the number of overtime hours that a payee works, Rate is the formula ERN FM OVT RATE, and Percent is either 150 or 200. The units are entered at the payee level.
Note. The delivered overtime earnings include a shift differential. This differential is included in the calculation of the earnings only if the employee is associated with a shift group and a shift ID.
Premium pay refers to the excess over the regular rate of pay that is paid for extended working hours, overtime, or work during holidays. PeopleSoft Global Payroll for United States delivers the PREMIUM earning to calculate premium pay.
The calculation rule for premium pay is Unit × Rate × Percent, where Unit is the number of extended hours worked, Rate is the formula ERN FM OVT RATE, and Percent is 50. The units are entered at the payee level.
Note. Premium pay includes a shift differential. This differential is included in the calculation of the earnings only if the employee is associated with a shift group and a shift ID.
PeopleSoft Global Payroll for United States delivers the BONUS earning to calculate bonus pay. The calculation rule for bonus pay is Amount, where a payee's bonus is entered as a numeric amount at the payee level.
The BONUS earning uses the Supplemental tax method.
PeopleSoft Global Payroll for United States delivers the COMPANY CAR earning to calculate the personal use of a company car. The calculation rule for COMPANY CAR is Amount; the amount is entered at the payee level. The COMPANY CAR earning does not add to gross pay, but to taxable gross.
Shift Differential
PeopleSoft Global Payroll for United States delivers two earnings to calculate shift differentials: SHIFT - R and SHIFT PCT.
The calculation rule for SHIFT R is Unit × Rate, where Unit is the accumulator SHIFT DIFF UNIT, and Rate is the bracket ERN BR SHIFT DIFF.
The calculation rule for SHIFT PCT is Unit × Rate × Percent, where Unit is the Accumulator SHIFT DIFF UNIT, Rate is the system element HOURLY RT, and Percent is the variable ERN VR SHIFT D PCT.
The system processes these earnings only if the accumulator SHIFT DIFF UNIT holds units (hours) processed for the eligible shift earnings. Only two of the delivered earnings—REGULAR and WAGES—are defined as eligible. That is, the units of these earnings are the only members of this accumulator. If no units come from these earnings, then SHIFT - R and SHIFT PCT are not processed. In addition, payees must be assigned to shift groups and shift IDs before the system can process SHIFT - R or SHIFT PCT.
Note. The earnings SHIFT - R and SHIFT PCT use the generation control element ERN GC SHIFT EXC to control processing. This formula looks at the accumulator SHIFT DIFF UNIT and the values of the shift group and shift ID. If the value of SHIFT DIFF UNIT is greater than zero and the payee is in a shift group and has a shift ID, the system processes the earnings.
See Assigning Earnings.
This table lists the key supporting elements used to define the delivered earnings:
Element Type |
Element Name |
Used By |
Where Used |
Variable |
TAX VR METHOD |
This variable is a user field for all taxable earnings. It stores the tax method to use when an earning is calculated. |
Supporting Element Override page. Values include:
All delivered earnings except BONUS use the Annualized tax method (A). BONUS uses the Supplemental tax method (S). |
Variable |
TAX VR RPT TYPE |
This variable is a user field for all taxable earnings. |
Determines the year-end form—W2, W2PR, W2AS, and so on—on which an earning element is reported. |
Variable |
TAX VR STATE |
This variable is a user field for all taxable earnings. |
Determines the state or territory in which each earning is taxed. |
Variable |
ERN VR SHIFT GRP |
ERN BR SHIFT DIFF ERN FM OVT RATE This variable is a user field for all earnings except SALARY, BONUS, COMPANY CAR, and HOLIDAY. |
ERN VR SHIFT GRP is a search key in the bracket ERN BR SHIFT DIFF. Based on this key, the bracket returns the correct shift differential and percentage to the calculation rule of the earnings SHIFT - R and SHIFT PCT. ERN VR SHIFT GRP is used in the formula ERN FM OVT RATE to define the rate component for the earnings OVT 1.5, OVT 2.0, and PREMIUM. |
Variable |
ERN VR SHIFT ID |
ERN BR SHIFT DIFF This variable is a user field for all earnings except SALARY, BONUS, COMPANY CAR, and HOLIDAY. |
ERN VR SHIFT ID is a search key in the bracket ERN BR SHIFT DIFF. Based on this key, the bracket returns the correct shift differential and percentage to the calculation rule of the earnings SHIFT - R and SHIFT PCT. |
Variable |
ERN VR SHIFT D PCT |
ERN BR SHIFT DIFF ERN FM OVT RATE |
Bracket ERN BR SHIFT DIFF provides the value of the variable ERN VR SHIFT D PCT (this variable is the percent component in the calculation rule of the earning SHIFT PCT). Formula ERN FM OVT RATE uses the value of variable ERN VR SHIFT D PCT to calculate the Rate component for earnings OVT 1.5, OVT 2.0, and PREMIUM. |
Formula |
ERN FM RED SALARY |
SALARY |
Post process formula. Reduces SALARY earning by Absence and Holiday amounts. |
Formula |
ERN FM RED HRS/AMT |
WAGES |
Post-process formula. Reduces WAGE hours by Absence and Holiday hours. |
Formula |
ERN FM SALARY HOUR |
WAGES |
Unit component. Calculates standard hours. |
Formula |
ERN FM OVT RATE |
OVT 1.5 OVT 2.0 PREMIUM |
Formula calculates Rate components for the earnings OVT 1.5, OVT 2.0, and PREMIUM. |
Formula |
GEN FM SEG COUNT |
WAGES |
Counts the number of Units (hours) per segment |
Formula |
ERN FM SHIFT EXEC |
ERN GC SHIFT EXC (generation Control) SHIFT - R SHIFT PCT |
Controls whether to calculate shift pay. |
Formula |
ERN FM SHIFT D PCT |
SHIFT PCT |
Used to retrieve the shift differential percentage from the bracket table. |
Formula |
GP CHECK 1ST SEG |
COMPANY CAR GP APPLY 1ST SEG (generation control) |
Used by COMPANY CAR to restrict payment to the first segment of a period. |
Bracket |
ERN BR SHIFT DIFF |
SHIFT - R SHIFT PCT ERN FM OVT RATE |
Bracket provides Rate component to earning SHIFT - R. Bracket provides Percent component to earning SHIFT PCT by populating the value of the variable ERN VR SHIFT D PCT (this variable holds percent values returned by the bracket). Bracket provides shift differential to formula ERN FM OVT RATE, which calculates the Rate component for earnings OVT 1.5, OVT 2.0, and PREMIUM. |
All of the delivered earnings are associated with the following user fields:
TAX VR RPT TYPE
This user field determines the year-end form—W2, W2PR, W2AS, and so on—to use to report an earning element.
Note. You define a default report type for a payee on the Payee Tax Profile page. You can change the default by entering a supporting element override for the variable TAX VR RPT TYPE.
TAX VR STATE
This user field determines the state or territory in which each earning is taxed.
Note. The default state or territory for a payee is the one for which the UI Jurisdiction check box is selected on the State Tax Data page. You can change the default by entering a supporting element override for the variable TAX VR STATE.
TAX VR METHOD
This user field stores the tax method to use when an earning is calculated.
Note. The default tax method is defined at the element level on the Supporting Element Overrides page of the Earnings component (GP_EARNING). You can override the default at the payee level by entering a supporting element override for the variable TAX VR METHOD.
Two additional user fields are associated with all earnings that process shift differentials:
ERN VR SHIFT GRP
This user field is used to associate an earning with a shift group.
ERN VR SHIFT ID
This user field is used to associate an earning with a shift ID.
Note. To assign a default shift group and shift ID to a payee, select Global Payroll & Absence Mgmt, Payee Data, Create Overrides, Supporting Elements and specify the values of the variables ERN VR SHIFT GRP and ERN VR SHIFT ID (these variables store the shift group and shift ID respectively). You can override the defaults on the One Time (Positive Input) page.
See Also
Managing Multiple Resolutions of an Earning or Deduction
Earnings with a component of their calculation rule set to Payee Level must be assigned to individual payees before they can be processed, and require positive input for either the Unit, Rate, Base, or Percent component.
The following delivered earnings for the U.S. fall into this category:
Earning |
Description |
BONUS and COMPANY CAR |
The earnings BONUS and COMPANY CAR are defined with a calculation rule of Amount, with the Amount Type field set to Payee Level. This means that the earnings are resolved only when:
|
REGULAR, OVT 1.5, OVT 2.0, and PREMIUM |
The earnings REGULAR, OVT 1.5, OVT 2.0, and PREMIUM are defined with a calculation rule of Unit × Rate or Unit × Rate × Amount, with the Unit Type field set to Payee Level. This means that the earnings are resolved only when you define the unit at the payee level through positive input, or specify a flat amount (overriding the calculation rule). |
See Also
Many earnings require that you define the value of supporting elements to be processed correctly. This table lists the required supporting elements for the earnings delivered by PeopleSoft Global Payroll for United States, and explains how to define the values of these elements.
Earning |
Description |
REGULAR, OVT 1.5, OVT 2.0, and PREMIUM |
The earnings OVT 1.5, OVT 2.0, and PREMIUM calculate shift differentials by using the formula ERN FM VT RATE to retrieve the shift rate or percentage from the bracket ERN BR SHIFT DIFF. Note. This bracket is keyed by shift group and shift ID and returns a rate or a percentage based on the value of the supporting elements ERN VR SHIFT GRP and ERN VR SHIFT ID. To process shift pay, you must assign payees to shift groups and shift IDs. To do this:
Note. You can also define default shift groups and shift IDs for payees by specifying the values of the variables ERN VR SHIFT GRP (shift group) and ERN VR SHIFT ID (shift ID) on the Supporting Elements page. You can then override these values as needed for specific pay periods using positive input. |
REGULAR and WAGES |
The system stores the hours of REGULAR and WAGES (by shift group and shift ID) in the accumulator SHIFT DIFF UNIT. This accumulator serves as the Units component in the calculation rule of the earnings SHIFT R and SHIFT PCT. For payees to receive shift pay based on the hours (units) of REGULAR and WAGES, you must define the values of the supporting elements ERN VR SHIFT GRP (shift group) and ERN VR SHIFT ID (shift ID). Note. The system processes SHIFT R and SHIFT PCT automatically if the value of SHIFT DIFF UNIT is greater than zero and payees are assigned to shift groups and shift IDs. To do this, Select Global Payroll & Absence Mgmt, Payee Data, Create Overrides, Supporting Elements, and specify the default values of ERN VR SHIFT GRP and ERN VR SHIFT ID for each payee on the Values tab. To override the default shift group and shift ID for a payee in a specific pay period, access the Positive Input - Details page and specify the shift group and shift ID for the payee and the earnings for which you are calculating the shift differential (WAGES or REGULAR). You can access the Positive Input - Details page in two ways:
Note. You can enter overrides for a full period or a partial period. To enter partial period overrides, create multiple rows of data for WAGES or REGULAR with the number of hours associated with each shift, and then specify the shift group and shift ID for each row. |
All Delivered Taxable Earnings |
All of the delivered taxable earnings required the definition of the supporting elements TAX VR RPT TYPE (report type), TAX VR STATE (U.S. state/territory), and TAX VR METHOD (tax method) to ensure correct tax processing. You define default values for these supporting elements at the payee or element level, and then override these values as needed:
|
See Also
All delivered earnings are members of the GENERAL EARNINGS section.
The GENERAL EARNINGS section is included in the USA STD PAYROLL process list.
The PeopleSoft system delivers a query that you can run to view the names of all delivered elements designed for the U.S. Instructions for running the query are provided in the PeopleSoft Global Payroll 9.1 PeopleBook.
See Also
Understanding How to View Delivered Elements
This section provides an overview of earnings schedules and discusses how to modify delivered earnings.
Global Payroll for U.S. delivers several generation control elements that you can use to control the processing of earnings:
Generation Control Element |
Frequency Factor |
Description |
GEN GC WEEK 1AND2 |
FRST ONLY (12) |
Schedules the deduction during the first pay period in the month (for biweekly and semimonthly pay periods). |
GEN GC WEEK 3AND4 |
SCND ONLY (12) |
Schedules the deduction during the second pay period in the month (for biweekly and semimonthly pay periods). |
GEN GC WEEK 1AND2 |
FRST SCND (24) |
Schedules the deduction during the first and second pay periods in the month (for weekly pay periods). |
GEN GC WEEK 3AND4 |
THRD FRTH (24) |
Schedules the deduction during the third and fourth pay periods in the month (for weekly pay periods). |
Note. These elements are discussed in detail in the chapter "Setting Up General Deductions"
PeopleSoft Global Payroll for U.S. delivers two additional generation control elements that you can use to manage the processing of earnings:
Generation Control Element |
Description |
ERN GC SHIFT EXC |
This generation control element uses a formula to determine whether shift pay should be processed based on the value of the accumulator SHIFT DIFF UNIT. If SHIFT DIFF UNIT is greater than zero, the earning is processed. Note. Use the delivered deductions SHIFT - R and SHIFT PCT as models for using this generation control element to limit processing. See Delivered Earnings. |
GP APPLY 1ST SEG |
Use this generation control element if you want an earning to be applied to the first segment in a period. |
See Also
PeopleSoft Global Payroll for United States delivers earnings elements based on practices that are common to many businesses in the U.S. Although most of the delivered earnings are created according to common industry standards or based on statutory requirements, a company's specific business practices may require modifications to the delivered elements. This section provides examples of common earnings rules modifications.
Modifying SALARY
If you create new absence-related earnings and want the new earning to reduce the SALARY earning, you must add the automatically generated units accumulator from the new earning to the REDUCE SAL H accumulator. You can add the units accumulator for the new absence-related earnings to the REDUCE SAL H accumulator on the Accumulators - Members page.
Modifying BONUS
The delivered BONUS earning is designed to be taxed by means of the supplemental tax method, and is multiplied by the state supplemental rate. Business practices may require that you calculate bonuses as separate payments or process them with regular wages. If you want to use a different supplemental rate for the BONUS earning, you must enter this change on the State Tax Rates USA page.
See Setting Up Taxes.
Modifying Shift SHIFT - R and SHIFT PCT
When modifying the delivered shift differential rules, note that:
The Unit component in the calculation rule of the shift differential earnings SHIFT - R and SHIFT PCT is defined as the accumulator SHIFT DIFF UNIT. As delivered, the members of this accumulator are the units calculated for the earnings WAGES and REGULAR. If you want to include units (hours) from other earnings in the calculation of differential pay, you must add the units from these earnings to SHIFT DIFF UNIT using the accumulator definition component.
Any additional earnings whose units you add to the accumulator SHIFT DIFF UNIT should be defined with ERN VR SHIFT GRP (shift group) and ERN VR SHIFT ID (shift ID) as user fields. Use the delivered earnings WAGES and REGULAR as models.
The shift differential earnings use the bracket ERN BR SHIFT DIFF to return the correct differential and percentage. The differential and percentage values in the bracket are defined as sample data; you must modify this data to conform to the rules that apply within your organization. In addition, you may want to add additional search keys to the bracket (the delivered bracket uses shift group and shift ID as search keys).
This section discusses:
The accumulator structure of earnings.
How to create new earnings for shift differentials.
How to configure earnings/deduction assignments and override components.
User fields.
If you create new earnings, make sure that they conform to the accumulator structure of the delivered earnings. This is to ensure that the new elements are processed correctly and are included in the appropriate gross-to-net calculations.
For example, when you create a new earning, you must add the earning to the TOTAL EARNINGS N accumulator so that is can be processed correctly.
Note. For each taxable earning that you create, you must also define the tax method. To do this, associate the variable TAX VR METHOD with the new earning on the Supporting Element Overrides page, and assign it a value of A (annual), S (supplemental), or C (cumulative).
See Defining Earning and Deduction Elements.
Accumulator Structure of Earnings
This table describes the accumulator structure of earnings:
Accumulator Name |
Description |
Contributing Elements |
FWT GRS N |
Federal withholding tax gross |
All earnings contribute to this accumulator. |
OAS EE GRS N |
Social Security old age, survivors, and disability insurance (OASDI) employee gross |
All earnings contribute to this accumulator. |
OAS ER GRS N |
Social Security OASDI employer gross |
All earnings contribute to this accumulator. |
MED EE GRS N |
Social Security Medicare employee gross |
All earnings contribute to this accumulator. |
MED ER GRS N |
Social Security Medicare employer gross |
All earnings contribute to this accumulator. |
FUT GRS N |
Federal unemployment tax gross |
All earnings contribute to this accumulator. |
EIC GRS N |
Earned income credit gross Note. The U.S. Federal Government has discontinued Advance EIC payments and W-5 processing effective January 1, 2011. PeopleSoft pages, fields, and processes remain available for use in supporting Advance EIC through tax year 2010 only. |
All earnings contribute to this accumulator. |
TOTAL EARNINGS N |
Total earnings |
All earnings contribute to this accumulator. |
401K GROSS N |
401K gross |
All 401K eligible earnings contribute to this accumulator. |
SWT GRS N |
State withholding tax gross |
All earnings except BONUS contribute to this accumulator. |
SWT GRS SPC N |
State withholding tax gross special |
The BONUS earning contributes to this accumulator. |
SHIFT DIFF UNIT |
Shift differential units |
REGULAR_UNIT and WAGES_UNIT contribute to this accumulator. |
SALARY YTDA |
Salary |
The SALARY earning contributes to this accumulator. |
SALARY HRS SEG SALARY HRS YTD |
Salary hours |
These accumulators store standard hours for a salaried payee. |
When creating new unit-based earnings that impact or are impacted by shift differentials, you can:
Add the units (hours) processed for the new earnings to the accumulator SHIFT DIFF UNIT. This accumulator functions as the Unit component in the calculation rule of the delivered SHIFT - R and SHIFT PCT earnings. SHIFT - R and SHIFT PCT are resolved only if units from other earnings are included in the SHIFT DIFF UNIT accumulator.
Note. The generation control element ERN GC SHIFT EXC prevents resolution of these earnings if the SHIFT DIFF UNIT accumulator contains no units. This element looks at the accumulator and the values of the shift group and shift ID. If the value of SHIFT DIFF UNIT is greater than 0 and the payee is in a shift group and has a shift ID, the system processes the earnings.
Note. As delivered, only units from WAGES and REGULAR are included in SHIFT DIFF UNIT.
Use the formula ERN FM OVT RATE to calculate the shift differential directly in the Rate component of the earnings' calculation rule. Use OVT 1.5, OVT 2.0, or PREMIUM as models for the new elements.
ERN FM OVT RATE is defined in the following way:
ERN BR SHIFT DIFF >> GP TEMP001 NUM If ERN VR SHIFT GRP <> '' Then If ERN VR SHIFT D PCT <> 0 Then HOURLY RT * ( 1 + ERN VR SHIFT D PCT / 100 ) >> ERN FM OVT RATE Else HOURLY RT + ERN BR SHIFT DIFF >> ERN FM OVT RATE Endif Else HOURLY RT >> ERN FM OVT RATE Endif
This formula defines the rate in one of three ways:
As the system element HOURLY RT × (1 + ERN VR SHIFT D PCT ÷ 100) if the payee is associated with a shift group and the bracket ERN BR SHIFT DIFF returns a shift percent that is not zero.
As the system element HOURLY RT + ERN BR SHIFT DIFF if the percent returned by the bracket is zero.
If neither a nor b is true, the rate used is the system element HOURLY RT.
If you create earnings that use variables or other supporting elements in their calculation, you can modify or replace the standard supporting element override components to facilitate entering the values of these variables and other elements at either the payee or calender ID override levels.
Note. You can modify the standard supporting element override components by adding or changing field labels, prompt tables, and other page elements to better suit the elements that you want to override.
See Also
This section discusses:
User fields for new taxable earnings.
User fields for new earnings that calculate or affect shift differential pay.
User Fields for New Taxable Earnings
If you create new taxable earnings, you should associate them with the same tax-related user fields used to define the delivered earnings. These are TAX VR RPT TYPE, TAX VR STATE, and TAX VR METHOD. In addition, all taxable earning accumulators should include these variables as user keys.
User Fields for New Earnings that Calculate or Affect Shift Differential Pay
If you define new earnings that calculate or affect shift pay, you should associate them with the same shift-related user fields used to define WAGES, REGULAR, SHIFT - R, SHIFT PCT, and the overtime earnings. These are ERN VR SHIFT GRP and ERN VR SHIFT ID. In addition, all accumulators for earnings that process or affect shift differentials should include these variables as user keys.
See Also
Managing Multiple Resolutions of an Earning or Deduction