Dayforce RESTful services use the PATCH verb to update employee pay adjustments.
Overview
The URL for PATCH operations uses the base URL and pay adjustment XRefCode:
https://www.dayforcehcm.com/api/CompanyName/V1/EmployeePayAdjustments/[xRefCode]
The XRefCode must be included in the request URL because Dayforce web services assumes the requester means to update an existing pay adjustment when PATCH is used. The XRefCode doesn’t need to be included in the request body. If included in the request body, the XRefCode must match the XRefCode in the request URL.
The request body needs to include the data entities and elements that need to be inserted or updated only. The request doesn't need to include values for all of the information available in the employee pay adjustment data model.
Additionally, you assume the responsibility for committing data to your instance of Dayforce web services. If data isn’t to be committed (for example, test data in a production instance), you must send the request using the parameter and value IsValidateOnly=true.
Important: This request modifies existing data in Dayforce. When using this request, be sure that the consuming application/requester is using the correct instance of Dayforce (for example, Test or Production). Watch out for inadvertently modifying the wrong Dayforce instance (for example, test data in a production instance).
Parameters
IsValidateOnly (boolean)
- Used to specify that all of the validations need to be performed without committing any changes.
- Using this parameter to control whether committing information to your instance of Dayforce is your responsibility.
- The URL syntax is: https://www.dayforcehcm.com/api/CompanyName/V1/EmployeePayAdjustments/[XRefCode]?isValidateOnly=true
Security
Patching an existing employee pay adjustments requires this role to be assigned the HCM Anywhere > Web Services > Patch/Post Pay Adjustment role feature in the Features tab of System Admin > Roles. See the Dayforce Web Services Configuration Guide.