Integrating with Variable Compensation Functionality

This chapter provides an overview of variable compensation awards and discusses how to process variable compensation awards.

Understanding Variable Compensation Awards

Using the Administer Variable Compensation business process in PeopleSoft Enterprise Human Resources, you can create and manage multiple incentive plans. The resultant compensation (award), whether monetary or nonmonetary, can be paid to payees through Global Payroll.

This section discusses:

• Setting up Global Payroll to work with variable compensation.

• Approving variable compensation awards.

• Retrieving and validating awards.

• EIPs for variable compensation data.

See Also

Integrating with Payroll for North America and Global Payroll

Defining Run Types

Working with Positive Input

Setting Up Global Payroll to Work with Variable Compensation

In the Variable Compensation application, each variable compensation plan must be mapped to the appropriate Global Payroll earning elements.

In Global Payroll, you identify the earning elements that are associated with the award records that you want to retrieve and process. You enter this information on the Run Types page (in the Variable Compensation Details group box) when you set up the run type for the calendars that you use for award processing.

During the award retrieval process, the system retrieves only the award records that are associated with the earning elements that are included in the run type.

Approving Variable Compensation Awards

When variable compensation awards are approved in Human Resources, that application publishes award data to a temporary file that can be accessed by Global Payroll. Global Payroll validates the data and tells the Variable Compensation application which awards have been accepted and which have not. Accepted awards are loaded into the Positive Input Generated Data table.

When you run the Payroll process, the system processes the award data just as it processes positive input that is received from any source. After you finalize the pay run, you notify Variable Compensation that the award data has been processed. You can reject or delete award data before it is processed.

Retrieving and Validating Awards

After Variable Compensation sends award records to Global Payroll, you retrieve and validate the records. Records that pass the validation process are loaded into the Positive Input Generated Data table and can no longer be updated.

Global Payroll notifies Variable Compensation of award records with errors. You can view the error messages through PS Application Message Monitor, though these messages are intended for the Variable Compensation administrator. Each message has a status of E (error) and includes one of the following reason codes:

• 03: Invalid Currency Code

• 05: Transaction already exists

• 09: Error Updating GP

• 11: Error Updating ACK_PUB

• 13: Invalid Pin Num

The Variable Compensation administrator makes necessary corrections and resubmits the revised records to Global Payroll.

EIPs for Variable Compensation Data

Two EIPs are used to transfer Variable Compensation data between Human Resources and Global Payroll:

• Acknowledgement/Verification of Variable Compensation Payment (GP)

  • This EIP uses the Variable Compensation Payment Acknowledge application message (VAR_CMP_PAYMENT_ACKNOWLEDGE_GP).

    The data is delivered through the Variable Compensation Payroll Interface channel (VAR_COMP_PAYROLL_INTERFACE).

  • The EIP also uses the Variable Compensation Payment Acknowledge GP publish rule (VAR_CMP_PAYMENT_ACKNOWLEDGE_GP).

  • Global Payroll publishes data to the Payroll Acknowledge Staging table (PS_GPVC_ACK_PUB).

    Human Resources then subscribes to the table to retrieve Global Payroll data. This publish and subscribe activity is nearly in real time.

• Variable Comp Request for Payment (GP)

  • This EIP uses the Variable Compensation Payment Request application message (VAR_COMP_PAYMENT_REQUEST_GP).

    The data is delivered through the Variable Compensation Payroll Interface channel (VAR_COMP_PAYROLL_INTERFACE).

  • Human Resources publishes data to the Variable Compensation Request Staging table (PS_VCGP_RQT_PUB) for use by Global Payroll.

Note. To research the technical details of an EIP used by PeopleSoft applications, refer to the Interactive Services Repository on Customer Connection.

Processing Variable Compensation Awards

This section discusses how to:

• Retrieve awards.

• Reject awards.

• Delete awards.

• Notify Variable Compensation of payroll results.

Page Used to Process Variable Compensation Awards

Retrieving Awards

Access the Retrieve Variable Comp page.

To retrieve award data:

1. Select Push Award Data to Payroll.

2. Select the calendar group ID, paygroup, and calendar ID.

3. Click the Run button.

Select the Process to Run

Common Page Elements

Positive Input Fields Updated by Award Data

This table shows the award values that populate the positive input fields in Global Payroll:

Rejecting Awards

Access the Retrieve Variable Comp page.

If the Variable Compensation administrator submits the wrong set of award records, you can reject all records for a selected plan ID and payout period if Global Payroll has not yet retrieved the records. This feature prevents further processing of the awards and should be used only at the request of the Variable Compensation administrator. When you reject awards, Global Payroll sends a message to Variable Compensation with this code:

Code 07: Reject All - Requested by User/Reject All.

To reject award records:

1. Select Reject Award Data for Plan ID.

2. Enter the variable compensation plan ID and the payout period ID.

3. Click the Run button.

Deleting Awards

Access the Retrieve Variable Comp page.

You can delete award records that have been loaded into Global Payroll if they have not yet gone through the Calculate phase of the payroll process. When you delete records, Global Payroll sends a message to Variable Compensation with this code:

Code 12: Deleted from GP PI/Deleted

To delete award records:

1. Select Delete Award Data for Plan ID.

2. Enter the variable compensation plan ID and payout period ID.

3. Click the Run button.

Notifying Variable Compensation of Payroll Results

Access the Retrieve Variable Comp page.

When you’re ready to finalize a pay run that includes award data, you send a notice to Variable Compensation. The notice includes the following information with a status of Paid:

• Empl ID (employee ID)

• Empl Rcd Nbr (employee record number)

• VC Plan ID (variable compensation plan ID)

• VC Payout Period

• GB Group ID

• VC Award Date

• VC Award Value

Global Payroll also notifies Variable Compensation of any awards that are not paid. These awards are assigned a status of Error or Reject and are returned with the reason for the failure.

You can run the notification process more than once. Each time that you do so, the system retrieves everything that Variable Compensation has not been notified of before.

To notify Variable Compensation of payroll results:

1. Select Send Notification back to VC.

   When you select this option, the page displays only the fields in the Select the Process to Run group box.

2. Click the Run button.