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 HR, you can create and manage multiple incentive plans. The resultant compensation (award), whether monetary or non monetary, 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.

• Integration points for variable compensation data.

See Also

Understanding Variable Compensation

Integrating with Payroll Applications

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.

See Also

Defining Run Types

Approving Variable Compensation Awards

When variable compensation awards are approved in HR, that application sends 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 Service Operations 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.

Integration Points for Variable Compensation Data

Two integration points are used to transfer Variable Compensation data between HR and Global Payroll:

• Variable Comp Request for Payment (GP).

  • This integration point uses the Variable Compensation Payment Request service operation (VAR_COMP_PAYMENT_REQUEST_GP).

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

  • HR sends data to the Variable Compensation Request Staging table (PS_VCGP_RQT_PUB) for use by Global Payroll.

• Acknowledgement/Verification of Variable Compensation Payment (GP).

  • This integration point uses the Variable Compensation Payment Acknowledge service operation (VAR_CMP_PAYMENT_ACKNOWLEDGE_GP).

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

  • The integration point also uses the Variable Compensation Payment Acknowledge GP send rule (VAR_CMP_PAYMENT_ACKNOWLEDGE_GP).

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

    HR then receives the table to retrieve Global Payroll data. This send and receive activity is nearly in real time.

Note. To research the technical details of an integration point used by PeopleSoft applications, refer to the Interactive Services Repository in the Implementation Guide section of My Oracle Support.

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 (Global Payroll & Absence Mgmt, Absence and Payroll Processing, Prepare Payroll, Retrieve Variable Comp, Retrieve Variable Comp).

To retrieve award data:

1. Select Push Award Data to Payroll.

2. Select the calendar group ID, pay group, 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 (Global Payroll & Absence Mgmt, Absence and Payroll Processing, Prepare Payroll, Retrieve Variable Comp, Retrieve Variable Comp).

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 (Global Payroll & Absence Mgmt, Absence and Payroll Processing, Prepare Payroll, Retrieve Variable Comp, Retrieve Variable Comp).

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 (Global Payroll & Absence Mgmt, Absence and Payroll Processing, Prepare Payroll, Retrieve Variable Comp, Retrieve Variable Comp).

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.