1. 考勤记录管理

考勤记录管理

1.1. 考勤记录分页列表查询

基础信息

路径: /v1/api/attendance/record/list

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
personName string 否 姓名 模糊查询
personCode string 否 员工编号
status integer 否 考勤状态
0 :--
1 :正常
2 :旷工
3 :出勤调整
4 :异常
startTime string 否 开始时间，毫秒级时间戳
endTime string 否 截止时间，毫秒级时间戳
pageNum integer 否 1 页码，从1开始
当前页码,不传默认1
pageSize integer 否 20 页面大小
分页大小，不传默认20

Body示例:

{
  "pageNum": 1,
  "pageSize": 20
}

返回数据

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
      |─uuid string 是 考勤记录UUID
      |─personUuid string 是 基础人员UUID
      |─personName string 是 基础人员姓名
      |─personCode string 否 基础人员编号
      |─orgUuid string 否 部门UUID
      |─orgName string 否 部门名称
      |─attendanceDate string 是 考勤日期，时间戳
      |─attTimeResult array 是 考勤时段结果：打卡时间&考勤结果
        |─ object
          |─order integer 是 时段编号：1-时段一，2-时段二，3-时段三
          |─inPunch string 是 上班开打卡时间
上班打卡时间eg:09:00:00，需要精确到秒
          |─outPunch string 是 下班打卡时间
下班打卡时间eg:09:00:00，需要精确到秒
          |─result integer 是 考勤结果
0 :考勤结果:0-暂无结果（“--”表示）
1 :正常
2 :缺勤
3 :迟到
4 :早退
5 :迟到早退
6 :漏打卡
7 :出勤调整
      |─status integer 是 考勤状态
0 :--
1 :正常
2 :旷工
3 :出勤调整
4 :异常

响应示例:

