Overview of Oracle Payroll Connect for ADP Global Payroll

Integrate Oracle HCM Cloud with ADP Global Payroll through Oracle Payroll Connect for ADP Global Payroll. With this integration, you can convey new-hire transactions in Oracle HCM Cloud to ADP Global Payroll in real-time.

You can also send updates and maintenance to this transaction to ADP in batch mode using HCM Extracts.

You can configure and maintain the integration to ADP Global Payroll through:

  • A simplified configuration page to define the data elements that you want to send to ADP Global Payroll in real-time and batch mode

  • A status page to review the status of various transactions sent to ADP Global Payroll in both real-time and batch mode

Here's an overview of the new-hire flow with the Oracle Payroll Connect for ADP Global Payroll:

  1. Hire Employee: Hire an employee in Oracle HCM Cloud through the user interface, loader, or API. Use ADP specific validations to enter the employee data.

  2. Publish Data to ADP: Wait for the application to capture necessary data, then call real-time API to ADP for establishing employee records.

  3. Enter Payroll Data: The new-hire can enter payroll data into ADP application that is managed by ADP. The Payroll Administrator can add more info to the payroll data in ADP.

  4. Run Payroll Interface for ADP Global Payroll v2: Send additional changes from Oracle HCM Cloud to ADP using HCM Extracts.

This image summarizes the implementation of new hire flow with Oracle Payroll Connect for ADP Global Payroll.

You would need various configurations for the transaction flows in both the applications:

  1. Set Profile Options

  2. Identify Payrolls Processed by ADP

  3. Define and Assign Payroll Security Profile

  4. Activate Sandbox

  5. Configure Data Validation Rules

  6. Configure Payload Rules

  7. Configure Payroll Integrations

  8. Schedule ESS Job

This image summarizes the configuration requirements in both ADP Global Payroll and Oracle HCM Cloud.

Before You Start

Before you integrate Oracle HCM Cloud with ADP Global Payroll, perform these tasks:

  1. Set Profile Options: Log in to Oracle HCM Cloud as an Integration Specialist and set profile options.

    Profile Option Code

    Profile Option Name

    Profile Level

    Value

    ORA_PAY_ENABLE_EXT_PAY_INTEGRATION

    Enable Integration with ADP Systems for Payroll Processing

    Site

    Yes

  2. Authenticate Real-Time Integration: You must authenticate this real-time integration using JSON Web Token (JWT).

    • Authenticate using JWT: Oracle Payroll Connect integration uses ADP REST APIs to send new-hire data in real-time, and JWT token authenticates these APIs.

      Here's how you can set up the JWT authentication:

      1. Export orakey_sign public key from Oracle HCM Cloud for ADP Global Payroll integration.

        1. Navigate to Security Console and API Authentication tab.

        2. Click the Oracle Public Certificate to download the certificate.

      2. Once you receive the key, open a service request with ADP for importing the key to the corresponding ADP instance. For example, public key from Oracle HCM Cloud production instance imported into the ADP Global Payroll production instance. Here's a sample JWT generated for ADP authentication flow:

        JWT HEADER
        {
          "alg": "RS256",
          "typ": "JWT",
          "x5t": "r2oR5F01a-a5cwAdgUAt6JfE4k0"
        }
        JWT PAYLOAD
        {
          "exp": 155364350,
          "tenant": "123456",
          "iss": "www.oracle.com",
          "aud": "globalview-prod",
          "jti": "1234-12345-123456-12345-1234",
          "iat": 1555363750
        }
        
        
  3. Identify Payrolls Processed by ADP: Identify payroll definitions that are processed by ADP Global Payroll, and for which you want to enable this integration.

  4. Review Data Security: Payroll Interface Coordinators must have the required data roles to review the data associated with specific payrolls that interfaces with ADP Global Payroll. You can create data roles with appropriate payroll security profiles from the Manage Data Roles and Security Profiles page.

    Note:

    You can't use View All payroll security profile while creating data roles using payroll security profile

  5. Assign Data Roles to Payroll Administrators: Assign the generated data roles from Step 4 to the Payroll Administrators who are managing the identified payrolls.