1. 出勤调整管理

出勤调整管理

1.1. 入参特殊说明

名称 类型 备注
typeUuid string 调整类型uuid，获取方式调用/v1/api/sys/queryAdjustType
subTypeUuid string 调整子类型uuid，获取方式调用/v1/api/sys/queryAdjustType,没有子类型，父类型填充
startTime,endTime long 开始时间/结束时间，毫秒级时间戳,每个调整类型含义有所不同
  1. 补签
    • 补签到
      • startTime，签到时间
    • 补签退
      • endTime，签退时间
  2. 调休
    • startTime，调休开始时间
    • endTime，调休结束时间
  3. 请假
    • startTime，请假开始时间
    • endTime，请假结束时间
  4. 加班
    • startTime，加班开始时间
    • endTime，加班结束时间
  5. 调班
    • 个人调班
      • startTime，原日期
      • endTime，新日期
    • 两人换班
      • startTime，原日期
      • endTime，新日期

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

基础信息

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

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
personName string 否 姓名 支持模糊查询
personCode string 否 员工编号 支持模糊查询
orgUuid string 否 部门UUID
typeUuid string 否 调整类型uuid
status integer 否 审批状态，1：审批中，2：审批通过，3：审批未通过，4：撤销
statusList array 否 审批状态数组，1：审批中，2：审批通过，3：审批未通过，4：撤销
  |─ integer
approverName string 否 审批人,支持模糊查询
approverStartTime string 否 查询审批开始时间，毫秒级时间戳
approverEndTime string 否 查询审批截止时间，毫秒级时间戳
pageNum integer 否 1 页码，从1开始
当前页码,不传默认1
pageSize integer 否 20 页面大小
分页大小，不传默认20

Body示例:

{
    "approverStartTime":"1684252800000",
    "approverEndTime":"1686844799000",
    "pageNum":1,
    "pageSize":2
}

返回数据

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 是 部门名称
      |─status integer 是 审批状态，1：审批中，2：审批通过，3：审批未通过，4：撤销
      |─statusDesc string 否
      |─startTime string 是 开始时间,不同调整类型，含义不同
      |─endTime string 是 截止时间,不同调整类型，含义不同
      |─typeUuid string 是 调整类型uuid
      |─typeDesc string 是 调整类型描述
      |─subTypeUuid string 是 调整子类型uuid
      |─subTypeDesc string 是 调整子类型描述
      |─adjustReason string 否 调整原因
      |─approverName string 是 审批人
      |─approverTime string 否 审批时间
      |─approveNote string 否 审批建议
      |─changedPersonUuid string 否 对调人员UUID
      |─changedPersonName string 否 对调人员姓名
      |─changedPersonCode string 否 对调人员编号
      |─changedOrgUuid string 否 对调人员部门UUID
      |─changedOrgName string 否 对调人员部门名称

响应示例:

{
    "code": 0,
    "data": {
        "list": [
            {
                "adjustReason": "个人个人",
                "approveNote": "",
                "approverName": "admin",
                "approverTime": 1686818874949,
                "changedOrgName": "默认部门",
                "changedOrgUuid": "0",
                "changedPersonCode": "1111",
                "changedPersonName": "基础人员",
                "changedPersonUuid": "0f3572147f634522b7ccf4734909d2d3",
                "endTime": 1687449600000,
                "orgName": "默认部门",
                "orgUuid": "0",
                "personCode": "1111",
                "personName": "基础人员",
                "personUuid": "0f3572147f634522b7ccf4734909d2d3",
                "startTime": 1686758400000,
                "status": 2,
                "statusDesc": "通过",
                "subTypeDesc": "个人调班",
                "subTypeUuid": "dd56adffff404c069ca500fcf1b11486",
                "typeDesc": "调班",
                "typeUuid": "dd56adffff404c069ca500fcf1b2f486",
                "uuid": "253e082abcd54eb79111aa7f84452158"
            },
            {
                "adjustReason": "f323",
                "approveNote": "",
                "approverName": "admin",
                "approverTime": 1686818837447,
                "changedOrgName": "",
                "changedOrgUuid": "",
                "changedPersonCode": "",
                "changedPersonName": "",
                "changedPersonUuid": "",
                "endTime": 1687968000000,
                "orgName": "默认部门",
                "orgUuid": "0",
                "personCode": "13026100668",
                "personName": "13026100668",
                "personUuid": "6ce6866601cf46ac859beb17f552aa67",
                "startTime": 1686758400000,
                "status": 2,
                "statusDesc": "通过",
                "subTypeDesc": "病假",
                "subTypeUuid": "dd56adffff404c069ca500fcf1b22483",
                "typeDesc": "请假",
                "typeUuid": "dd56adffff404c069ca500fcf1b2f483",
                "uuid": "8a71b4bc65b24052a207699d75a3b043"
            }
        ],
        "pageNum": 1,
        "pageSize": 2,
        "total": 85
    },
    "msg": "成功"
}

1.3. 出勤调整详情

