获取考勤日报表
接口说明: 根据日期获取对应的考勤日报表数据.注意数据不是实时的，每6个小时更新一次。
请求方式: POST（HTTPS)
请求地址: https://api.xinrenxinshi.com/v5/attendance/report/daily
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| date | String | Y | 日期。日期格式:yyyyMMdd；例如:20240401 |
| pageNo | Integer | N | 查询页码,最小值为0,翻页+1,未传时默认为0 |
| pageSize | Integer | N | 每页条目数,每页条目数不超过1000条,不小于1条,未传时默认100条 |
| timestamp | Integer | Y | 请求时间戳(精确到毫秒） |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 错误码枚举值,0:成功，其他值为失败 |
| errmsg | String | Y | 结果描述 |
| data | PageResult |
Y | 查询成功时返回分页报表数据 |
PageResult:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| totalPageSize | Long | Y | 总页数 |
| hasMore | Boolean | Y | 是否有下一页 true-有，false-没有 |
| pageNo | Integer | Y | 当前页 |
| pageSize | Integer | Y | 每页显示条数 |
| result | List<AttendanceDailyReportResult> | Y | 考勤日报表详情 |
AttendanceDailyReportResult:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeId | String | Y | 员工id |
| employeeName | String | Y | 员工姓名 |
| departmentId | String | Y | 部门ID |
| departmentName | String | Y | 部门名称 |
| shouldworkhour | Double | Y | 每日应出勤时长 |
| realondutyhour | Double | N | 每日实际出勤时长 |
| clockon | String | Y | 首次打卡时间 |
| clockout | String | Y | 末次打卡时间 |
| latenum | Integer | Y | 迟到次数 |
| earlynum | Integer | Y | 早退次数 |
| lacknumsum | Integer | N | 缺卡次数 |
| vbdknum | Integer | Y | 有效补卡次数 |
| dtype | String | N | 日期类型 |
| operateDate | String | Y | 日期 |
| shiftsName | String | Y | 班次名称 |
| costLabel | String | Y | 方案标签 |
| clockHour | Double | N | 打卡时长 |
| realWorkHour | Double | N | 工作日时长 |
| restHour | Double | N | 休息时长 |
| lateMinute | Double | N | 迟到分钟 |
| earlyMinute | Double | N | 早退分钟 |
| absent | Double | N | 旷工(小时) |
| lackClockNum | Double | N | 漏卡次数-指当前报表的【缺卡次数】 |
| bdkNum | Integer | N | 补卡次数 |
| lackNumOn | Integer | N | 上班缺卡数（新） |
| lackNumOff | Integer | N | 下班缺卡数（新） |
| lackNumSum | Integer | N | 缺卡次数（新） |
| onocHour | Double | N | 加班时长(无补偿) |
| opayHour | Double | N | 加班时长(加班费) |
| orestHour | Double | N | 加班时长(调休) |
| oHour | Double | N | 加班总时长 |
| outWork | Double | N | 外勤（天） |
| outWorkHour | Double | N | 外勤（小时） |
| outh | Double | N | 外出(天) |
| out | Double | N | 外出（小时） |
| trip | Double | N | 出差(天) |
| tripHour | Double | N | 出差（小时） |
| homeWork | Double | N | 居家办公（天） |
| homeWorkHour | Double | N | 居家办公（小时） |
| holidayTypeOneDay | Double | N | 年假(天) |
| holidayTypeOneHour | Double | N | 年假(小时) |
| holidayTypeTwoDay | Double | N | 事假(天) |
| holidayTypeTwoHour | Double | N | 事假(小时) |
| holidayTypeThreeDay | Double | N | 病假(天) |
| holidayTypeThreeHour | Double | N | 病假(小时) |
| holidayTypeFourDay | Double | N | 婚假(天) |
| holidayTypeFourHour | Double | N | 婚假(小时) |
| holidayTypeFiveDay | Double | N | 丧假(天) |
| holidayTypeFiveHour | Double | N | 丧假(小时) |
| holidayTypeSixDay | Double | N | 产假(天) |
| holidayTypeSixHour | Double | N | 产假(小时) |
| holidayTypeSevenDay | Double | N | 奖励产假(天) |
| holidayTypeSevenHour | Double | N | 奖励产假(小时) |
| holidayTypeEightDay | Double | N | 陪产假(天) |
| holidayTypeEightHour | Double | N | 陪产假(小时) |
| holidayTypeNineDay | Double | N | 探亲假(天) |
| holidayTypeNineHour | Double | N | 探亲假(小时) |
| holidayTypeTenDay | Double | N | 工伤假(天) |
| holidayTypeTenHour | Double | N | 工伤假(小时) |
| holidayTypeElevenDay | Double | N | 调休(天) |
| holidayTypeElevenHour | Double | N | 调休(小时) |
| holidayTypeTwelveDay | Double | N | 产检假(天) |
| holidayTypeTwelveHour | Double | N | 产检假(小时) |
| holidayTypeThirteenDay | Double | N | 流产假(天) |
| holidayTypeThirteenHour | Double | N | 流产假(小时) |
| holidayTypeFortyDay | Double | N | 哺乳假(天) |
| holidayTypeFortyHour | Double | N | 哺乳假(小时) |
| holidayTypeNnDay | Double | N | 长期病假(天) |
| holidayTypeNnHour | Double | N | 长期病假(小时) |
| holidayHourSum | String | N | 请假总时长(小时) |
| holidaySum | String | N | 请假总时长(天) |
Tips:
- 返回的报表数据不是实时的，每6个小时更新一次。
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/attendance/report/daily?sign=tAMMvw%2FiNEMLd3jf4i6U510aZ1c%3D
请求Body示例:
{
"date": "20240724",
"pageNo": 0,
"pageSize": 4,
"timestamp": 1721893745730
}
SDK请求示例(java):
AttendanceDailyReportRequest request = new AttendanceDailyReportRequest(access_token());
request.setDate("20240724");
request.setPageNo(0);
request.setPageSize(4);
OpenapiResponse<PageResult<AttendanceDailyReportResult>> dailyReport = XrxsAttendanceService.getDailyReport(request);
响应示例
{
"errcode": 0,
"errmsg": "成功",
"data": {
"totalPageSize": 2,
"pageNo": 0,
"pageSize": 4,
"result": [
{
"employeeId": "27d9b61cd1ab4c4889eaad2c028d3c65",
"employeeName": "GPA / Result",
"departmentId": "be8a8e9e060a45198ec4213b62aea95c",
"departmentName": "绩效通知1",
"shouldworkhour": 7.0,
"realondutyhour": 0.0,
"clockon": "",
"clockout": "",
"latenum": 0,
"earlynum": 0,
"lacknumsum": 0,
"vbdknum": 0,
"dtype": "工作日",
"operateDate": "20240724",
"shiftsName": "默认班次-实际工作日考勤方案（09:00~18:00）",
"costLabel": "{}",
"clockHour": 0.0,
"realWorkHour": 0.0,
"restHour": 2.0,
"lateMinute": 0.0,
"earlyMinute": 0.0,
"absent": 7.0,
"lackClockNum": 2,
"bdkNum": 0,
"lackNumOn": null,
"lackNumOff": null,
"onocHour": 0.0,
"opayHour": 0.0,
"orestHour": 0.0,
"outWork": 0.0,
"outWorkHour": null,
"outh": 0.0,
"out": null,
"trip": 0.0,
"tripHour": null,
"homeWork": null,
"homeWorkHour": null,
"holidayTypeOneDay": null,
"holidayTypeOneHour": null,
"holidayTypeTwoDay": null,
"holidayTypeTwoHour": null,
"holidayTypeThreeDay": null,
"holidayTypeThreeHour": null,
"holidayTypeFourDay": null,
"holidayTypeFourHour": null,
"holidayTypeFiveDay": null,
"holidayTypeFiveHour": null,
"holidayTypeSixDay": null,
"holidayTypeSixHour": null,
"holidayTypeSevenDay": null,
"holidayTypeSevenHour": null,
"holidayTypeEightDay": null,
"holidayTypeEightHour": null,
"holidayTypeNineDay": null,
"holidayTypeNineHour": null,
"holidayTypeTenDay": null,
"holidayTypeTenHour": null,
"holidayTypeElevenDay": null,
"holidayTypeElevenHour": null,
"holidayTypeTwelveDay": null,
"holidayTypeTwelveHour": null,
"holidayTypeThirteenDay": null,
"holidayTypeThirteenHour": null,
"holidayTypeFortyDay": null,
"holidayTypeFortyHour": null,
"holidayTypeNnDay": null,
"holidayTypeNnHour": null,
"holidayHourSum": "0.0",
"holidaySum": "0.0",
"ohour": 0.0
},
{
"employeeId": "2d0009fc99f6435e8a954d8b77840540",
"employeeName": "牛的很",
"departmentId": "be8a8e9e060a45198ec4213b62aea95c",
"departmentName": "绩效通知1",
"shouldworkhour": 7.0,
"realondutyhour": 0.0,
"clockon": "",
"clockout": "",
"latenum": 0,
"earlynum": 0,
"lacknumsum": 0,
"vbdknum": 0,
"dtype": "工作日",
"operateDate": "20240724",
"shiftsName": "默认班次-实际工作日考勤方案（09:00~18:00）",
"costLabel": "{}",
"clockHour": 0.0,
"realWorkHour": 0.0,
"restHour": 2.0,
"lateMinute": 0.0,
"earlyMinute": 0.0,
"absent": 7.0,
"lackClockNum": 2,
"bdkNum": 0,
"lackNumOn": null,
"lackNumOff": null,
"onocHour": 0.0,
"opayHour": 0.0,
"orestHour": 0.0,
"outWork": 0.0,
"outWorkHour": null,
"outh": 0.0,
"out": null,
"trip": 0.0,
"tripHour": null,
"homeWork": null,
"homeWorkHour": null,
"holidayTypeOneDay": null,
"holidayTypeOneHour": null,
"holidayTypeTwoDay": null,
"holidayTypeTwoHour": null,
"holidayTypeThreeDay": null,
"holidayTypeThreeHour": null,
"holidayTypeFourDay": null,
"holidayTypeFourHour": null,
"holidayTypeFiveDay": null,
"holidayTypeFiveHour": null,
"holidayTypeSixDay": null,
"holidayTypeSixHour": null,
"holidayTypeSevenDay": null,
"holidayTypeSevenHour": null,
"holidayTypeEightDay": null,
"holidayTypeEightHour": null,
"holidayTypeNineDay": null,
"holidayTypeNineHour": null,
"holidayTypeTenDay": null,
"holidayTypeTenHour": null,
"holidayTypeElevenDay": null,
"holidayTypeElevenHour": null,
"holidayTypeTwelveDay": null,
"holidayTypeTwelveHour": null,
"holidayTypeThirteenDay": null,
"holidayTypeThirteenHour": null,
"holidayTypeFortyDay": null,
"holidayTypeFortyHour": null,
"holidayTypeNnDay": null,
"holidayTypeNnHour": null,
"holidayHourSum": "0.0",
"holidaySum": "0.0",
"ohour": 0.0
},
{
"employeeId": "a0c81bee9fb24778a7a4e4df5a7f30c0",
"employeeName": "测试",
"departmentId": "b83e48ca3a294c5e8d8a98ca80e4be47",
"departmentName": "一级部门",
"shouldworkhour": 7.0,
"realondutyhour": 0.0,
"clockon": "",
"clockout": "",
"latenum": 0,
"earlynum": 0,
"lacknumsum": 0,
"vbdknum": 0,
"dtype": "工作日",
"operateDate": "20240724",
"shiftsName": "默认班次-实际工作日考勤方案（09:00~18:00）",
"costLabel": "{}",
"clockHour": 0.0,
"realWorkHour": 0.0,
"restHour": 2.0,
"lateMinute": 0.0,
"earlyMinute": 0.0,
"absent": 7.0,
"lackClockNum": 2,
"bdkNum": 0,
"lackNumOn": null,
"lackNumOff": null,
"onocHour": 0.0,
"opayHour": 0.0,
"orestHour": 0.0,
"outWork": 0.0,
"outWorkHour": null,
"outh": 0.0,
"out": null,
"trip": 0.0,
"tripHour": null,
"homeWork": null,
"homeWorkHour": null,
"holidayTypeOneDay": null,
"holidayTypeOneHour": null,
"holidayTypeTwoDay": null,
"holidayTypeTwoHour": null,
"holidayTypeThreeDay": null,
"holidayTypeThreeHour": null,
"holidayTypeFourDay": null,
"holidayTypeFourHour": null,
"holidayTypeFiveDay": null,
"holidayTypeFiveHour": null,
"holidayTypeSixDay": null,
"holidayTypeSixHour": null,
"holidayTypeSevenDay": null,
"holidayTypeSevenHour": null,
"holidayTypeEightDay": null,
"holidayTypeEightHour": null,
"holidayTypeNineDay": null,
"holidayTypeNineHour": null,
"holidayTypeTenDay": null,
"holidayTypeTenHour": null,
"holidayTypeElevenDay": null,
"holidayTypeElevenHour": null,
"holidayTypeTwelveDay": null,
"holidayTypeTwelveHour": null,
"holidayTypeThirteenDay": null,
"holidayTypeThirteenHour": null,
"holidayTypeFortyDay": null,
"holidayTypeFortyHour": null,
"holidayTypeNnDay": null,
"holidayTypeNnHour": null,
"holidayHourSum": "0.0",
"holidaySum": "0.0",
"ohour": 0.0
},
{
"employeeId": "fba50ac0ee284ee8914969028e7182dc",
"employeeName": "Photoshop",
"departmentId": "b83e48ca3a294c5e8d8a98ca80e4be47",
"departmentName": "一级部门",
"shouldworkhour": 7.0,
"realondutyhour": 0.0,
"clockon": "",
"clockout": "",
"latenum": 0,
"earlynum": 0,
"lacknumsum": 0,
"vbdknum": 0,
"dtype": "工作日",
"operateDate": "20240724",
"shiftsName": "默认班次-实际工作日考勤方案（09:00~18:00）",
"costLabel": "{}",
"clockHour": 0.0,
"realWorkHour": 0.0,
"restHour": 2.0,
"lateMinute": 0.0,
"earlyMinute": 0.0,
"absent": 7.0,
"lackClockNum": 2,
"bdkNum": 0,
"lackNumOn": null,
"lackNumOff": null,
"onocHour": 0.0,
"opayHour": 0.0,
"orestHour": 0.0,
"outWork": 0.0,
"outWorkHour": null,
"outh": 0.0,
"out": null,
"trip": 0.0,
"tripHour": null,
"homeWork": null,
"homeWorkHour": null,
"holidayTypeOneDay": null,
"holidayTypeOneHour": null,
"holidayTypeTwoDay": null,
"holidayTypeTwoHour": null,
"holidayTypeThreeDay": null,
"holidayTypeThreeHour": null,
"holidayTypeFourDay": null,
"holidayTypeFourHour": null,
"holidayTypeFiveDay": null,
"holidayTypeFiveHour": null,
"holidayTypeSixDay": null,
"holidayTypeSixHour": null,
"holidayTypeSevenDay": null,
"holidayTypeSevenHour": null,
"holidayTypeEightDay": null,
"holidayTypeEightHour": null,
"holidayTypeNineDay": null,
"holidayTypeNineHour": null,
"holidayTypeTenDay": null,
"holidayTypeTenHour": null,
"holidayTypeElevenDay": null,
"holidayTypeElevenHour": null,
"holidayTypeTwelveDay": null,
"holidayTypeTwelveHour": null,
"holidayTypeThirteenDay": null,
"holidayTypeThirteenHour": null,
"holidayTypeFortyDay": null,
"holidayTypeFortyHour": null,
"holidayTypeNnDay": null,
"holidayTypeNnHour": null,
"holidayHourSum": "0.0",
"holidaySum": "0.0",
"ohour": 0.0
}
],
"hasMore": true
}
}