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": "成功"
}

results matching ""

    No results matching ""