1. 出勤调整管理

出勤调整管理

1.1. 出勤调整记录分页列表查询

基础信息

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

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
personName string 否 姓名 支持模糊查询
personCode string 否 员工编号 支持模糊查询
orgUuid string 否 部门UUID
adjustType integer 否 调整类型
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 是 部门名称
      |─groupUuid string 是 考勤组UUID
      |─groupName string 是 考勤组名称
      |─adjustTimeBegin string 是 调整时段开始时间，毫秒级时间戳
      |─adjustTimeEnd string 是 调整时段截止时间，毫秒级时间戳
      |─adjustType integer 是 调整类型
1 :补卡
2 :请假
3 :调休
4 :调班
      |─adjustReason string 否 调整原因

响应示例:

{
  "code":0,
  "data":{
    "list":[
      {
        "adjustReason":"",
        "adjustTimeBegin":1679985960000,
        "adjustTimeEnd":1680010920000,
        "adjustType":1,
        "groupName":"new",
        "groupUuid":"5ac63859e9d54242a378ddcf564bf5c7",
        "orgName":"默认部门",
        "orgUuid":"0",
        "personCode":"12312",
        "personName":"eee",
        "personUuid":"aff8d7f5e79e46b3ab976d475917ad0a",
        "uuid":"ab5f79415a784c6ebdfa2740d07c9540"
      }
    ],
    "pageNum":1,
    "pageSize":20,
    "total":1
  },
  "msg":"成功"
}

1.2. 出勤调整

基础信息

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

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
personUuid string 是 基础人员UUID
adjustType integer 是 调整类型：1-补卡、2-请假、3-调休、4-调班
1 :补卡
2 :请假
3 :调休
4 :调班
adjustTimeBegin string 是 调整时段开始时间，毫秒级时间戳
adjustTimeEnd string 是 调整时段截止时间，毫秒级时间戳
adjustReason string 否 调整原因，注：调整原因长度为0-50个字符

Body示例:

{
  "personUuid": "7d73f23434764852aefee6332b6e243c",
  "adjustType": 1,
  "adjustTimeBegin": "1677600000000",
  "adjustTimeEnd": "1679999941920",
  "adjustReason": ""
}

返回数据

Headers:

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

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值
  |─personUuid string 是 员工open ID
  |─adjustType integer 是 调整类型：1-补卡、2-请假、3-调休、4-调班
  |─adjustTimeBegin string 是 调整时段开始时间，毫秒级时间戳
  |─adjustTimeEnd string 是 调整时段截止时间，毫秒级时间戳
  |─adjustReason string 否 调整原因，注：调整事由长度为0-50个字符
  |─uuid string 否 考勤调整记录open ID，出勤调整成功时必有

响应示例:

{
  "code":0,
  "data":{
    "adjustReason":"",
    "adjustTimeBegin":1677600000000,
    "adjustTimeEnd":1679999941920,
    "adjustType":1,
    "personUuid":"7d73f23434764852aefee6332b6e243c",
    "uuid":"e839d6edc2b6411096f312be6250185b"
  },
  "msg":"成功"
}

1.3. 更新出勤调整记录

基础信息

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

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
uuid string 是 出行调整记录主键uuid
adjustType integer 是 调整类型：1-补卡、2-请假、3-调休、4-调班
adjustTimeBegin string 是 调整时段开始时间
adjustTimeEnd string 是 调整时段截止时间
adjustReason string 否 调整事由

Body示例:

{
  "uuid": "e839d6edc2b6411096f312be6250185b",
  "adjustType": 1,
  "adjustTimeBegin": "1677600000000",
  "adjustTimeEnd": "1680192000000",
  "adjustReason": ""
}

返回数据

Headers:

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

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值

响应示例:

{
  "code":0,
  "msg":"成功"
}

results matching ""

    No results matching ""