{
  "code":0,
  "data":{
    "list":[
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679932800000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"12312",
        "personName":"eee",
        "personUuid":"aff8d7f5e79e46b3ab976d475917ad0a",
        "status":2,
        "uuid":"7bc6446dcaff4901883a53debe422f20"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"14:41:21",
            "order":1,
            "outPunch":"14:44:26",
            "result":1
          }
        ],
        "attendanceDate":1679932800000,
        "orgName":"武汉",
        "orgUuid":"d3ed8f408370441783c53cac92e0bca7",
        "personCode":"12345678",
        "personName":"sxk",
        "personUuid":"7d73f23434764852aefee6332b6e243c",
        "status":1,
        "uuid":"91e7cd96ae374a1282d81c8c39be5f3c"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"21094",
        "personName":"19983",
        "personUuid":"14a4046509fe4a7dad957dbf2f82bf73",
        "status":2,
        "uuid":"fb38c414a99e46a9a92dc138979ba75d"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"17722",
        "personName":"16611",
        "personUuid":"1722a7a9747841ce874238296d555822",
        "status":2,
        "uuid":"889255c5de8a47e8a91f389027a32653"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"24959",
        "personName":"23848",
        "personUuid":"1997aac016dd4a1cbd368ed1ce77a20f",
        "status":2,
        "uuid":"01b3c3f930674b0ab3222847945cdd10"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"13331",
        "personName":"12220",
        "personUuid":"b7bb7e889da846afa771f014b1cd8239",
        "status":2,
        "uuid":"e4643aebc03144df93310f7abbd61d90"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"27979",
        "personName":"26868",
        "personUuid":"ba561b6a1fe24a399985f4124ae2c364",
        "status":2,
        "uuid":"415aea91befb4debb1ecb3f8a638bc48"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"30958",
        "personName":"29847",
        "personUuid":"bccc91c56c1b447a9c8b3cc03fa6c49e",
        "status":2,
        "uuid":"0ebef7cea4634a84a70c43f146bbc549"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"19782",
        "personName":"18671",
        "personUuid":"bf1b23f94dd14e09a83228305060bc62",
        "status":2,
        "uuid":"edf1623affb742cfbdfc6e5d8c0b3d29"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"31134",
        "personName":"30023",
        "personUuid":"c167bd4b13d04a7aaf68166b85e57840",
        "status":2,
        "uuid":"eb9645e8ee9544bd85f54ee05505bc7c"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"20348",
        "personName":"19237",
        "personUuid":"c404506230784106a6f2d266a767f2b3",
        "status":2,
        "uuid":"caf9f0c9e7994c8d8ff8370204bca47d"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"24133",
        "personName":"23022",
        "personUuid":"c686918eb7fb4f208fea8e4db89ac297",
        "status":2,
        "uuid":"026970cd1ff14c118ae3b028c248689b"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"19107",
        "personName":"17996",
        "personUuid":"c90e9b120dfd4bdbbcaf4934a065314a",
        "status":2,
        "uuid":"0ccb2c9d1d684d42b37e12c2b6203ef0"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"21444",
        "personName":"20333",
        "personUuid":"53c5b43606394094bfbc4722c7928757",
        "status":2,
        "uuid":"5e21ff9e3b4c4454a6202a47cd99fb33"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"30849",
        "personName":"29738",
        "personUuid":"562d777d91174d63a45eac1c15b48f5e",
        "status":2,
        "uuid":"b2060c72a6db49ea96789fb83ff759df"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"25155",
        "personName":"24044",
        "personUuid":"5898b9d6bd204902b1287b9ff005426e",
        "status":2,
        "uuid":"ff5bc33582bf4a2baa8bbbf923edf4bc"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"15403",
        "personName":"14292",
        "personUuid":"5ae4352522374cc7934eb1ee79a94b7a",
        "status":2,
        "uuid":"0f5e39fccd884d5db7371152ffa7670d"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"17527",
        "personName":"16416",
        "personUuid":"41254ff16ee14e91b4b84ebe1fe41de1",
        "status":2,
        "uuid":"edb2c7542e784b9a8f23dc88f9df8abc"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"18452",
        "personName":"17341",
        "personUuid":"43944fdc4b514f3ca5d75ed982c6b39f",
        "status":2,
        "uuid":"d0e7c873eba842448a63cc889a255b0e"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"12610",
        "personName":"11499",
        "personUuid":"45b785615c924d719f8b47115190510f",
        "status":2,
        "uuid":"892b0cf895c346c8abf4990b7eeda789"
      }
    ],
    "pageNum":1,
    "pageSize":20,
    "total":83241
  },
  "msg":"成功"
}

1.2. 考勤记录详情分页列表查询

基础信息

路径: /v1/api/attendance/record/detail/list

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
uuid string 是 考勤记录UUID
pageNum integer 否 1 页码，从1开始
当前页码,不传默认1
pageSize integer 否 20 页面大小
分页大小，不传默认20

Body示例:

{
  "uuid": "91e7cd96ae374a1282d81c8c39be5f3c",
  "pageNum": 1,
  "pageSize": 20
}

返回数据

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 否 基础人员编号
      |─pointName string 是 点位名称
      |─pointLocation string 是 点位位置
      |─snapshotUri string 是 抓拍照片url
      |─personImageUri string 是 基础人员底库照片uri
      |─passTime string 是 通行时间，毫秒级时间戳

响应示例:

{
  "code":0,
  "data":{
    "list":[
      {
        "passTime":1679985866000,
        "personCode":"12345678",
        "personImageUri":"http://10.171.5.193:80/v1/storage/download/Z3NwOi8vd3Vrb25n-702ad38888103243ae2c6f109c7d1a93.jpg",
        "personName":"sxk",
        "personUuid":"7d73f23434764852aefee6332b6e243c",
        "pointLocation":"",
        "pointName":"LZX-W5K-I8",
        "snapshotUri":"http://10.171.5.193:80/v1/storage/download/Z3NwOi8vd3Vrb25nLW1lZ2xpbms=-1b362fce04f465818a44b03166579628"
      },
      {
        "passTime":1679985681000,
        "personCode":"12345678",
        "personImageUri":"http://10.171.5.193:80/v1/storage/download/Z3NwOi8vd3Vrb25n-702ad38888103243ae2c6f109c7d1a93.jpg",
        "personName":"sxk",
        "personUuid":"7d73f23434764852aefee6332b6e243c",
        "pointLocation":"",
        "pointName":"LZX-W5K-I8",
        "snapshotUri":"http://10.171.5.193:80/v1/storage/download/Z3NwOi8vd3Vrb25nLW1lZ2xpbms=-55a7a3c68b0ddc8420383881ee838864"
      }
    ],
    "pageNum":1,
    "pageSize":20,
    "total":2
  },
  "msg":"成功"
}

