employee working time

An employee's contractual working time and working pattern can be stored against the employment record. These end points allow for the querying and updating of working time records as held against an employee record

Get employee working time

SecuritybearerAuth

Request

path Parameters

id

required

string <guid>

Employee ID

Example: 906264f1-2dff-4f72-a10b-59918cf738d7

Responses

200

Employee work patterns array

400

Bad Request

401

Unauthorized - Authorization Required

404

Not Found

422

Unprocessable Entity

default

General Error

get/Employee/{id}/WorkingTimes

Request samples

curl
C#
Java
PHP

Response samples

application/vnd.api+json

{"links": {"self": "https://integrations.cintra.cloud/integrations/00000000-0000-0000-0000-000000000000/employeeworkingtime"
},
"data": [{"id": "a0bc1ba8-063e-c1fd-3e8f-6b5951f33e03",
"type": "employeeworkingTimes",
"attributes": {"fromDate": "2022-11-17",
"toDate": "2023-11-17",
"fteFactor": 0.666666,
"contractHoursPerWeek": 20,
"contractDaysPerWeek": 3,
"contractWeeksPerAnnum": 26
}
}
]
}

Add employee working time

SecuritybearerAuth

Request

path Parameters

id

required

string <guid>

Employee ID

Example: 906264f1-2dff-4f72-a10b-59918cf738d7

Request Body schema: application/vnd.api+json

Post or patch employee working time

One of:

object

Responses

200

Employee work patterns

400

Bad Request

401

Unauthorized - Authorization Required

422

Unprocessable Entity

default

General Error

post/Employee/{id}/WorkingTimes

Request samples

Payload
curl
C#
Java
PHP

application/vnd.api+json

{"data": {"type": "employeeWorkingTimes",
"attributes": {"fromDate": "2022-11-17",
"toDate": "2023-11-17",
"fteFactor": 0.666666,
"contractHoursPerWeek": 20,
"contractDaysPerWeek": 3,
"contractWeeksPerAnnum": 26
},
"relationships": [null
]
}
}

Response samples

200
400
401
422
default

application/vnd.api+json

{"links": {"self": "https://integrations.cintra.cloud/integrations/00000000-0000-0000-0000-000000000000/employeeworkingtime/{id}"
},
"data": {"0": {"id": "a0bc1ba8-063e-c1fd-3e8f-6b5951f33e03"
},
"type": "employeeworkingTimes",
"attributes": {"fromDate": "2022-11-17",
"toDate": "2023-11-17",
"fteFactor": 0.666666,
"contractHoursPerWeek": 20,
"contractDaysPerWeek": 3,
"contractWeeksPerAnnum": 26
},
"id": "a0bc1ba8-063e-c1fd-3e8f-6b5951f33e03"
}
}

Get employee working time by Id

SecuritybearerAuth

Request

path Parameters

empId required	string <guid> Employee ID Example: 906264f1-2dff-4f72-a10b-59918cf738d7
id required	string <guid> Working Times ID Example: 93b28927-49d4-49ec-b439-faa79d6e7aa8

Responses

200

Employee work patterns

400

Bad Request

401

Unauthorized - Authorization Required

404

Not Found

422

Unprocessable Entity

default

General Error

get/Employee/{empId}/WorkingTimes/{id}

Request samples

curl
C#
Java
PHP

Response samples

application/vnd.api+json

{"links": {"self": "https://integrations.cintra.cloud/integrations/00000000-0000-0000-0000-000000000000/employeeworkingtime/{id}"
},
"data": {"0": {"id": "a0bc1ba8-063e-c1fd-3e8f-6b5951f33e03"
},
"type": "employeeworkingTimes",
"attributes": {"fromDate": "2022-11-17",
"toDate": "2023-11-17",
"fteFactor": 0.666666,
"contractHoursPerWeek": 20,
"contractDaysPerWeek": 3,
"contractWeeksPerAnnum": 26
},
"id": "a0bc1ba8-063e-c1fd-3e8f-6b5951f33e03"
}
}

Update employee working time

SecuritybearerAuth

Request

path Parameters

empId required	string <guid> Employee ID Example: 906264f1-2dff-4f72-a10b-59918cf738d7
id required	string <guid> Working Times ID Example: 93b28927-49d4-49ec-b439-faa79d6e7aa8

Request Body schema: application/vnd.api+json

Update employee working time

One of:

object

Responses

200

employee FTE work patterns

400

Bad Request

401

Unauthorized - Authorization Required

404

Not Found

422

Unprocessable Entity

default

General Error

patch/Employee/{empId}/WorkingTimes/{id}

Request samples

Payload
curl
C#
Java
PHP

application/vnd.api+json

{"data": {"type": "employeeWorkingTimes",
"attributes": {"fromDate": "2022-11-17",
"toDate": "2023-11-17",
"fteFactor": 0.666666,
"contractHoursPerWeek": 20,
"contractDaysPerWeek": 3,
"contractWeeksPerAnnum": 26
},
"relationships": [null
],
"id": "906264f1-2dff-4f72-a10b-59918cf738d7"
}
}

Response samples

application/vnd.api+json

{"links": {"self": "https://integrations.cintra.cloud/integrations/00000000-0000-0000-0000-000000000000/employeeworkingtime/{id}"
},
"data": {"0": {"id": "a0bc1ba8-063e-c1fd-3e8f-6b5951f33e03"
},
"type": "employeeworkingTimes",
"attributes": {"fromDate": "2022-11-17",
"toDate": "2023-11-17",
"fteFactor": 0.666666,
"contractHoursPerWeek": 20,
"contractDaysPerWeek": 3,
"contractWeeksPerAnnum": 26
},
"id": "a0bc1ba8-063e-c1fd-3e8f-6b5951f33e03"
}
}