创建或更改临时排班

可在排班表上创建或修改临时班次，并用于排班。目前支持按日期对一位或多位人员进行排临时班次。 临时排班为付费功能，如需使用请联系您的客户经理。

Warning: 注意：如果返回code=0，且msg不为空，表示临时排班部分成功。 如msg返回{人员：[日期，日期]}格式，代表人员在排班日期下临时排班未成功。这种一般是考勤组id与人员不匹配造成的。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/attendance/v1/user_daily_shifts/batch_create_temp
HTTP Method	POST
接口频率限制	50 次/秒
支持的应用类型	custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	attendance:rule 写入打卡管理规则

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

查询参数

名称	类型	必填	描述
employee_type	string	是	请求体和响应体中的 user_id 的员工ID类型。如果没有后台管理权限，可使用通过手机号或邮箱获取用户 ID 示例值：employee_id 可选值有： - employee_id: 员工 employee ID，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的用户 ID，或者通过手机号或邮箱获取用户 ID获取的user_id。 - employee_no: 员工工号，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的工号

请求体

名称	类型	必填	描述
user_tmp_daily_shifts	user_tmp_daily_shift\[\]	是	临时班表信息列表（数量限制50以内） 数据校验规则： - 长度范围：0 ～ 50
└ group_id	string	是	考勤组 ID，获取方式：1）创建或修改考勤组 2）按名称查询考勤组 3）获取打卡结果 示例值："6737202939523236110"
└ user_id	string	是	用户 ID，与employee_type对应 示例值："abd754f7"
└ date	int	是	日期，格式：yyyymmdd，如20240120 示例值：20240120
└ shift_name	string	是	班次名称 示例值："临时早班"
└ punch_time_simple_rules	punch_time_simple_rule\[\]	是	打卡规则 数据校验规则： - 长度范围：0 ～ 6
└ on_time	string	是	上班时间，格式HH：MM 示例值："9：00"
└ off_time	string	是	下班时间，格式HH：MM。如需表示次日2点，则填入"26：00" 示例值："18：00"
operator_id	string	否	操作人uid，与employee_type对应 示例值："dd31248a"

请求体示例

{
    "user_tmp_daily_shifts": [
        {
            "group_id": "6737202939523236110",
            "user_id": "abd754f7",
            "date": 20240120,
            "shift_name": "临时早班",
            "punch_time_simple_rules": [
                {
                    "on_time": "9：00",
                    "off_time": "18：00"
                }
            ]
        }
    ],
    "operator_id": "dd31248a"
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ user_tmp_daily_shifts	user_tmp_daily_shift\[\]	临时班表信息列表
└ group_id	string	考勤组 ID，可用于按 ID 查询考勤组
└ user_id	string	用户 ID，与employee_type对应
└ date	int	日期
└ shift_name	string	班次名称
└ punch_time_simple_rules	punch_time_simple_rule\[\]	打卡规则
└ on_time	string	上班时间
└ off_time	string	下班时间

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "user_tmp_daily_shifts": [
            {
                "group_id": "6737202939523236110",
                "user_id": "abd754f7",
                "date": 20240120,
                "shift_name": "临时早班",
                "punch_time_simple_rules": [
                    {
                        "on_time": "9：00",
                        "off_time": "18：00"
                    }
                ]
            }
        ]
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1220001	param is invalid	入参校验失败，请根据具体返回的信息检查入参。例如“employee_type invalid”代表人员类型异常。如仍无法解决可联系 技术支持