考勤排班信息
接口说明：获取员工考勤排班信息
请求方式： POST(HTTPS)
请求路径：https://api.xinrenxinshi.com/v4/attendance/scheduling
请求header：
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
参数说明：
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeIds | String | Y | 员工id，多个逗号分隔 |
| date | String | Y | 排班日期，日期格式：yyyy-MM-dd |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
| sign | String | Y | 请求参数签名 |
返回结果：
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 结果描述 |
| data | ClockSchedulingData | N | 排班信息 |
ClockSchedulingData
| 参数 | 类型 | 必传(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 |
| restStartTime | String | N | 午休开始时间，格式：HH:mm |
| restEndTime | 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 | 最早签到归属日 |
| clockStartEarliestTime | String | Y | 最早签到时间 |
| clockEndLatestBelong | Integer | Y | 最晚签到归属日 |
| clockEndLatestTime | String | Y | 最晚签到时间 |
EmployeeScheduling
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeId | String | Y | 员工ID |
| planId | Integer | Y | 方案ID |
| schedulingId | Integer | Y | 排班ID |
响应样例：
{
"errcode": "0",
"errmsg": "成功",
"data": {
"clockPlainDetails": [
{
"planId": "183121",
"planName": "测试排班",
"clockSettingDetails": [
{
"restStartTime": "",
"isClocking": "1",
"startingtime": "09:00",
"closingtime": "18:00",
"clockTimeRanges": [
{
"closingTime": "12:00",
"startingTime": "09:00",
"clockStartTime": "",
"clockEndTime": "12:30",
"seqId": "1"
},
{
"closingTime": "18:00",
"startingTime": "14:00",
"clockStartTime": "13:00",
"clockEndTime": "",
"seqId": "2"
}
],
"flexTime": "10",
"flex": "true",
"restEndTime": "",
"attendancePlanId": "183121",
"releasedTime": "0",
"name": "班次1",
"id": "241334",
"released": "false"
}
]
}
],
"employeeSchedulings": [
{
"employeeId": "4599e2fd3f9e4461bba9680e127cffaf",
"planId": "183121",
"schedulingId": "241334"
}
]
}
}