1.3. 考勤记录调整

基础信息

路径: /v1/api/attendance/record/adjust

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
uuid string 是 考勤记录UUID
adjustType integer 是 出勤调整类型
1 :补卡
2 :请假
3 :调休
4 :调班
adjustReason string 否 调整原因，注：调整原因长度为0-50个字符

Body示例:

{
  "uuid": "7bc6446dcaff4901883a53debe422f20",
  "adjustType": 1,
  "adjustReason": ""
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值
  |─adjustRecordUuid string 否 出勤调整记录UUID，调整成功时必有值
  |─uuid string 是 考勤记录UUID
  |─adjustType integer 是 出勤调整类型
1 :补卡
2 :请假
3 :调休
4 :调班
  |─adjustReason string 否 调整原因

响应示例:

{
  "code":0,
  "data":{
    "adjustReason":"",
    "adjustRecordUuid":"ab5f79415a784c6ebdfa2740d07c9540",
    "adjustType":1,
    "uuid":"7bc6446dcaff4901883a53debe422f20"
  },
  "msg":"成功"
}

1.4. 员工月考勤记录分页列表查询

基础信息

路径: /v1/api/attendance/record/personByMonth/list

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
uuid string 是 考勤统计记录UUID，通过考勤统计记录UUID查询考勤记录
pageNum integer 否 1 页码，从1开始
当前页码,不传默认1
pageSize integer 否 20 页面大小
分页大小，不传默认20

Body示例:

{
  "uuid": "3800123ead2448af9a6d475f96f25c43",
  "pageNum": 1,
  "pageSize": 20
}

返回数据

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
      |─uuid string 是 考勤记录UUID
      |─personUuid string 是 基础人员UUID
      |─personName string 是 基础人员姓名
      |─personCode string 否 基础人员编号
      |─orgUuid string 否 部门UUID
      |─orgName string 否 部门名称
      |─attendanceDate string 是 考勤日期，时间戳
      |─attTimeResult array 是 考勤时段结果：打卡时间&考勤结果
        |─ object
          |─order integer 是 时段编号：1-时段一，2-时段二，3-时段三
          |─inPunch string 是 上班开打卡时间
上班打卡时间eg:09:00:00，需要精确到秒
          |─outPunch string 是 下班打卡时间
下班打卡时间eg:09:00:00，需要精确到秒
          |─result integer 是 考勤结果
0 :考勤结果:0-暂无结果（“--”表示）
1 :正常
2 :缺勤
3 :迟到
4 :早退
5 :迟到早退
6 :漏打卡
7 :出勤调整
      |─status integer 是 考勤状态
0 :--
1 :正常
2 :旷工
3 :出勤调整
4 :异常

响应示例:

{
  "code":0,
  "data":{
    "list":[
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679760000000,
        "orgName":"武汉",
        "orgUuid":"d3ed8f408370441783c53cac92e0bca7",
        "personCode":"12256",
        "personName":"11145",
        "personUuid":"b7243c6499cf49d3a9d1195a8d7d3951",
        "status":2,
        "uuid":"c44df972dccf4362b696e01a38e37b87"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679673600000,
        "orgName":"武汉",
        "orgUuid":"d3ed8f408370441783c53cac92e0bca7",
        "personCode":"12256",
        "personName":"11145",
        "personUuid":"b7243c6499cf49d3a9d1195a8d7d3951",
        "status":2,
        "uuid":"26684e34a721421ca3eaf61cc485a038"
      },
      {
        "attTimeResult":[
          {
            "inPunch":"--",
            "order":1,
            "outPunch":"--",
            "result":2
          }
        ],
        "attendanceDate":1679587200000,
        "orgName":"武汉",
        "orgUuid":"d3ed8f408370441783c53cac92e0bca7",
        "personCode":"12256",
        "personName":"11145",
        "personUuid":"b7243c6499cf49d3a9d1195a8d7d3951",
        "status":2,
        "uuid":"231d888572bc4964a3ba3f98b7491477"
      }
    ],
    "pageNum":1,
    "pageSize":20,
    "total":3
  },
  "msg":"成功"
}

