考勤排班信息
接口说明: 获取员工考勤排班信息
请求方式: POST(HTTPS)
请求路径:https://api.xinrenxinshi.com/v5/attendance/scheduling
请求header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeIds | List<String> | Y | 员工id |
| date | String | Y | 排班日期，日期格式:yyyy-MM-dd |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 结果描述 |
| data | AttendanceScheduleInfo | N | 排班信息 |
AttendanceScheduleInfo
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| clockPlainDetails | List<ClockPlainDetail> | Y | 排班方案信息 |
| employeeSchedulings | List<EmployeeScheduling> | Y | 员工排班信息 |
ClockPlainDetail
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| planId | Integer | Y | 方案ID |
| planName | String | Y | 方案名称 |
| clockSettingDetails | List<ClockSettingDetail> | Y | 排班列表 |
ClockSettingDetail
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| id | Integer | Y | 班次ID |
| attendancePlanId | Integer | Y | 方案ID |
| name | String | Y | 班次名称 |
| startingTime | String | N | 打卡开始时间，格式:HH:mm |
| closingTime | String | N | 打卡结束时间，格式:HH:mm |
| released | boolean | Y | 豁免开关 |
| releasedTime | Integer | Y | 豁免时间，单位:分钟 |
| flex | boolean | Y | 弹性开关 |
| flexTime | Integer | Y | 弹性时间，单位:分钟 |
| isClocking | Integer | Y | 打卡方式，0:不打卡，1:一天两卡，2:一天4卡 |
| clockTimeRanges | List<ClockTimeRange> | N | 排班打卡信息列表 |
ClockTimeRange
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| seqId | Integer | Y | 时间段序号 |
| clockStartTime | String | Y | 开始最早打卡时间，格式:HH:mm |
| clockEndTime | String | N | 打卡最晚时间，格式:HH:mm |
| clockStartEarliestBelong | Integer | Y | 上班卡开始时间的所属日期 -1: 前一天 0:当天 1:次日 |
| clockStartEarliestTime | String | Y | 上班卡开始时间 |
| clockStartLatestBelong | Integer | Y | 上班卡结束时间的所属日期 -1: 前一天 0:当天 1:次日 |
| clockStartLatestTime | String | Y | 上班卡结束时间 |
| clockEndEarliestBelong | Integer | Y | 下班卡开始时间的所属日期 -1: 前一天 0:当天 1:次日 |
| clockEndEarliestTime | String | Y | 下班卡开始时间 |
| clockEndLatestBelong | Integer | Y | 下班卡结束时间的所属日期 -1: 前一天 0:当天 1:次日 |
| clockEndLatestTime | String | Y | 下班卡结束时间 |
| clockStartExempt | Integer | N | 上班豁免是否开启 0-关闭 1-开启 |
| clockStartExemptTime | Integer | N | 上班豁免时间（分钟） |
| clockEndExempt | Integer | N | 下班豁免开关 0-关闭 1-开启 |
| clockEndExemptTime | Integer | N | 下班豁免时间（分钟） |
| restTimeRangs | List<RestTimeRange> | N | 休息时间 |
RestTimeRange
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| restStartTime | String | Y | 休息开始时间，格式:HH:mm |
| restEndTime | String | Y | 休息结束时间，格式:HH:mm |
EmployeeScheduling
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeId | String | Y | 员工ID |
| planId | Integer | Y | 方案ID |
| schedulingId | Integer | Y | 排班ID |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/attendance/scheduling?sign=0IMp6jFPjptcZu0rFcjqsLSK3F4%3D
请求Body示例:
{
"date": "2020-11-24",
"employeeIds": [
"3cfd59661b0642659f12eb8c75ad0f18",
"04577f3277f841248f17d36e2561f642"
],
"timestamp": 1606706970446
}
SDK请求示例(java):
AttendanceSchedulingRequest request = new AttendanceSchedulingRequest(access_token());
request.setEmployeeIds(Arrays.asList("3cfd59661b0642659f12eb8c75ad0f18", "04577f3277f841248f17d36e2561f642"));
request.setDate("2020-11-24");
OpenapiResponse<AttendanceScheduleInfo> scheduling = XrxsAttendanceService.scheduling(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"clockPlainDetails": [
{
"planId": 195635,
"planName": "实际工作日考勤方案",
"clockSettingDetails": [
{
"id": 257092,
"attendancePlanId": 195635,
"name": "默认班次-实际工作日考勤方案",
"startingTime": "09:00",
"closingTime": "18:00",
"restStartTime": null,
"restEndTime": null,
"released": true,
"releasedTime": 0,
"flex": false,
"flexTime": 0,
"isClocking": 2,
"clockTimeRanges": [
{
"seqId": 1,
"clockStartTime": "09:00",
"clockEndTime": "18:00",
"clockStartEarliestBelong": -1,
"clockStartEarliestTime": "22:00",
"clockStartLatestBelong": 0,
"clockStartLatestTime": "17:59",
"clockEndEarliestBelong": 1,
"clockEndEarliestTime": "09:00",
"clockEndLatestBelong": 1,
"clockEndLatestTime": "03:59",
"clockStartExempt": 0,
"clockStartExemptTime": 0,
"clockEndExempt": 0,
"clockEndExemptTime": 0,
"restTimeRangs": [
{
"restStartTime": "12:00",
"restEndTime": "14:00"
}
]
}
]
}
]
}
],
"employeeSchedulings": [
{
"employeeId": "3cfd59661b0642659f12eb8c75ad0f18",
"planId": 195635,
"schedulingId": 257092
}
]
}
}