创建考勤组

说明

调用本接口创建考勤组。
服务地址：https://oapi.dingtalk.com

权限

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

应用类型	是否可调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请	调试
第三方企业应用	否	—	—
第三方个人应用	否	—	—

请求参数

Query 参数

access_token

string

必需

调用服务端接口的授权凭证，可通过调用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}]

蓝牙打卡信息。

可选

示例

{
  "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"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1/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"
    }
}'

返回响应

🟢200成功

application/json

Body

result

object

调用结果。

可选

name

string

考勤组名。

可选

number

考勤组id。

可选

success

boolean

是否成功。

可选

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

object

请求ID。

可选

示例

{
  "result": {
    "name": "string",
    "id": 0
  },
  "success": true,
  "errcode": 0,
  "errmsg": "string",
  "": {}
}

说明#

权限#

请求参数

示例代码

返回响应

说明

权限