1.5. 员工考勤记录日历模式查询

基础信息

路径: /v1/api/attendance/record/calendar

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
uuid string 是 考勤统计记录UUID，通过考勤统计记录查询考勤记录

Body示例:

{
  "uuid": "3800123ead2448af9a6d475f96f25c43"
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data array 否 具体的返回值
  |─ object
    |─uuid string 是 考勤记录UUID
    |─personUuid string 是 基础人员UUID
    |─personName string 是 基础人员姓名
    |─personCode string 否 基础人员编号
    |─orgUuid string 否 部门UUID
    |─orgName string 否 部门名称
    |─attendanceDate string 是 考勤日期，时间戳
    |─attTimeResult array 是 考勤时段结果：打卡时间&考勤结果
      |─ object
        |─order integer 是 时段编号：1-时段一，2-时段二，3-时段三
        |─inPunch string 是 上班开打卡时间
上班打卡时间eg:09:00:00，需要精确到秒
        |─outPunch string 是 下班打卡时间
下班打卡时间eg:09:00:00，需要精确到秒
        |─result integer 是 考勤结果
0 :考勤结果:0-暂无结果（“--”表示）
1 :正常
2 :缺勤
3 :迟到
4 :早退
5 :迟到早退
6 :漏打卡
7 :出勤调整
    |─status integer 是 考勤状态
0 :--
1 :正常
2 :旷工
3 :出勤调整
4 :异常

响应示例:

{
  "code":0,
  "data":[
    {
      "attTimeResult":[
        {
          "adjust":-1,
          "inPunch":"--",
          "order":1,
          "outPunch":"--",
          "period":-1,
          "result":2
        }
      ],
      "attendanceDate":1679587200000,
      "orgName":"武汉",
      "orgUuid":"d3ed8f408370441783c53cac92e0bca7",
      "personCode":"12256",
      "personName":"11145",
      "personUuid":"b7243c6499cf49d3a9d1195a8d7d3951",
      "status":2,
      "uuid":"231d888572bc4964a3ba3f98b7491477"
    },
    {
      "attTimeResult":[
        {
          "adjust":-1,
          "inPunch":"--",
          "order":1,
          "outPunch":"--",
          "period":-1,
          "result":2
        }
      ],
      "attendanceDate":1679760000000,
      "orgName":"武汉",
      "orgUuid":"d3ed8f408370441783c53cac92e0bca7",
      "personCode":"12256",
      "personName":"11145",
      "personUuid":"b7243c6499cf49d3a9d1195a8d7d3951",
      "status":2,
      "uuid":"c44df972dccf4362b696e01a38e37b87"
    },
    {
      "attTimeResult":[
        {
          "adjust":-1,
          "inPunch":"--",
          "order":1,
          "outPunch":"--",
          "period":-1,
          "result":2
        }
      ],
      "attendanceDate":1679673600000,
      "orgName":"武汉",
      "orgUuid":"d3ed8f408370441783c53cac92e0bca7",
      "personCode":"12256",
      "personName":"11145",
      "personUuid":"b7243c6499cf49d3a9d1195a8d7d3951",
      "status":2,
      "uuid":"26684e34a721421ca3eaf61cc485a038"
    }
  ],
  "msg":"成功"
}

results matching ""

    No results matching ""