创建或修改班表

班表是用来描述考勤组内人员每天按哪个班次进行上班。目前班表支持按一个整月对一位或多位人员进行排班。

错误码

HTTP状态码	错误码	描述	排查建议
400	1220001	参数错误	请检查参数是否符合要求
400	1220002	租户不存在	请检查 tenant_access_token 是否正确
400	1220004	用户不存在或没有权限	请检查用户 ID 是否正确
400	1220005	没有权限	请前往考勤管理后台检查数据权限范围
400	1225000	系统错误	详见错误信息
400	1226000	班次服务系统错误	详见错误信息
400	1226003	班次不存在	请检查 shift_id 是否正确

curl --location --request POST 'https://open.feishu.cn/open-apis/attendance/v1/user_daily_shifts/batch_create?employee_type=employee_id' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '{ "user_daily_shifts": [ { "group_id": "6737202939523236110", "shift_id": "6753520403404030215", "month": 202101, "user_id": "abd754f7", "day_no": 21 } ], "operator_id": "dd31248a" }'

{ "code": 0, "msg": "success", "data": { "user_daily_shifts": [ { "group_id": "6737202939523236110", "shift_id": "6753520403404030215", "month": 202101, "user_id": "abd754f7", "day_no": 21 } ] } }

请求参数

Query 参数

employee_type

必需

请求体和响应体中的 user_id 的员工工号类型示例值："employee_id" 可选值有： employee_id：员工 employee ID，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的用户 ID employee_no：员工工号，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的工号

示例值:

employee_id

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

user_daily_shifts

array [object {5}]

班表信息列表

必需

group_id

string

必需

考勤组 ID，获取方式：1）创建或修改考勤组 2）按名称查询考勤组 3）获取打卡结果 示例值："6737202939523236110"

shift_id

string

必需

班次 ID，获取方式：1）按名称查询班次 2）创建班次 示例值："6753520403404030215"

month

integer

必需

月份示例值：202101

user_id

string

必需

用户 ID 示例值："abd754f7"

day_no

integer

必需

日期示例值：21

operator_id

string

可选

操作人uid，如果您未操作考勤管理后台“API 接入”流程，则此字段为必填字段示例值："dd31248a"

示例

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

user_daily_shifts

array [object {5}]

班表信息列表

必需

创建或修改班表

错误码#

请求参数

返回响应

错误码