WorkersTimeReviewEvents

Adds time review events for the specified worker.

Workday Resource Information

Creates a time review event for the specified worker. This endpoint is typically used by managers or administrators to submit time on behalf of workers, or by workers themselves to submit their own time for approval.

Specify these required fields in the request body:

* date: the date that constructs the Time Review Event. The date is used to create Time Review Events for the Period or Week, depending on how that worker's Time Entry Template is configured.

Additional optional field:

* comment: comment related to the business process that persists on each Time Review Event. Comments are not allowed if disabled on the Enter Time business process.

To get more information about Administrator-configured critical time validations, use the GET /timeValidations operation.

This operation is equivalent to the Submit Time task in the Workday UI. The same validations and business rules apply. This includes any configured approvals, notifications, and audit trails.

Sample Request:
```
{
"date": "2024-01-26",
"comment": "Submitting time for approval."
}
```

Secured by: Manager: Time Tracking Manager Approval, Manager: Time Tracking Manager Edit and Approve, Submit Time (REST Service)

Scope: Time Tracking, Time Tracking Hub

Aggregate Fields

The connector represents the following fields as aggregates containing JSON text. Each of them conforms to their respective schema. Fields marked with an asterisk are required and must be included if their parent object is. Fields marked with a hyphen are read-only and must not be included when calling stored procedures or when performing an INSERT or UPDATE.

This information is derived from the Workday REST API specification which does not explicitly list all business rules and validations that apply to each object. More fields may be required than what is listed here.

TimeReviewEvents_Aggregate

[{
  descriptor: Text /* The display name of the instance */
  id: Text /* Id of the instance */
  position: { /* Contains Position for Time Review Event if Independent Events for Multiple Jobs is enabled on the Time Entry Template. */
     -descriptor: Text /* The display name of the instance */
     -href: Text /* A link to the instance */
     *id: Text /* wid / id / reference id */
  }
  project: { /* Contains \~Project\~ for Time Review Event if Independent Events for \~Project\~ is enabled on the Time Entry Template. */
     -descriptor: Text /* The display name of the instance */
     -href: Text /* A link to the instance */
     *id: Text /* wid / id / reference id */
  }
  status: { /* Contains the current status of the business process.  For example: Successfully Completed, Denied, Terminated. */
     -descriptor: Text /* The display name of the instance */
     -href: Text /* A link to the instance */
     *id: Text /* wid / id / reference id */
  }
}]

Input


Name	Type	Description
Workers_Id	String	Unique identifier for the worker associated with the time review event.
Comment	String	The comment that persists on each time review event. Comments are not allowed if comments are disabled for the Enter Time business process or for all business processes in the tenant. For more information, see Reference: Edit Tenant Setup - Business Processes in the Admin Guide.
Date	Datetime	The date used to create the time review event. The date uses the format: yyyy-mm-dd. If Submit by Time Period is enabled on the worker's Time Entry Template as of the provided date, time is submitted for the pay period. Otherwise, time is submitted for the week.
TimeReviewEvents_Aggregate	String	Collection of time review events generated during the time submission request.

Result Set Columns