1. 排班管理

排班管理

1.1. 分页查询排班列表

基础信息

路径: /v1/api/attendance/deploy/page

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
orgUuid string 否 部门uuid
groupUuid string 否 班组uuid
personUuid string 否 人员uuid
pageNum integer 否 1 页码，从1开始
当前页码,不传默认1
pageSize integer 否 20 页面大小
分页大小，不传默认20

Body示例:

{
  "orgUuid": "dc04d935d23e4393a81f291ec12f358e",
  "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
      |─shiftUuid string 否 班次uuid
      |─shiftName string 否 班次名称
      |─type integer 否 排班类型
      |─startTime integer 否 生效开始时间
      |─endTime integer 否 生效结束时间
      |─effective boolean 否 是否生效
      |─orgUuid string 否 部门UUID
      |─groupUuid string 否 考勤组UUID
      |─personUuid string 否 人员UUID

响应示例:

{
    "code": 0,
    "data": {
        "list": [
            {
                "effective": true,
                "endTime": 1688054400000,
                "groupUuid": "",
                "orgUuid": "dc04d935d23e4393a81f291ec12f358e",
                "personUuid": "",
                "shiftName": "这个就是班次名称",
                "shiftUuid": "f7e047a6dc304edca6c4073a96a6556e",
                "startTime": 1685548800000,
                "type": 1,
                "uuid": "d91c45e7f48842caaffdeaebed66fb85"
            },
            {
                "effective": false,
                "endTime": 1688054400000,
                "groupUuid": "",
                "orgUuid": "dc04d935d23e4393a81f291ec12f358e",
                "personUuid": "",
                "shiftName": "这个就是班次名称",
                "shiftUuid": "f7e047a6dc304edca6c4073a96a6556e",
                "startTime": 1685548800000,
                "type": 1,
                "uuid": "a4af09b0e6ae416595729cd21d9f26a3"
            }
        ],
        "pageNum": 1,
        "pageSize": 2,
        "total": 20
    },
    "msg": "成功"
}

1.2. 添加排班

基础信息

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

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
personUuid string 否 人员uuid
groupUuids array 否 班组uuid列表
  |─ string
orgUuids array 否 组织uuid列表
  |─ string
shiftUuid string 是 班次uuid
type integer 否 排班类型
objectType integer 否 排班对象类型，1:部门，2：班组，3：人员
dateTimeRanges array 否 有效时间段
  |─ object
    |─start integer 否 有效开始时间
    |─end integer 否 有效结束时间

Body示例:

{
  "shiftUuid": "472f115dde07427bb44b8395a9dd8dda",
  "type": 2,
  "dateTimeRanges": [
    {
      "start": 1687190400000,
      "end": 1687276799999
    },
    {
      "start": 1687104000000,
      "end": 1687190399999
    }
  ],
  "orgUuids": [
    "0"
  ],
  "objectType": 1
}

返回数据

Headers:

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

Body:

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

响应示例:

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

1.3. 编辑排班

基础信息

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

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
uuid string 否 排班uuid
personUuid string 否 人员uuid
groupUuids array 否 班组uuid列表
  |─ string
orgUuids array 否 部门uuid列表
  |─ string
shiftUuid string 否 班次名称
type integer 否 排班类型
dateTimeRanges array 否 有效时间段
  |─ object
    |─start integer 否 有效开始时间
    |─end integer 否 有效结束时间

Body示例:

{
  "shiftUuid": "14863211ba4b4178ba49f7f446d98e7f",
  "type": 1,
  "dateTimeRanges": [
    {
      "start": 1687190400000,
      "end": 1690732800000
    }
  ],
  "orgUuids": [
    "c80da5679aff46dead5fc2a7584eaf26"
  ],
  "objectType": 1,
  "uuid": "a4af09b0e6ae416595729cd21d9f26a3"
}

返回数据

Headers:

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

Body:

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

响应示例:

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

1.4. 批量删除排班

基础信息

路径: /v1/api/attendance/deploy/batchDelete

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
uuids array 是 排班uuid列表
  |─ string

Body示例:

{
  "uuids": [
    "19064db425d54ca2aa3cd1cdd10d834b",
    "a5efa6ec2dfe4430bc7e14ff59fc9300"
  ]
}

返回数据

Headers:

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

Body:

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

响应示例:

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

1.5. 查看排班详情

基础信息

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

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
orgUuid string 否 部门uuid
groupUuid string 否 班组uuid
personUuid string 否 人员uuid
month string 否 考勤月份，格式yyyyMM

Body示例:

{
  "orgUuid": "0",
  "month": "202306"
}

返回数据

Headers:

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

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值
  |─dayDeployDetailList array 是 排班详情列表
    |─ object
      |─date string 否 日期
      |─weekDay integer 否 星期
      |─dayDeployShift object 否 考勤班次
        |─shiftUuid string 否 班次uuid
        |─shiftName string 否 班次名称
        |─shiftType integer 否 班次类型
        |─timeRanges array 否 考勤时段列表
          |─ object
            |─from string 否 签到开始时间
            |─to string 否 签到结束时间
      |─deployStart string 否 排班开始日期
      |─deployEnd string 否 排班结束日期

响应示例:

{
    "code": 0,
    "data": {
        "dayDeployDetailList": [
            {
                "date": "2023-06-01",
                "weekDay": 4
            },
            {
                "date": "2023-06-02",
                "weekDay": 5
            },
            {
                "date": "2023-06-03",
                "weekDay": 6
            },
            {
                "date": "2023-06-04",
                "weekDay": 7
            },
            {
                "date": "2023-06-05",
                "weekDay": 1
            },
            {
                "date": "2023-06-06",
                "weekDay": 2
            },
            {
                "date": "2023-06-07",
                "weekDay": 3
            },
            {
                "date": "2023-06-08",
                "weekDay": 4
            },
            {
                "date": "2023-06-09",
                "weekDay": 5
            },
            {
                "date": "2023-06-10",
                "weekDay": 6
            },
            {
                "date": "2023-06-11",
                "weekDay": 7
            },
            {
                "date": "2023-06-12",
                "weekDay": 1
            },
            {
                "date": "2023-06-13",
                "weekDay": 2
            },
            {
                "date": "2023-06-14",
                "weekDay": 3
            },
            {
                "date": "2023-06-15",
                "weekDay": 4
            },
            {
                "date": "2023-06-16",
                "weekDay": 5
            },
            {
                "date": "2023-06-17",
                "weekDay": 6
            },
            {
                "date": "2023-06-18",
                "weekDay": 7
            },
            {
                "date": "2023-06-19",
                "dayDeployShift": {
                    "shiftName": "test-天",
                    "shiftType": 1,
                    "shiftUuid": "472f115dde07427bb44b8395a9dd8dda",
                    "timeRanges": [
                        {
                            "from": "01:53",
                            "to": "07:02"
                        }
                    ]
                },
                "deployEnd": "2023-06-19",
                "deployStart": "2023-06-19",
                "weekDay": 1
            },
            {
                "date": "2023-06-20",
                "dayDeployShift": {
                    "shiftName": "test-天",
                    "shiftType": 1,
                    "shiftUuid": "472f115dde07427bb44b8395a9dd8dda",
                    "timeRanges": [
                        {
                            "from": "01:53",
                            "to": "07:02"
                        }
                    ]
                },
                "deployEnd": "2023-06-20",
                "deployStart": "2023-06-20",
                "weekDay": 2
            },
            {
                "date": "2023-06-21",
                "weekDay": 3
            },
            {
                "date": "2023-06-22",
                "weekDay": 4
            },
            {
                "date": "2023-06-23",
                "weekDay": 5
            },
            {
                "date": "2023-06-24",
                "weekDay": 6
            },
            {
                "date": "2023-06-25",
                "weekDay": 7
            },
            {
                "date": "2023-06-26",
                "weekDay": 1
            },
            {
                "date": "2023-06-27",
                "weekDay": 2
            },
            {
                "date": "2023-06-28",
                "dayDeployShift": {
                    "shiftName": "这个就是班次名称",
                    "shiftType": 1,
                    "shiftUuid": "f7e047a6dc304edca6c4073a96a6556e",
                    "timeRanges": []
                },
                "deployEnd": "2023-06-28",
                "deployStart": "2023-06-28",
                "weekDay": 3
            },
            {
                "date": "2023-06-29",
                "weekDay": 4
            },
            {
                "date": "2023-06-30",
                "weekDay": 5
            }
        ]
    },
    "msg": "成功"
}

results matching ""

    No results matching ""