1. Home
  2. Account Settings
  3. Integrations
  4. ADP Workforce Now Direct Integration

ADP Workforce Now Direct Integration

From your

Applies to ,

Overview

The ADP Workforce Now direct integration enables you to send your payroll information directly to ADP for payroll processing.

With this integration you can:

  • Send worked hours, the pay rates for those hours, and paid time off from When I Work to ADP Workforce Now.
  • Create new employees in When I Work from your existing workers in ADP Workforce Now.

Considerations

  • Your workplace must use a paid Time Clock & Attendance plan to set up payroll integrations.

  • You must have Manager or Admin access privileges to set up the integration. Managers must have access to manage timesheets and pay periods.
  • The email you use to purchase the When I Work Connector for ADP Workforce Now MUST be the same email you use for When I Work.
  • When adding When I Work employees that are based on ADP workers you need to manually assign each When I Work employee to schedules and positions.
  • Any hours that are not properly matched are not sent to ADP Workforce Now. Make sure to compare the pay period summary in When I Work to the batch hours in ADP to determine if any hours were not sent.
  • Time off hours sent from When I Work to ADP Workforce Now do not automatically update employees’ time off balances in ADP Workforce Now.
  • Wages can be sent from When I Work to ADP Workforce Now, with the following caveats:
    • This option is disabled by default. Enable in the configuration process.
    • If pay rates are configured for each employee, they are sent along with hours.
    • If weighted average overtime is present for an employee in the pay period, their pay rates are adjusted accordingly.
    • Pay rates with overtime premiums are not modified by When I Work. You need to configure your overtime premiums in ADP Workforce Now.

Before you begin

The integration requires you to match When I Work objects (schedules, positions, hours types, employees) to ADP Workforce Now objects (company, department, earning code, worker). Take a moment to survey your current ADP Workforce Now objects and determine how they correspond to the objects you currently have set up in When I Work.

Correct object matching is the most important step in securing your success with the integration. When I Work recommends reading this article in its entirety before getting started.

Recommendation

When I Work recommends setting Allocation Type to Department in Company Options of ADP Workforce Now for maximum compatibility.

Connector configuration

Use the following procedure to complete the ADP Workforce Now integration set up:

  1. Hover over Gear, then select Integrations Integrations.

  2. Click See All Integrations, then click Learn More in the ADP Workforce Now tile.
  3. Click Enable. You are directed toward the ADP marketplace page for the When I Work Connector.
  4. Purchase the Connector on the ADP marketplace.
  5. Consent to the legal prompts confirming you agree to the exchange of information between ADP and When I Work, then you are directed back to When I Work.You may need to check your email for a message from ADP to confirm the purchase. If so, the When I Work connector appears in your apps after you confirm.

Object matching

Navigate to the ADP Workforce Now integration in When I Work and complete the following steps to match all of your When I Work objects to ADP objects.

Skip Object Matching

You can skip the object matching for an individual object if it is not relevant to you. For example, if you don’t have schedules to match you can skip it. However, if you have hours that are associated with unmatched schedules, positions, hours types, or employees, those hours are not sent to ADP Workforce Now.

Schedule matching

Schedule matching is the first step in the object matching process. Please note the following before starting:

  • Match your existing When I Work schedules first, then add from ADP to avoid creating duplicates.
  • Each schedule can be matched to a unique company or matched to the same company.
  • At least one schedule must be matched before you can match other objects.

Match schedules dialog

  1. Click Schedules to open the Schedules matching page.
  2. Click Match Schedules to map existing When I Work schedules to an ADP company. The Match Schedules dialog opens.
  3. Select the company that matches your When I Work schedule from the drop-down menu, then click Save.
  4. Click Add From ADP to create schedules that are based on unmatched ADP companies. The Add Schedules from ADP dialog opens.
  5. Select the companies you want to match, then click Add.

Position matching

Match up your positions. Please note the following before starting:

  • Match your existing When I Work positions first, then add from ADP to avoid creating duplicates.
  • Positions are matched independently for each ADP company. A single When I Work position can be matched differently across multiple ADP companies.
  • Multiple positions can be matched to the same department.
  • You can choose to send hourly pay rates along with worked hours from When I Work to ADP.

