Skip to main content
ADP Workforce Now

How to set up your ADP Workforce Now Integration

Updated over a week ago

ADP Workforce Now is an all in one HRIS system. We integrate with ADP Workforce Now payroll. Please refer to ADP's API documentation to help you get started. Some basic understanding of ADP fields is required.

Features

  • Import Staff

  • Auto Import Staff

  • Export Timesheet file to Payroll

  • Export Allowances and Deductions file to Payroll

  • Sync Teams

How to configure the ADP Workforce Now integration

  1. Name your integration

  2. Enter your Company Code, which is typically a 3 letter code in all caps ex: PRE

  3. Reach out to your ADP Representative, who will need to give you a Client ID, and a Client Secret for API Access to your account.

  4. Please make sure that your ADP Representative knows we will need unmasked personal data, as well as, baseRemuneration, which will give us access to pay rates.

  5. When you receive these, you'll need to reach out to your Workforce.com representative, who will generate a Certificate and RSA Private Key and upload them to your account. This process is known to take several days.

** IMPORTANT** Getting the right information from ADP ** IMPORTANT**

Integrating with ADP is a rewarding process. Please follow these steps closely to make sure that you can integrate Workforce.com and ADP Workforce Now

You'll need to contact your ADP account manager, and request that you get put in contact with someone in Professional Services, or any department that deals with APIs. Remind them that you are not building an integration, you just need their help turning on the API Access for an already built integration not on their marketplace.

Workforce.com will need access to the Get Workers call on ADP Workforce Now (docs)

They will start the process that will eventually give us access to the API. The first step will be to generate a CSR (which stands for Certificate Signing Request) and send it back to your representative in Professional Services. The link to generate one can be found here.

The fields you fill out will look like this.

The most important fields are "Organization" and "Common Name".

Organization: MUST be exactly as it is in ADP. Don't know what that is? Please ask them for it!

Common Name: will be a combination of your company's name, and Workforce.com. The key size should always be 2048.

When you click "Generate CSR", then it will give you 2 outputs in the same window. The top will be a long string of characters that will end with "-----END CERTIFICATE REQUEST-----". You'll need to copy that value and email it to your ADP Representative in Professional Services. They will get the process started for generating API credentials. The second part of the output will end with "-----END PRIVATE KEY-----". You will need to save this, and send it to your Workforce.com representative securely. The two, now separate files, will should be saved in this format.

company-name.key

company-name.csr

The endings of the files will let us use them properly for authentication. If you have trouble with this, just let Workforce.com know.

You will need to be explicitly clear to the Professional Services team that you need the following fields accessible via the API. If you do not, you risk duplication of data or wiping of data.

ADP Fields

  • "Given_Name"

  • "Family_Name1"

  • "birthDate"

  • "businessCommunication", "landlines"

  • "businessCommunication", "mobiles"

  • "Communication", "landlines"

  • "Communication", "mobiles"

  • "businessCommunication" "emails"

  • "Communication" "emails"

  • "workerStatus", "statusCode", "codeValue"

  • "workAssignments"

  • "WorkerDates"

When ADP returns, they will provide a Client_ID, a Client_Secret, and a .pem file. This is what Workforce.com will need to complete the integration.

Importing Steps

Import Staff

Workforce will import all employees with the follow fields:

  • Name

  • PayrollFileNumber (Payroll ID)

  • Email

  • Hourly Rate

  • Phone

  • Date of Birth

  • Start Date

  • Termination Date

  • Active Status

  • Home Location

  • Primary Job

To import manually, follow the instructions below.

  1. Go to /staff page

  2. In the top right corner click "Add Staff"

  3. Go to "Import Bulk Staff"

  4. Select the "Import From" drop down menu

  5. Select "ADP Workforce Now"

  6. Workforce.com will now import staff from ADP Workforce Now


To automatically import newly added staff to ADP Workforce Now into Workforce.com, please check the "Auto Import Staff" checkbox on the ADP integration page.

To automatically import the staff's work assignments, please check "Sync Teams" checkbox on the ADP integration page.

Sync Teams

In order for teams to sync from ADP Workforce Now into Workforce.com, the shortName of the location linked to each user needs to match exactly to the location name in Workforce.com.

Once these match, when you sync the 2 systems, the users that populate will be assigned to a location and team in Workforce.com that matches what they are listed as in ADP Workforce Now.

If you change the location name in ADP Workforce Now, and it doesn't match any of the existing location names in Workforce, the next time the systems sync a new location will be created in Workforce.com that matches the name in ADP Workforce Now.

Did this answer your question?