1. 个人考勤报表统计
个人考勤报表统计
1.1. 个人日考勤统计
基础信息
路径: /v1/api/attendance/person/statistic/day/list
请求方法: POST
请求参数
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
Content-Type | application/json | 是 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
personName | string | 否 | 人名 | |
personUuidList | array | 否 | 人UUID集合 | |
|─ | string | |||
orgUuidList | array | 否 | 部门UUID集合 | |
|─ | string | |||
startTime | string | 是 | 查询开始时间 | |
endTime | string | 是 | 查询结束时间 | |
pageNum | integer | 否 | 1 | 页码,从1开始 当前页码,不传默认1 |
pageSize | integer | 否 | 20 | 页面大小 分页大小,不传默认20 |
Body示例:
{
"startTime": "2023-06-20",
"endTime": "2023-07-07",
"personUuidList": [
"c614b142bf164730a6e1a7626ba40408"
],
"type": 2,
"orgUuidList": [],
"pageSize": 10,
"pageNum": 1
}
返回数据
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
content-type | application/json;charset=UTF-8 | 否 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
code | integer | 否 | 返回值code | |
msg | string | 否 | 返回值消息 | |
data | object | 否 | 具体的返回值 | |
|─pageNum | integer | 是 | 页码,从1开始 当前页码 |
|
|─pageSize | integer | 是 | 页面大小 分页大小 |
|
|─total | integer | 是 | 总记录数 总数 |
|
|─list | array | 否 | ||
|─ | object | |||
|─personName | string | 否 | 人员姓名 | |
|─personCode | string | 否 | 人员编号 | |
|─orgUuid | string | 否 | 部门UUID | |
|─orgName | string | 否 | 部门名称 | |
|─attendanceDate | string | 否 | 考勤日期 | |
|─status | integer | 否 | 考勤状态 | |
|─shiftUuid | string | 否 | 班次UUID | |
|─shiftName | string | 否 | 班次名 | |
|─requireTime | integer | 否 | 应到时长,单位分钟 | |
|─workTime | integer | 否 | 实到时长,单位分钟 | |
|─earlyTime | integer | 否 | 早退时长,单位分钟 | |
|─lateTime | integer | 否 | 迟到时长,单位分钟 | |
|─overTime | integer | 否 | 加班时长,单位分钟 | |
|─absentTime | integer | 否 | 旷工时长,单位分钟 | |
|─toilTime | integer | 否 | 调休时长,单位分钟 | |
|─beAwayBusinessTime | integer | 否 | 出差时长,单位分钟 | |
|─askForLeaveTime | integer | 否 | 请假总时长,单位分钟 | |
|─askForLeaveDetails | array | 否 | 请假详情列表 | |
|─ | object | |||
|─uuid | string | 否 | 请假类型UUID | |
|─name | string | 否 | 该请假类型名称 | |
|─count | integer | 否 | 0 | 该请假类型次数 |
|─time | integer | 否 | 0 | 该请假类型时长 |
响应示例:
{
"code": 0,
"data": {
"list": [
{
"absentTime": 0,
"askForLeaveDetails": [
{
"count": 0,
"name": "年假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b21483"
},
{
"count": 0,
"name": "病假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b22483"
},
{
"count": 0,
"name": "事假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b23483"
},
{
"count": 0,
"name": "产假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b24483"
},
{
"count": 0,
"name": "陪产假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b25483"
},
{
"count": 0,
"name": "婚假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b26483"
},
{
"count": 0,
"name": "丧假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b27483"
},
{
"count": 0,
"name": "撸猫假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b28483"
},
{
"count": 0,
"name": "撸狗假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b29483"
},
{
"count": 0,
"name": "姨妈假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b30483"
},
{
"count": 0,
"name": "心情不好假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b31483"
},
{
"count": 0,
"name": "起不来假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b32483"
},
{
"count": 0,
"name": "突然不想上班假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b33483"
},
{
"count": 0,
"name": "想我妈了假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b34483"
},
{
"count": 0,
"name": "熬夜看球假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b35483"
}
],
"askForLeaveTime": 0,
"attendanceDate": 1687190400000,
"beAwayBusinessTime": 0,
"earlyTime": 0,
"lateTime": 0,
"orgName": "wxx",
"orgUuid": "0382c008bbbb46f69be5ccba34f1d584",
"overTime": 0,
"personCode": "123",
"personName": "123",
"requireTime": 0,
"status": 2,
"toilTime": 0,
"workTime": 0
},
{
"absentTime": 0,
"askForLeaveDetails": [
{
"count": 0,
"name": "年假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b21483"
},
{
"count": 0,
"name": "病假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b22483"
},
{
"count": 0,
"name": "事假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b23483"
},
{
"count": 0,
"name": "产假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b24483"
},
{
"count": 0,
"name": "陪产假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b25483"
},
{
"count": 0,
"name": "婚假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b26483"
},
{
"count": 0,
"name": "丧假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b27483"
},
{
"count": 0,
"name": "撸猫假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b28483"
},
{
"count": 0,
"name": "撸狗假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b29483"
},
{
"count": 0,
"name": "姨妈假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b30483"
},
{
"count": 0,
"name": "心情不好假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b31483"
},
{
"count": 0,
"name": "起不来假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b32483"
},
{
"count": 0,
"name": "突然不想上班假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b33483"
},
{
"count": 0,
"name": "想我妈了假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b34483"
},
{
"count": 0,
"name": "熬夜看球假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b35483"
}
],
"askForLeaveTime": 0,
"attendanceDate": 1687276800000,
"beAwayBusinessTime": 0,
"earlyTime": 0,
"lateTime": 0,
"orgName": "wxx",
"orgUuid": "0382c008bbbb46f69be5ccba34f1d584",
"overTime": 0,
"personCode": "123",
"personName": "123",
"requireTime": 0,
"status": 2,
"toilTime": 0,
"workTime": 0
}
],
"pageNum": 1,
"pageSize": 2,
"total": 11
},
"msg": "成功"
}
1.2. 个人月考勤统计
基础信息
路径: /v1/api/attendance/person/statistic/month/list
请求方法: POST
请求参数
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
Content-Type | application/json | 是 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
personName | string | 否 | 人名 | |
personUuidList | array | 否 | 人UUID集合 | |
|─ | string | |||
startTime | string | 是 | 查询开始时间 | |
endTime | string | 是 | 查询结束时间 | |
type | integer | 是 | 查询时间类型:1、月份;2、自定义时间段 | |
pageNum | integer | 否 | 1 | 页码,从1开始 当前页码,不传默认1 |
pageSize | integer | 否 | 20 | 页面大小 分页大小,不传默认20 |
Body示例:
{
"startTime": "2023-06-20",
"endTime": "2023-07-07",
"personUuidList": [
"c614b142bf164730a6e1a7626ba40408"
],
"type": 2,
"orgUuidList": [],
"pageSize": 10,
"pageNum": 1
}
返回数据
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
content-type | application/json;charset=UTF-8 | 否 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
code | integer | 否 | 返回值code | |
msg | string | 否 | 返回值消息 | |
data | object | 否 | 具体的返回值 | |
|─pageNum | integer | 是 | 页码,从1开始 当前页码 |
|
|─pageSize | integer | 是 | 页面大小 分页大小 |
|
|─total | integer | 是 | 总记录数 总数 |
|
|─list | array | 否 | ||
|─ | object | |||
|─personUuid | string | 否 | 人员UUID | |
|─personName | string | 否 | 人员姓名 | |
|─personCode | string | 否 | 人员编号 | |
|─orgUuid | string | 否 | 部门UUID | |
|─orgName | string | 否 | 部门名称 | |
|─period | string | 否 | 月份或自定义时段,示例 2023/05 或 2023/05/01-2023/05/23 | |
|─requireTime | integer | 否 | 应到时长,单位分钟 | |
|─requireCount | integer | 否 | 应到次数 | |
|─workTime | integer | 否 | 实到时长,单位分钟 | |
|─workCount | integer | 否 | 实到次数 | |
|─earlyTime | integer | 否 | 早退时长,单位分钟 | |
|─earlyCount | integer | 否 | 早退次数 | |
|─lateTime | integer | 否 | 迟到时长,单位分钟 | |
|─lateCount | integer | 否 | 迟到次数 | |
|─overTime | integer | 否 | 加班时长,单位分钟 | |
|─overCount | integer | 否 | 加班次数 | |
|─absentTime | integer | 否 | 旷工时长,单位分钟 | |
|─absentCount | integer | 否 | 旷工次数 | |
|─toilTime | integer | 否 | 调休时长,单位分钟 | |
|─toilCount | integer | 否 | 调休次数 | |
|─beAwayBusinessTime | integer | 否 | 出差时长,单位分钟 | |
|─beAwayBusinessCount | integer | 否 | 出差次数 | |
|─askForLeaveTime | integer | 否 | 请假总时长,单位分钟 | |
|─askForLeaveCount | integer | 否 | 请假总次数 | |
|─askForLeaveDetails | array | 否 | 请假详情列表 | |
|─ | object | |||
|─uuid | string | 否 | 请假类型UUID | |
|─name | string | 否 | 该请假类型名称 | |
|─count | integer | 否 | 0 | 该请假类型次数 |
|─time | integer | 否 | 0 | 该请假类型时长 |
响应示例:
{
"code": 0,
"data": {
"list": [
{
"absentCount": 0,
"absentTime": 0,
"askForLeaveCount": 0,
"askForLeaveDetails": [
{
"count": 0,
"name": "年假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b21483"
},
{
"count": 0,
"name": "病假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b22483"
},
{
"count": 0,
"name": "事假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b23483"
},
{
"count": 0,
"name": "产假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b24483"
},
{
"count": 0,
"name": "陪产假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b25483"
},
{
"count": 0,
"name": "婚假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b26483"
},
{
"count": 0,
"name": "丧假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b27483"
},
{
"count": 0,
"name": "撸猫假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b28483"
},
{
"count": 0,
"name": "撸狗假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b29483"
},
{
"count": 0,
"name": "姨妈假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b30483"
},
{
"count": 0,
"name": "心情不好假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b31483"
},
{
"count": 0,
"name": "起不来假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b32483"
},
{
"count": 0,
"name": "突然不想上班假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b33483"
},
{
"count": 0,
"name": "想我妈了假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b34483"
},
{
"count": 0,
"name": "熬夜看球假",
"time": 0,
"uuid": "dd56adffff404c069ca500fcf1b35483"
}
],
"askForLeaveTime": 0,
"beAwayBusinessCount": 0,
"beAwayBusinessTime": 0,
"earlyCount": 0,
"earlyTime": 0,
"lateCount": 0,
"lateTime": 0,
"orgName": "wxx",
"orgUuid": "0382c008bbbb46f69be5ccba34f1d584",
"overCount": 0,
"overTime": 0,
"period": "2023/06/20-2023/07/07",
"personCode": "123",
"personName": "123",
"personUuid": "c614b142bf164730a6e1a7626ba40408",
"requireCount": 0,
"requireTime": 0,
"toilCount": 0,
"toilTime": 0,
"workCount": 0,
"workTime": 0
}
],
"pageNum": 1,
"pageSize": 10,
"total": 1
},
"msg": "成功"
}
1.3. 个人工作时长月考勤统计
基础信息
路径: /v1/api/attendance/person/statistic/workTime/list
请求方法: POST
请求参数
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
Content-Type | application/json | 是 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
personName | string | 否 | 人名 | |
personUuidList | array | 否 | 人UUID集合 | |
|─ | string | |||
startTime | string | 是 | 查询开始时间 | |
endTime | string | 是 | 查询结束时间 | |
type | integer | 是 | 查询时间类型:1、月份;2、自定义时间段 | |
pageNum | integer | 否 | 1 | 页码,从1开始 当前页码,不传默认1 |
pageSize | integer | 否 | 20 | 页面大小 分页大小,不传默认20 |
Body示例:
{
"startTime": "2023-06-20",
"endTime": "2023-07-07",
"personUuidList": [
"c614b142bf164730a6e1a7626ba40408"
],
"type": 2,
"orgUuidList": [],
"pageSize": 10,
"pageNum": 1
}
返回数据
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
content-type | application/json;charset=UTF-8 | 否 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
code | integer | 否 | 返回值code | |
msg | string | 否 | 返回值消息 | |
data | object | 否 | 具体的返回值 | |
|─pageNum | integer | 是 | 页码,从1开始 当前页码 |
|
|─pageSize | integer | 是 | 页面大小 分页大小 |
|
|─total | integer | 是 | 总记录数 总数 |
|
|─list | array | 否 | ||
|─ | object | |||
|─personName | string | 否 | 人员姓名 | |
|─personCode | string | 否 | 人员编号 | |
|─orgName | string | 否 | 部门名称 | |
|─period | string | 否 | 月份或自定义时段,示例 2023/05 或 2023/05/01-2023/05/23 | |
|─workTime | integer | 否 | 实到时长(工作时长),单位分钟 | |
|─workCount | integer | 否 | 实到次数 |
响应示例:
{
"code": 0,
"data": {
"list": [
{
"orgName": "wxx",
"period": "2023/06/20-2023/07/07",
"personCode": "123",
"personName": "123",
"workCount": 0,
"workTime": 0
}
],
"pageNum": 1,
"pageSize": 10,
"total": 1
},
"msg": "成功"
}