ADP Workforce Now

Connecting to ADP requires several pieces of information.

Firstly you need to get a Client ID and Client Secret from your ADP client representative.

Secondly you need to generate a private key and a signing request (these are two files), submit the signing request file to ADP, and get a signed 'certificate' file back. This is called a Certificate Signing Request (CSR), and the process is documented here:

ADP Certificate Signing Request instructions

The ADP CSR process document is quite comprehensive. It's broken into three main steps.

  1. Generate two files (a .key and a .csr file) using a command line tool called OpenSSL
  2. Submit only the .csr file to ADP
  3. Receive a .pem file back from ADP

If you're unfamiliar with working with command line tools like OpenSSL, you may need the help from someone in your IT team.

It's very important that you keep the .key file safe. You should only send the .csr file to ADP. You will need the .key file later when you connect to Trelica.

To connect Trelica to ADP you will then:

  • enter the Client ID and Client Secret into Trelica
  • paste in the contents of the .key and the .pem file into Trelica

Attribute mapping

Trelica person attribute How it's determined
ID Unique ID assigned to the worker
Email The business email, if one is available
First name Uses the preferred first name, or legal first name if preferred isn’t set
Last name Uses the preferred last name, or legal last name if preferred isn’t set
Employee ID Official employee ID from ADP
Employee type Worker type code short name, if available
Job title Job title, if available
Start date Usually the rehire date if applicable, otherwise the original hire date or actual start date
Leaving date Termination date if the person has left
Location Based on the business address of the person's assigned work location
Manager Line manager
Cost center Short name of the business unit, or full name if short isn’t available
Status Set to “Inactive” if the person is terminated, otherwise “Active”
Personal address If enabled when connecting to ADP, home work location address
Team By default, department but can be configure by Trelica support for other ADP organization unit attributes.

ADP contains sensitive information. Trelica requests the following attributes from the ADP API:

associateOID
workerID
workerDates
workerStatus
person/legalName
person/preferredName
businessCommunication/emails
workAssignments/jobTitle
workAssignments/primaryIndicator
workAssignments/actualStartDate
workAssignments/primaryIndicator
workAssignments/reportsTo
workAssignments/assignedOrganizationalUnits
workAssignments/homeWorkLocation
workAssignments/assignedWorkLocations

 

Was this article helpful?

0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.