This article provides a comparison between the most recent ClearCompany/ADP new hire data transfer integration and the previous available transfer.
Background
When ClearCompany first launched our Bi-Directional connector in the spring of 2019, this came with a new hire transfer that sends an In Progress hire to ADP. ADP has since released a V2 of this integration which we have now developed support for and are making available for clients to migrate to.
Terms
Some terms which are helpful to know
- API
- Application Programming Interface, a software intermediary which allows two applications to communicate with each other. In the context of ClearCompany/ADP integrations, we use a variety of APIs offered by ADP to transfer and receive data to and from their system
- In Progress API (Applicant Onboard V1)
- This is V1 of the new hire transfer which came with or Bi-Directional Connector. Internally referenced at ClearCompany and with clients as the In Progress API, but the official ADP title is Applicant Onboard V1
- Applicant Onboard V2
- The updated version of the new hire transfer API available to clients
Why the change in terminology?
Whereas before there were differences in terms for the same API (At ClearCompany: In Progress, at ADP: Applicant Onboard V1), moving forward we are using the same terminology used by ADP to allow both internal teams and clients greater autonomy in understanding what methods we use to transfer data in between our systems.
Primary Differences
The main differences between V1 and V2 are
- Multiple custom templates: V2 can send to multiple custom hiring templates (V1 could only send to a single custom template titled “Applicant Onboard”)
- Along with the above, V2 supports sending Canadian and International hires
- State Tax: V2 supports sending state tax data which was not previously available
- Please see here for further information on available state tax data to transfer
- Hire Type: V2 can send either an In Progress Hire to be completed from a hire template in ADP, or a Completed Hire directly into Workforce Now
- Please Note: In Progress is the default hire type for our integrations and is the recommended method for transferring new hires to ADP. This is because, when sending a completed hire, ADP requires a broader range of fields and more strictly validates the data. This in turn means there are more opportunities for data inaccuracy to cause a transfer failure with a completed hire
- Rehire: V2 is bundled with ADP Rehire functionality. For more information on ADP Rehire, please see here
Available Fields
For an in depth look at the additional fields available for Applicant Onboard V2, please expand below.
| Field Name | V2 | V1 |
|---|---|---|
| First Name | ||
| Middle Name | ||
| Last Name | ||
| Preferred Name | ||
| Address 1 | ||
| Address 2 | ||
| Address 3 | ||
| Address City | ||
| Address State / Province / Territory | ||
| Address County | ||
| Address Zip/Postal Code | ||
| Address Country | ||
| Home Phone Country Code | ||
| Home Phone Area Code | ||
| Home Phone Dial Number | ||
| Personal Cell Country Code | ||
| Personal Cell Area Code | ||
| Personal Cell Dial Number | ||
| Home Email | ||
| Gender | ||
| Birth Date | ||
| Tax ID | ||
| Marital Status | ||
| Marital Status Effective Date | ||
| Ethnicity / Race ID Method | ||
| Race | ||
| Ethnicity | ||
| Hire Template | ||
| Hire Status | ||
| Job Title | ||
| Reports To | ||
| Home Department | ||
| Location | ||
| Hire/Rehire Date | No rehire | |
| Reason for Hire/Rehire | No rehire | |
| Company Code | ||
| EEOC Job Classification Code | ||
| FLSA | ||
| Benefits Eligibility Class | ||
| Worker Type Code | ||
| Pay Grade | ||
| Pay Frequency | ||
| Pay Period Rate Amount | ||
| Daily Rate Amount | ||
| Hourly Rate Amount | ||
| Federal Tax Marital Status | *See note below | |
| Federal Tax Deductions | *See note below | |
| Federal Tax Dependents | *See note below | |
| Federal Tax Multiple Jobs | *See note below | |
| Federal Tax Other Income | *See note below | |
| Federal Tax Additional Tax Amount | *See note below | |
| Do not calculate Federal Income Tax | *See note below | |
| State Tax Worked In State | ||
| State Tax Filing Status | ||
| State Tax Exemptions | ||
| State Tax State Code | ||
| State Tax Additional Tax Amount |
*Note: For V1, Federal Tax data was sent in a supplemental API request after the initial data transfer. For V2, we can now send the Federal Tax data as a part of the initial transfer.
Next Steps
Want to move to V2? There is no additional charge associated with updating your integration. If you'd like to have your integration migrated, contact your Customer Success Manager and they can begin that process in conjunction with ClearCompany support.
Comments
Please sign in to leave a comment.