基础信息

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

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
uuid string 是 uuid

Body示例:

{
    "uuid":"08ad2559f0764d47921962293d207cad"
}

返回数据

Headers:

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

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值
  |─uuid string 是 考勤调整UUID
  |─personUuid string 是 基础人员UUID
  |─personName string 是 基础人员姓名
  |─personCode string 是 基础人员编号
  |─orgUuid string 是 部门UUID
  |─orgName string 是 部门名称
  |─status integer 是 审批状态，1：审批中，2：审批通过，3：审批未通过，4：撤销
  |─statusDesc string 否
  |─startTime string 是 开始时间,不同调整类型，含义不同
  |─endTime string 是 截止时间,不同调整类型，含义不同
  |─typeUuid string 是 调整类型uuid
  |─typeDesc string 是 调整类型描述
  |─subTypeUuid string 是 调整子类型uuid
  |─subTypeDesc string 是 调整子类型描述
  |─adjustReason string 否 调整原因
  |─approverName string 是 审批人
  |─approverTime string 否 审批时间
  |─approveNote string 否 审批建议
  |─changedPersonUuid string 否 对调人员UUID
  |─changedPersonName string 否 对调人员姓名
  |─changedPersonCode string 否 对调人员编号
  |─changedOrgUuid string 否 对调人员部门UUID
  |─changedOrgName string 否 对调人员部门名称

响应示例:

{
    "code": 0,
    "data": {
        "adjustReason": "test",
        "approveNote": "",
        "approverName": "admin",
        "approverTime": 1687155028964,
        "changedOrgName": "",
        "changedOrgUuid": "",
        "changedPersonCode": "",
        "changedPersonName": "",
        "changedPersonUuid": "",
        "endTime": 1686067200000,
        "orgName": "默认部门",
        "orgUuid": "0",
        "personCode": "12",
        "personName": "1234",
        "personUuid": "9eec6ac4d1be4337862342e85d28641e",
        "startTime": 1685980800000,
        "status": 2,
        "subTypeUuid": "dd56adffff404c069ca500fcf1b2f482",
        "typeDesc": "调休",
        "typeUuid": "dd56adffff404c069ca500fcf1b2f482",
        "uuid": "08ad2559f0764d47921962293d207cad"
    },
    "msg": "成功"
}

1.4. 新增出勤调整

基础信息

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

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
personUuid string 是 基础人员UUID
personName string 否
changedPersonUuid string 否 对调人员UUID
对调人员UUID,选调班类型为必填
typeUuid string 是 调整类型uuid
subTypeUuid string 是 调整子类型uuid，没有子类型，父类型填充
startTime string 是 查询开始时间，毫秒级时间戳，补签退可不填
endTime string 是 查询截止时间，毫秒级时间戳，补签到可不填
adjustReason string 否 调整原因，注：调整原因长度为0-50个字符

Body示例:

{
  "personUuid": "9eec6ac4d1be4337862342e85d28641e",
  "typeUuid": "dd56adffff404c069ca500fcf1b2f483",
  "subTypeUuid": "dd56adffff404c069ca500fcf1b21483",
  "personName": "1234",
  "startTime": "1687165550172",
  "endTime": "1687190400000",
  "changedPersonUuid": "",
  "adjustReason": "请年假"
}

返回数据

Headers:

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

Body:

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

响应示例:

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

1.5. 更新出勤调整记录

基础信息

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

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
uuid string 是 出行调整记录主键uuid
changedPersonUuid string 否 对调人员UUID
对调人员UUID,选调班类型为必填
typeUuid string 是 调整类型uuid
subTypeUuid string 是 调整子类型uuid，没有子类型，父类型填充
startTime string 是 查询开始时间，毫秒级时间戳，补签退可不填
endTime string 是 查询截止时间，毫秒级时间戳，补签到可不填
adjustReason string 否 调整事由

Body示例:

{
  "typeUuid": "dd56adffff404c069ca500fcf1b2f482",
  "subTypeUuid": "dd56adffff404c069ca500fcf1b2f482",
  "startTime": 1687024800000,
  "endTime": 1687176000000,
  "changedPersonUuid": "",
  "adjustReason": "111",
  "uuid": "b78d2ad4b04a48e284beda8fbc868fa2"
}

返回数据

Headers:

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

Body:

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

响应示例:

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

1.6. 考勤调整撤销

基础信息

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

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
uuid string 是 出行调整记录主键uuid

Body示例:

{
  "uuid": "bd69a33d6556412bbd0c4e944c2ad678"
}

返回数据

Headers:

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

Body:

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

响应示例:

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

1.7. 考勤调整审批

基础信息

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

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
uuid string 是 出勤调整记录主键uuid
status integer 是 审批状态，1：审批中，2：审批通过，3：审批未通过
note string 否 审批意见

Body示例:

{
  "uuid": "815dd67cab314c5da5bc93782d456962",
  "status": 2,
  "note": "12344"
}

返回数据

Headers:

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

Body:

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

响应示例:

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

results matching ""

    No results matching ""