Introduction

Sapling can sync new hire data with your ADP account, saving your HR, People Operations and Payroll manual data entry and removing the risk of errors, while providing a great new hire experience.

ADP Workforce Now is ADP's payroll solution for mid-size businesses. Sapling’s integration with ADP allows you to:

  1. Collect all the information you need for all employee records.
  2. Automate workflows, setup triggered notifications, and reminders across multiple departments, locations and stakeholders, with detailed analytics around workflows.
  3. Push new employee information to ADP Workforce through a Hire/ Rehire Template
  4. Ensure key employee information stays synchronized with a seamless two-way integration updated daily at 12am.

The integration is available in the ADP Marketplace and you can request the Sapling integration in the ADP Marketplace.

How It Works

Sapling leverages ADP’s Workers v2 API, which allows Sapling to send applicants (and key information collected by Sapling) into ADP’s New Hire Wizard within ADP Workforce Now. This then allows an ADP admin to login, confirm and enrich the applicants data, then complete the new hire in the ADP onboarding wizard itself.

Following the sync from Sapling to ADP, an Associate ID is created in ADP. Each employee’s ADP Associate ID is automatically fetched by Sapling and attached to the employee’s Sapling Profile. Sapling then uses this Associate ID to match any changes from ADP back into Sapling, ensuring key information stays in sync for all your employees.

Setting up the Integration

Data Flow Overview

Overview

In order to provision the new record in ADP Workforce, the following information is required in Sapling:

  1. Name (typically pushed into Sapling from your company’s ATS)
  2. Personal Email (required input)
  3. Start Date (typically from your ATS)
  4. SSN (collected from new hire)
  5. Gender (collected from new hire)
  6. Birthday (collected from new hire)
  7. Address (collected from the new hire)

Integration Fields

Sapling is continually expanding the number of fields that sync between Sapling and ADP based on those that become available on ADP’s APIs.

  • Here is a full list of Sapling and ADP Integration Fields.
  • Sapling will sync daily with ADP.
  • Any changes that are made in ADP to the available fields will sync over from ADP and be reflected in Sapling. Changes are synchronized daily at 12:00am.

Key Factors to be aware of

ADP Stated Limitations

Like all software, there are some known limitations of the ADP Workforce API. The key ones for Sapling customers to be aware of are:

  • US879795: Custom Templates (Except the Applicant Onboard Template) are not Supported
  • US1238045: Issue with Posting Details of an Employee Who has been Previously Terminated
  • US905487: Fields not Supported through API, most importantly
  • Documents: Uploaded documents are managed by ADP's internal doc cloud service and are not fully embedded in the Workforce Now product. Today, only internal APIs exist for the doc cloud, and adding external API support is not on ADP's current product roadmap.

Multiple Onboarding Templates Management

  • Enable US-based onboarding templates toggle: This toggle will provide the list of US based templates, and user will be created using ADP onboarding API-V1.
  • Multiple onboarding templates toggle: This toggle will provide the list of all the templates (US based and International), and user will be created using ADP onboarding API-V2.
  • When the Multiple onboarding templates (US based and International) toggle is enabled, Sapling will create the Worked in Country as a Multiple Choice field and populate all the option automatically.
  • For Multiple onboarding templates (US based and International), Worked in Country and ADP Company Codes (You have to enable ADP Company Codes toggle as well) as these are required fields.
  • ADP onboarding API-V2 has strong validation and ADP onboarding API-V1 has a lower validation.
  • You can only enable one toggle (Enable US-based onboarding templates OR Multiple onboarding templates) at a time. When enabling one option, the other option will be disabled automatically.

Rehiring in Sapling and ADP

  • Individual users in your Sapling account are linked with an Associate ID in ADP.
  • For rehires, these should be managed directly in ADP, and Sapling will then pull the changes back from ADP. For example - Location, Departments or Managers.
  • You'll still be able to assign them documents/ workflows directly on their profile (and track them through your transitions dashboard).

Managing Locations, Teams and Business Units

Often partners are managing multiple field categories in their ATS and seek to understand how Teams, Locations and Commitments map to ADP. Sapling commonly sees:

  • Employment Status = Worker Category
  • Team = Home Department
  • Location = Location

For these to sync correctly, the naming conventions must match between Sapling and ADP.

Job Titles in Sapling & ADP

  • To ensure a consistent data flow between Sapling and ADP, Job Titles are pulled from ADP into Sapling.
  • This syncing of data is used to ensure that Program Leads assign the appropriate Job Title to new hires. To achieve data accuracy of Job Titles, the Job Title must be listed in ADP for it to be reflected in Sapling.

Multiple Company Codes

  • Send multiple company codes provided the company codes are available on the list returned by code list API "/codelists/hr/v3/worker-management/company-code-values".
  • When onboarding an employee, the company code can be selected and the ADP company code will be selected based on the values inputted.
  • Be notified about changes in company codes, and update the company code in Sapling.

Sapling cannot send changes in company codes (i.e. for transfers) to ADP and these must be managed manually.

Multiple Applicant Onboard Templates

ADP WFN offers templates for practitioners to start the new hire process. The Applicant Onboard API supports the following templates:

  • HR + Payroll (System)
  • HR + Payroll + Time (System)
  • HR + Time (System)
  • HR Only (System)

In addition, the Applicant Onboard API supports one custom template as long as the name is Applicant Onboard. You can learn more about the template management in the guide available here.

Custom Fields

ADP supports custom fields with two current constraints. They must be:

  • Text field type (not numbers, multi-choice etc.)
  • Set up in the Employment Custom Fields section (not profile or other sections)

This requires custom development work from the Sapling Solutions team and is subject to additional charges.

Ask Us About

  • Time Off with Sapling and ADP
  • Benefits with Sapling and ADP
  • Offboarding with Sapling and ADP
  • Syncing Sapling with International ADP Profile templates

Speak to your Sapling Customer Success Manager to learn more about the above.

💡Looking to do more? Check out our API or Check out our Customer Success Stories.

Did this answer your question?