创建班次

班次是描述一次考勤任务时间规则的统称，比如一天打多少次卡，每次卡的上下班时间，晚到多长时间算迟到，晚到多长时间算缺卡等。

创建一个考勤组前，必须先创建一个或者多个班次。

一个公司内的班次是共享的，你可以直接引用他人创建的班次，但是需要注意的是，若他人修改了班次，会影响到你的考勤组及其考勤结果。

错误码

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

curl --location --request POST 'https://open.feishu.cn/open-apis/attendance/v1/shifts' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '{ "shift_name": "早班", "punch_times": 1, "is_flexible": false, "flexible_minutes": 60, "flexible_rule": [ { "flexible_early_minutes": 60, "flexible_late_minutes": 60 } ], "no_need_off": true, "punch_time_rule": [ { "on_time": "9:00", "off_time": "18:00，第二天凌晨2点， 26:00", "late_minutes_as_late": 30, "late_minutes_as_lack": 60, "on_advance_minutes": 60, "early_minutes_as_early": 30, "early_minutes_as_lack": 60, "off_delay_minutes": 60, "late_minutes_as_serious_late": 40 } ], "late_off_late_on_rule": [ { "late_off_minutes": 60, "late_on_minutes": 30 } ], "rest_time_rule": [ { "rest_begin_time": "13:00", "rest_end_time": "14:00" } ] }'

{ "code": 0, "msg": "success", "data": { "shift": { "shift_id": "6919358778597097404", "shift_name": "早班", "punch_times": 1, "is_flexible": false, "flexible_minutes": 60, "flexible_rule": [ { "flexible_early_minutes": 60, "flexible_late_minutes": 60 } ], "no_need_off": true, "punch_time_rule": [ { "on_time": "9:00", "off_time": "18:00，第二天凌晨2点， 26:00", "late_minutes_as_late": 30, "late_minutes_as_lack": 60, "on_advance_minutes": 60, "early_minutes_as_early": 30, "early_minutes_as_lack": 60, "off_delay_minutes": 60, "late_minutes_as_serious_late": 40 } ], "late_off_late_on_rule": [ { "late_off_minutes": 60, "late_on_minutes": 30 } ], "rest_time_rule": [ { "rest_begin_time": "13:00", "rest_end_time": "14:00" } ] } } }

请求参数

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

shift_name

string

必需

班次名称示例值："早班"

punch_times

integer

必需

打卡次数示例值：1

is_flexible

boolean

必需

是否弹性打卡示例值：false

flexible_minutes

integer

必需

弹性打卡的时间示例值：60

no_need_off

boolean

必需

不需要打下班卡示例值：true

punch_time_rule

array [object {9}]

打卡规则

必需

on_time

string

可选

上班时间示例值："9：00"

off_time

string

可选

下班时间示例值："18：00，第二天凌晨2点， 26：00"

late_minutes_as_late

integer

可选

晚到多久记为迟到示例值：30

late_minutes_as_lack

integer

可选

晚到多久记为缺卡示例值：60

on_advance_minutes

integer

可选

最早多久可打上班卡示例值：60

early_minutes_as_early

integer

可选

早退多久记为早退示例值：30

early_minutes_as_lack

integer

可选

早退多久记为缺卡示例值：60

off_delay_minutes

integer

可选

最晚多久可打下班卡示例值：60

late_minutes_as_serious_late

integer

可选

late_off_late_on_rule

array [object {2}]

晚走晚到规则

必需

late_off_minutes

integer

可选

晚走多久示例值：60

late_on_minutes

integer

可选

晚到多久示例值：30

rest_time_rule

array [object {2}]

休息规则

必需

rest_begin_time

string

可选

休息开始示例值："13：00"

rest_end_time

string

可选

休息结束示例值："14：00"

flexible_rule

array [object {2}]

弹性打卡时间设置

可选

flexible_early_minutes

integer

必需

下班最多可早走（上班早到几分钟，下班可早走几分钟）示例值：60

flexible_late_minutes

integer

必需

上班最多可晚到（上班晚到几分钟，下班须晚走几分钟）示例值：60

示例

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

shift

object

班次

必需

错误码#

请求参数

返回响应

错误码