创建考勤组

**
接口调用量说明**钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，创建考勤组。

例如，调用接口创建了一个考勤组，名为接口创建考勤组。创建后在考勤组管理列表展示，如下图所示。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否可调用	权限申请方式	API Explorer调试
企业内部应用	是	考勤组管理权限	调试
第三方企业应用	否	—	—
第三方个人应用	否	—	—

curl --location --request POST 'https://oapi.dingtalk.com/topapi/attendance/group/add?access_token=4c9d5xxxx' \ --header 'Content-Type: application/json' \ --data-raw '{ "op_user_id": "123dfd", "top_group": { "wifis": [ { "mac_addr": "C0:E0:D0:E0:C0:0F", "ssid": "OFFICE-WiFi", "corp_id": "123dfd" } ], "enable_camera_check": "true", "freecheck_day_start_min_offset": "240", "special_days": "{\"onDuty\":{1400000:123,1400001:123},\"offDuty\":[1400000,1400001]}", "enable_next_day": "false", "shift_vo_list": [ { "id": "123" } ], "disable_check_when_rest": "false", "type": "TURN", "disable_check_without_schedule": "false", "modify_member": "true", "check_need_healthy_code": "true", "members": [ { "role": "Attendance", "user_id": "1212jfkd", "type": "StaffMember", "corp_id": "123dfd" } ], "enable_position_ble": "false", "id": "123", "manager_list": "[\"userId1\",\"userId2\"]", "owner": "123dfdf", "skip_holidays": "true", "offset": "500", "positions": [ { "address": "生物科技产业园区经二路21号", "latitude": "36.687495", "accuracy": "0", "title": "青藏高原自然博物馆", "corp_id": "123dfd", "longitude": "101.750329" } ], "default_class_id": "1234", "enable_face_check": "true", "ble_device_list": [ { "device_id": "1311089987" } ], "enable_outside_camera_check": "true", "freecheck_work_days": "[1,2,3,4,5,6,0]", "enable_outside_check": "true", "workday_class_list": "[12,12,12,12,12,0,0]", "name": "白班考勤", "resource_permission_map": [ { "schedule": "w", "out_side_check": "w", "group_type": "r", "group_member": "w", "check_position_type": "r", "camera_check": "w", "check_time": "w", "over_time_rule": "r" } ], "corp_id": "dingdfe", "enable_emp_select_class": "true" } }'

请求参数

Query 参数

access_token

必需

调用服务端接口的授权凭证，可通过调用access_token接口获得。

示例值:

4c9d5xxxx

Body 参数application/json

op_user_id

string

必需

操作人的userid。

top_group

object

考勤组信息。

必需

owner

string

考勤组负责人。

可选

enable_emp_select_class

boolean

可选

未排班时是否允许员工选择班次打卡。

corp_id

string

可选

企业的corpId，可以在开发者后台获取。

skip_holidays

boolean

可选

是否跳过节假日。true：跳过（默认值）false：不跳过

special_days

string

特殊日期配置。

可选

enable_outside_camera_check

boolean

可选

是否开启外勤打卡必须拍照。true：开启false：关闭（默认值）

positions

array [object {6}]

考勤设置。

可选

modify_member

boolean

可选

是否有修改考勤组成员相关信息。

type

string

必需

考考勤组类型：FIXED：固定班制考勤组TURN：排班制考勤组NONE：自由工时考勤组

enable_face_check

boolean

可选

是是否开启人脸检测。true：开启false：关闭（默认值）

check_need_healthy_code

boolean

可选

打卡是否需要健康码：true：开启false：关闭（默认值）

enable_camera_check

boolean

可选

是否开启拍照打卡。true：开启false：关闭（默认值）

shift_vo_list

array [object {1}]

班次信息。

可选

enable_outside_check

boolean

可选

是否可以外勤打卡。true：允许（默认值）false：不允许

members

array [object {4}]

考勤组成员。

必需

name

string

考勤组名。

必需

number

考勤组ID。

可选

enable_next_day

boolean

可选

是否第二天生效。true：是false：否

manager_list

array[string]

可选

考勤组子管理员userid列表。

workday_class_list

array[number]

可选

周班次列表。固定班制必填，0表示休息。

default_class_id

number

可选

默认班次ID。固定班制必填。

offset

number

考勤范围。

可选

resource_permission_map

object

可选

子管理员权限范围。w：可管理r：可读

wifis

array [object {3}]

考勤wifi打卡。

可选

disable_check_without_schedule

boolean

可选

未排班时是否禁止员工打卡。

freecheck_work_days

array[number]

可选

自由工时考勤组工作日。1：周一0：周日

freecheck_day_start_min_offset

number

可选

自由工时考勤组考勤开始时间与当天0点偏移分钟数。例如：240表示4:00。

disable_check_when_rest

boolean

可选

休息日打卡是否需审批：true：需要 false：不需要

enable_position_ble

boolean

是否启用蓝牙定位。

可选

ble_device_list

array [object {1}]

蓝牙打卡信息。

可选

示例

application/json

Body

result

object

调用结果。

可选

name

string

考勤组名。

可选

number

考勤组id。

可选

success

boolean

是否成功。

可选

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

object

请求ID。

可选

权限#

请求参数

返回响应

权限