Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Status
colourGreen
title3.17.0

The Timecard REST API is used to retrieve all of the time entry records of a specific timecard period for a given work center. The REST API is also used to change the status of a timecard for a specific user.

The TimeCardID is in the format of yyyyww where yyyy represents the 4 digit year and ww represents the current week of the year left padded with zeros. e.g. The TimeCardID for the first week of 2016 would be 201601.

Panel
borderColorgrey
bgColorwhitesmoke

On this page:

Table of Contents
maxLevel2

Related pages:

Resource URL Summary

Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

Retrieve a list of Time Card records for a specific Work Center

GET /seiapi/v3/Timecard/${TimecardID}?workcenter=${WorkcenterID}

Retrieve a list of Time Card records that have a specific Status for a specific Work Center

GET /seiapi/v3/Timecard/${TimecardID}?workcenter=${WorkCenterID}&status=${StatusID}

Insert or Update the status of a Time Card for a specific User

PUT /seiapi/v3/Timecard/status/${TimecardID}?userid=${UserID}

Insert or Update the status of a Time Card for a group of Users

PUT /seiapi/v3/Timecard/status/${TimecardID}

URL Parameters

ParameterDescription
${StatusID}

Specifies the status of the timecard.

Valid values are controlled by the Time Card Status system category

${TimecardID}

Identifies the specific timecard
${UserID}Identifies the User Object.
${WorkCenterID}Identifies the REST Object Definitions Account Location Related Objects Work Center Object.

Include Page
_URI Default HTTP Headers
_URI Default HTTP Headers

 


API Specifics

Panel
borderColor#D3D3D3

Retrieve a list of Time Card records for a specific Work Center

This API will return a list of all of the Time Card records for all Users for the Work Center with the specified ID, from the system. The Work Center with the specified ID must already exist in the system.

URL

Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

 GET /seiapi/v3/Timecard/${TimecardID}?workcenter=${WorkcenterID}

HTTP Request Body

This request does not require a request body. 

HTTP Response Body

On success, HTTP response code of 200 will be returned, and the response body will contain a JSON array of Time Entry Objects.

(warning) It is possible for the returned array to be empty if there are no matching records.

Code Block
languagejs
[
	{
		// Time Entry Object
	},
		.
		.
]
Panel
borderColor#D3D3D3

Retrieve a list of Time Card records that have a specific Status for a specific Work Center

This API will return all of the individual time entry records for all users of the specified work center that have the specified status. This is API can be used to return all approved time cards or to report on time cards that are still open (have not been submitted by the mobile worker).  If there are no matching records then an empty array will be returned (e.g. [ ]).

URL

Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

GET /seiapi/v3/Timecard/${TimecardID}?workcenter=${WorkcenterID}&status=${statusID}

HTTP Request Body

This request does not require a request body. 

HTTP Response Body

On success, HTTP response code of 200, this API will return a JSON array of Time Entry Objects

Code Block
languagejs
[
	{
		// Time Entry Object
	},
		.
		.
]
Panel
borderColor#D3D3D3

Insert or Update the status of a Time Card for a specific User

This API will update the status of a timecard for a specific user. Any status changes will automatically be sent to the mobile worker.

URL

Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

PUT /seiapi/v3/Timecard/status/${TimecardID}?userid=${UserID}

HTTP Request Body

The request body must contain a valid REST Object Definitions Time Entry Related Objects Timecard Status Object

Include Page
_Timecard Status Object Formats
_Timecard Status Object Formats

HTTP Response

On success an HTTP response code of 200 will be returned. 

Panel
borderColor#D3D3D3

Insert or Update the status of a Time Card for a group of Users

This API will update the status of a timecard for a group of mobile workers. The HTTP request body must include the Users property, which is an array containing a list of user IDs to be updated. 

Status changes will automatically be sent to the mobile worker.

URL

Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

PUT /seiapi/v3/Timecard/status/${TimecardID}

HTTP Request Body

The request body must contain a valid REST Object Definitions Time Entry Related Objects Timecard Status Object

(warning) The Users property of the Timecard Status object must be populated with the list of user IDs to be updated. 

Include Page
_Timecard Status Object Formats
_Timecard Status Object Formats

HTTP Response

On success an HTTP response code of 200 will be returned.