Positions mapping

  1. Click Positions to open the Positions matching page.
  2. Click Match Positions to map When I Work positions to an ADP department. The Match Positions dialog opens.
  3. Select the department that matches your When I Work position from the drop-down menu, then click Save.
  4. Click Add From ADP to create  positions that are based on unmatched ADP departments. The Add Positions from ADP Departments dialog opens.
  5. Select the departments you want to match, then click Add.

Hour types matching

Match up your When I Work hour types to ADP earning codes. Please note the following before starting:

  • Hour types are matched independently for each ADP company. A single hour type can be matched differently across multiple ADP companies.
  • Multiple hour types can be matched to the same earning code.
    Custom Hour Types

    When I Work does not currently support custom hour types or custom time off types, so they cannot be imported from ADP.

Match hour types dialog

  1. Click Hour Types to open the Positions matching page.
  2. Click Match Hour Types to map the default When I Work Hour Type to an ADP Earning Code. The Hour Type Matches dialog opens.
  3. Select the earning code that matches your When I Work hour type from the drop-down menu, then click Save.

Match employees

Match up your When I Work employees to ADP workers. Please note the following before starting:

  • Match your existing When I Work employees first, then add from ADP to avoid creating duplicates.
  • Each employee must be matched with a single ADP worker in order to successfully send hours to ADP Workforce Now.
  • Pay period hours are not sent for unmatched employees.

Match employees dialog

  1. Click Employees to open the Employees matching page.
  2. Click Match Employees to map the When I Work employee to an ADP worker. The Match Employees dialog opens.
  3. Select the worker that matches your When I Work employee from the drop-down menu, then click Save.
  4. Click Add From ADP to create employees that are based on unmatched ADP workers. The Add Employees from ADP Workers dialog opens.
  5. Select the workers you want to match, then click Add.

Finalize your payroll

Send pay period hours to ADP Workforce Now

Active Payroll Cycle Required

You must have an active payroll cycle in ADP Workforce Now in order to send pay period hours.

  1. When you are ready, finalize your payroll and export.
  2. Select the Send Payroll to ADP Workforce Now tile.Send payroll to adp

Review and accept hours in ADP Workforce Now

  1. Log in to ADP WorkForce Now.
  2. Navigate to Process > Paydata.process pay data
  3. Select the batch that matches the hours you sent from When I Work.
    Note: The latest batch is listed at the bottom.Payroll batches
  4. Review the batch to check for accuracy and make any edits.
    Unmatched hours

    Any hours that are not properly matched are not sent to ADP Workforce Now. Make sure to compare the pay period summary in When I Work to the batch hours in ADP to determine if any hours were not sent.

    Review payroll
  5. Click Done to finish. You can now process your payroll using the normal process through ADP.

Troubleshooting

Mapping errors or missing data in timesheets

When pay period hours are sent from When I Work to ADP Workforce Now, a dialog is displayed that summarizes any hours that cannot be sent due to mapping errors or missing data in timesheet entries.  Errors are grouped by employee and sorted alphabetically for troubleshooting purposes.

If errors appear during the send action, you can choose to do one of the following:

  • Send hours from When I Work to ADP Workforce Now regardless of errors. Hours with errors are not included.
  • Cancel sending hours and correct any issues in the timesheets. See editing timesheets.
  • Update the integration configuration to correct the mapping issues that were found.

Payroll data won’t send

If an error occurs and your payroll data won’t send, make sure you have an active payroll cycle in ADP Workforce now to send the data to. The integration requires a payroll cycle to be active to send pay period data from When I Work to ADP Workforce now.

Worked hours not sending correctly

If worked hours are not sending correctly, try adjusting settings in Company Options of ADP Workforce now such that Allocations Type is set to Department.

Common errors

