PATCH Employee Punches

Dayforce RESTful Web Services Developer Guide

Version
R2025.2.1
PATCH Employee Punches

This PATCH operation updates an employee time entry. The operation uses the following URL:

            https://www.dayforcehcm.com/api/CompanyName/V1/EmployeePunches/{xRefCode}
        

Role feature access: HCM Anywhere > Web Services > Patch/Post/Delete Employee Time Entry

Parameters

PATCH Employee Punches parameters
Parameter Description
xRefCode The XRefCode of the time entry that you want to update.
isValidateOnly

This parameter is used to specify that all of the validations need to be performed without committing any changes. Use this parameter to control whether committing information in your Dayforce instance is your responsibility.

The URL syntax is:

https://www.dayforcehcm.com/api/CompanyName/V1/EmployeePunches/{xRefCode}?isValidateOnly=true

Request Body

The request body contains the data entities and elements that need to be processed within a structure that can be interpreted by Dayforce web services. The example below shows all of the possible fields in the correct JSON format:

Copy
{
  "PunchXRefCode": "string",
  "EmployeeXRefCode": "string",
  "TimeStart": "2025-02-20T21:52:34.798Z",
  "TimeEnd": "2025-02-20T21:52:34.798Z",
  "DeptJobXRefCode": "string",
  "OrgUnitXRefCode": "string",
  "PayAdjustCodeXRefCode": "string",
  "ProjectXRefCode": "string",
  "DocketXRefCode": "string",
  "Quantity": 0,
  "EmployeeAuthorized": true,
  "ManagerAuthorized": true,
  "MealBreaks": [
    {
      "MealBreakType": "string",
      "TimeStart": "2025-02-20T21:52:34.798Z",
      "TimeEnd": "2025-02-20T21:52:34.798Z"
    }
  ],
  "Transfers": [
    {
      "TimeStart": "2025-02-20T21:52:34.798Z",
      "DeptJobXRefCode": "string",
      "OrgUnitXRefCode": "string",
      "PayAdjustCodeXRefCode": "string",
      "ProjectXRefCode": "string",
      "DocketXRefCode": "string",
      "Quantity": 0,
      "TransferLaborMetrics": [
        {
          "LaborMetricsTypeXRefCode": "string",
          "LaborMetricsCodeXRefCode": "string"
        }
      ]
    }
  ],
  "PunchLaborMetrics": [
    {
      "LaborMetricsTypeXRefCode": "string",
      "LaborMetricsCodeXRefCode": "string"
    }
  ]
}