Known Issues and Limitations

US1395531: In Payroll Instruction Response, effectiveDate field is displaying as effectiveDateDate

Impacted APIs

Method

URI

roleCode Value

GET /payroll/v1/workers/{aoid}/payroll-instructions practitioner

Issue Description

Within the GET API response payroll instruction, under workAssignmentStatus, the effectiveDateDate field should be displayed as effectiveDate.

Suggested Workaround

There is no workaround available.

US1390613: In Deduction Start/Change Request Payload, goalBalanceAmount is currently used for additional amount already taken in the ADP Workforce Now UI

Impacted APIs

Method

URI

roleCode Value

GET

/events/payroll/v2/worker-general-deduction-instruction.start/meta

practitioner

POST

/events/payroll/v2/worker-general-deduction-instruction.start

practitioner

GET

/events/payroll/v2/worker-general-deduction-instruction.change/meta

practitioner

POST

/events/payroll/v2/worker-general-deduction-instruction.change

Practitioner

Issue Description

In the request payload for deduction start and change, the following section is used for Additional Amount Already Taken in the ADP Workforce Now UI:

"deductionGoal": {"goalBalanceAmount": {"amountValue": 300}}

But, per the meta response, there is a field called GoalAccruedAmount to handle the Additional Amount Already Taken and goalBalanceAmount fields to handle the Balance field in the ADP Workforce Now UI.

So, to handle the Additional Amount Already Taken field in the ADP Workforce Now UI, the section should be as follows:

"deductionGoal": {"GoalAccruedAmount": {"AmountValue": 300}}

Suggested Workaround

There is no workaround available.

US1294444: Unable to retrieve the newly added Deduction Code with Deduction Frequency as OTO in the General Deduction Start/Change/Stop API meta response codelist

Impacted APIs

Method

URI

roleCode Value

GET

/events/payroll/v2/worker-general-deduction-instruction.start/meta

practitioner

POST

/events/payroll/v2/worker-general-deduction-instruction.start

practitioner

GET

/events/payroll/v2/worker-general-deduction-instruction.change/meta

practitioner

POST

/events/payroll/v2/worker-general-deduction-instruction.change

practitioner

GET

/events/payroll/v2/worker-general-deduction-instruction.stop/meta

practitioner

POST

/events/payroll/v2/worker-general-deduction-instruction.stop

practitioner

Issue Description

When a new deduction code of Post Tax Type is added with the deduction frequency of OTO in ADP Workforce Now, the newly added deduction code will not return in the General deduction start/change/stop API meta response codelist.

Suggested Work Around

The OTO effect could be achieved by starting a deduction then stopping the deduction after its being processed. A success processed deduction response contains the effective week and the Pay Date. Your application could use this data to stop the deduction.

US1168368: Retrieve additional data about deduction codes in meta

Impacted APIs

Method

URI

roleCode Value

GET

/events/payroll/v2/worker-general-deduction-instruction.start/meta

practitioner

GET

/events/payroll/v2/worker-general-deduction-instruction.change/meta

practitioner

GET

/events/payroll/v2/worker-general-deduction-instruction.stop/meta

practitioner

Issue Description

The following fields are not part of the codeList response for each deduction code as the value displayed in ADP Workforce Now within the table under Validation Tables > Payroll > Deductions and Deposits > Deductions:

  • Description
  • Category
  • Company Code
  • Deduction Frequency
  • Deduction Group
  • Accumulator (Yes vs. No)
  • Arrears (Yes vs. No)
  • Status (Inactive/Active)

Suggested Work Around

There is no workaround available.

US1395538: The goal ACCRUED, and ADJUSTMENT fields are not supported from the API

Impacted APIs

Method

URI

roleCode Value

GET

/events/payroll/v2/worker-general-deduction-instruction.start/meta

practitioner

POST

/events/payroll/v2/worker-general-deduction-instruction.start

practitioner

GET

/events/payroll/v2/worker-general-deduction-instruction.change/meta

practitioner

POST

/events/payroll/v2/worker-general-deduction-instruction.change

practitioner

Issue Description

Viewing and managing GOAL ACCRUED, and ADJUSTMENT are not supported from the API like an administrator could do in the ADP Workforce Now UI.

Suggested Work Around

There is no workaround available.

US1395551: You cannot update a Deduction Status to Inactive or Active from the API

Impacted APIs

Method

URI

roleCode Value

GET

/events/payroll/v2/worker-general-deduction-instruction.change/meta

practitioner

POST

/events/payroll/v2/worker-general-deduction-instruction.change

practitioner

Issue Description

The Deduction Instructions API cannot make a deduction status Active or Inactive. Only retrieve is possible through the payroll instruction GET API.

Suggested Workaround

You can make the deduction status Active or Inactive using the ADP Workforce Now UI.