1. Administering Oracle Payroll Interface
  2. Define Payroll Integrations

Define Payroll Integrations

Identify the payrolls that are processed by ADP Global Payroll. Navigate to the Payroll Integrations page from Data Exchange under My Client Groups. You will require Manage Payroll Integration Setup (HRY_MANAGE_PAYROLL_INTEGRATION_SETUP_PRIV) privilege to access this page.

Before you start

Before You Start

Complete these tasks before enabling Real-Time integration:

  • Collaborate with the ADP project team to determine the Audience, Tenant, and REST Endpoint values.

  • Complete the certificate exchange for ADP Global Payroll to authenticate the REST API call.

  • Complete the federation SSO configuration for the Deep Link URL.

  • Verify that the user account of a Payroll Administrator in Oracle HCM Cloud can also access ADP Global Payroll.

On the Payroll Integrations page, provide these details:

Note: Use the Audience and Tenant parameters to establish the JWT authentication.

  • Integration Details

    • Issuer: Indicates the source application for this integration.

    • Select the Enabled check box.

  • Target System

    • Audience: Indicates the target application for this integration. Provide a name of the ADP Global Payroll pod that the Oracle HCM Cloud instance will integrate with. You can find the available ADP Global Payroll systems from the list of values. Here are the supported combinations for this integration setup to be complete and functional.

      Environment

      Audience

      Issuer

      Production

      globalview-prod

      oracle-prod

      Demo

      globalview-demo

      oracle-demo

      UAT

      globalview-uat

      oracle-uat

      DEV

      globalview-dev

      oracle-dev

      RDQUA

      globalview-rdqua

      oracle-rdqua

      RDDEV

      globalview-rddev

      oracle-rddev

      Any other unsupported combination of Issuer and Audience will result in authentication failure while connecting the systems for this integration.

    • Tenant: Enter the Client ID provided by ADP.

    • REST Endpoint: Provide an endpoint URL to call the REST APIs. Gather the URL from your ADP representative. Here's a sample URL:

      https://portalxxx.globalview.adp.com/mnccc/v1/edi

  • Payroll Details

    • Name: Provide a name of the payroll that's processed by ADP and for which this integration is being defined.

    • Rule Name: Provide the payload rule associated with this payroll.

    • Event: New Hire and Termination events can be enabled to publish the payload in real-time to ADP Global Payroll.

      Note: New Hire event should be configured before adding the Termination Event

Enabling Real Time Termination: Important considerations

Consider these points to avoid potential data consistency errors when reporting happens in both real time and batch.

  1. After enabling a payroll for real time termination, when an employee mapped to that payroll is terminated, the employee will stop getting reported in the batch interface also.

  2. Subsequent changes to employee data wont be reported through batch interface once an employee termination has been reported through real time. Changes to terminated employee’s data will need to be synced with ADP outside of the standard interface.