Partner Onboarding Exercises

Exercise 2.1.1: Create your Partner Project in the ADP Self-Service tool

Duration

Approximately 30 minutes

Required Steps

  1. You will need to log into the https://adpapps.adp.com/self-service tool using the credentials you received in two emails from SecurityServices_NoReply@adp.com with a ADP Marketplace user id and temporary password.
  2. Once logged in you will need to click on Start new Project
  3. You will be prompted to fill out basic information (Project name, Description, which ADP product you will be integrating with, ETC). Once completed click on Next.
  4. You will be presented to choose a use case that best describes your application. Choose one and click Submit then click on Done.

     

Exercise 2.1.2:  Generate your Mutual SSL Certificate (CSR)

Duration

  • Approximately 5 minutes

Exercise Details

  • A Mutual SSL certificate is required for call API call exchanged with the ADP API Gateway  (adp.adp.com or accounts.adp.com).

Required Steps

  1. Log into the https://adpapps.adp.com/self-service tool.
  2. Click on the Certificate Icon in the upper left-hand corner.
  3. This will take you to the Certificate Management Page.
  4. Click on Request Certificate.
  5. You will be prompted to fill out a few required fields. Once filled out click on Next.
  6. The next page will present you with your Private Key. Use the Copy button and save the Private key In a text editor as a .KEY file. Then click on OK, I Copied My Key.
  7. You will be taken to page where your certificate will be generated click on Done.
  8. On the next page you will click on the Download link to retrieve your Signed .PEM file.  
  9. Store both the .KEY and .PEM in a safe place.

Exercise 2.1.3: Request a Test Instance (ADP WFN, RUN, Vantage)

Duration

  • 30 minutes

Exercise Details

  • In this exercise, you will create a Test Instance (sandbox).
  • This instance will be used to test your integration against a fictitious organization within an ADP product.

Required Steps (for ADP WFN and Vantage)

  1. Log into the https://adpapps.adp.com/self-service tool.
  2. Click into your project and at the top of the page click on Test Instance.
  3. Click on the Request A Test Instance button.
  4. You will then receive 3 emails (two of which will come from SecurityServices_NoReply@adp.com)
  5. The first email will contain your test instance User ID and link to your test instance.
  6. The second will be your temporary Password.
  7. Use the Link and the ID and Password from the steps above to log into your test instance (making sure you click on “Administrator Sign In” first)
  8. Once logged in this will prompt you to change you Password.
  9. The third email will come from ADP Marketplace Support_noreply@adp.com with the subject of Connect Request.
  10. You will see View Request at the bottom of that email. In an Incognito window open that link and Login with the ID and Password you received above and Grant Consent by clicking on Allow.

**If you are a Partner integrating with RUN please reach out to your Market Place Technical Advisor to setup your RUN test instance.  



Exercise 2.1.4: Understanding the ADP Partner Credentials

Duration

  • Approximately 10 minutes

Exercise Details

Read Introduction to Credentials this document will go over each set of credentials ,where to find them and what they are used for.


Exercise 2.1.5: Provide UI access Permissions to Access Workers in your Test Instance

Duration

  • 30 minutes

Exercise Details

  • After creating your test instance if you cannot see users in your test instance you will use the steps below to gain access.

Required Steps:

  1. Access https://workforcenow.adp.com. (you may need to use incognito mode.)
  2. Click on Administrator sign-in on the login screen
  3. Once the Administrator login page is loaded type in your test instance credentials then type in your password
  4. Once you are logged in navigate to the following screen

    Setup à Security à Access Permission à Payroll and People Access

  1. Lookup your name by providing your first and last name in the Search Field and press filter
  2. Click on our name from the filter results. The user access permission screen will be loaded.
  3. Click on Payroll Processing Access Tab.
  4. Select All Company CodesView & Edit then click on Save.
  5. You will now be able to view and edit all employees and access payroll menu items.
    May also need for Vantage setup

 

Exercise 2.1.6: Provide Access to Additional Team Members

Duration

30 minutes

Exercise Details

As an ADP Marketplace Partner account administrator, you can add team members as users to your account (additional developers, etc.)

Required Steps:

  • To add additional team member access to your ADP Marketplace Account please follow the steps outlined in the guide Adding Developer Resources.