ErrorUser is not mapped to a worker
ResolutionMatch the When I Work employee to an ADP worker in the When I Work integration settings.
ErrorMapped ADP worker has no work assignments
ResolutionVerify that the matched ADP worker in ADP Workforce now is not terminated, belongs to a company, and is assigned to a department.
ErrorSchedule is not mapped to a company
ResolutionMatch the schedule to an ADP company in the When I Work integration settings.
ErrorCompany has no hour types mapped to earning codes
ResolutionMatch your hour types to earning codes for the company in the When I Work integration settings.
ErrorCompany does not have hour type <name> mapped to an earning code
ResolutionMatch the hour type to an earning code for the company in the When I Work integration settings.
ErrorPosition is not mapped to a department at the schedule’s mapped company <name>
ResolutionMatch the position to a department for the company in the When I Work integration settings.
ErrorUser has no matching work assignments for the schedule and position worked
ResolutionMake sure that the position is mapped to a department for the schedule’s matched ADP company.
If that does not resolve the issue, try one of the following:

  • In When I Work make sure each employee works positions that are mapped only to their home department in ADP Workforce Now.
  • In ADP Workforce Now, make sure Allocations Type is set to Department in Company Options.
ErrorPosition is not mapped to a department at the schedule’s mapped company
ResolutionMake sure the position is mapped to a department for the schedule’s matched ADP company.
ErrorUser has <number> work assignments for the schedule and position worked
ResolutionContact When I Work Customer Care
ErrorUser’s work assignment does not match account’s pay frequency. Expected <frequency> found <frequency>
ResolutionIn ADP Workforce Now, set the pay frequency for the ADP worker to match the pay period frequency set in When I Work.
ErrorWorker has no primary work assignment
ResolutionContact When I Work Customer Care
ErrorCompany does not have request type <name> mapped to an earning code
ResolutionMatch hours types to earning codes for the schedule’s company in the When I Work integration settings.
ErrorCompany for schedule has no positions mapped to departments
ResolutionMatch positions to departments for the schedule’s company in the When I Work integration settings.
ErrorSchedule is missing
ResolutionAdd a schedule to the timesheet entry in When I Work.
ErrorPosition is missing
ResolutionAdd a position to the timesheet entry in When I Work.
Error Resolution
User is not mapped to a worker Match the When I Work employee to an ADP worker in the When I Work integration settings.
Mapped ADP worker has no work assignments Verify that the matched ADP worker in ADP Workforce now is not terminated, belongs to a company, and is assigned to a department.
Schedule is not mapped to a company Match the schedule to an ADP company in the When I Work integration settings.
Company has no hour types mapped to earning codes Match your hour types to earning codes for the company in the When I Work integration settings.
Company does not have hour type <name> mapped to an earning code Match the hour type to an earning code for the company in the When I Work integration settings.
Position is not mapped to a department at the schedule’s mapped company <name> Match the position to a department for the company in the When I Work integration settings.
User has no matching work assignments for the schedule and position worked Make sure that the position is mapped to a department for the schedule’s matched ADP company.
If that does not resolve the issue, try one of the following:

  • In When I Work make sure each employee works positions that are mapped only to their home department in ADP Workforce Now.
  • In ADP Workforce Now, make sure Allocations Type is set to Department in Company Options.
Position is not mapped to a department at the schedule’s mapped company Make sure the position is mapped to a department for the schedule’s matched ADP company.
User has <number> work assignments for the schedule and position worked Contact When I Work Customer Care
User’s work assignment does not match account’s pay frequency. Expected <frequency> found <frequency> In ADP Workforce Now, set the pay frequency for the ADP worker to match the pay period frequency set in When I Work.
Worker has no primary work assignment Contact When I Work Customer Care
Company does not have request type <name> mapped to an earning code Match hours types to earning codes for the schedule’s company in the When I Work integration settings.
Company for schedule has no positions mapped to departments Match positions to departments for the schedule’s company in the When I Work integration settings.
Schedule is missing Add a schedule to the timesheet entry in When I Work.
Position is missing Add a position to the timesheet entry in When I Work.

 

Updated on March 26, 2021

Was this article helpful?

Related Articles

Still Need Help?

Open a ticket with our customer care team.

Submit a Ticket