获取企业假期管理配置

GET

/cgi-bin/oa/vacation/getcorpconf

服务端API企业内部开发第三方应用开发

企业可通过审批应用或自建应用Secret调用本接口，获取可见范围内员工的“假期管理”配置，包括：各个假期的id、名称、请假单位、时长计算方式、发放规则等。
第三方应用可获取应用可见范围内员工的“假期管理”配置，包括：各个假期的id、名称、请假单位、时长计算方式、发放规则等。

接口频率限制 600次/分钟

错误说明：

错误码	说明
301062	没有假勤权限
301063	参数错误
301064	内部错误

文档ID: 25690
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93375
https://open.work.weixin.qq.com/api/doc/90001/90143/94211

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://qyapi.weixin.qq.com/cgi-bin/oa/vacation/getcorpconf?access_token='

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "lists": [
    {
      "id": 1,
      "name": "年假",
      "time_attr": 0,
      "duration_type": 0,
      "quota_attr": {
        "type": 1,
        "autoreset_time": 1641010352,
        "autoreset_duration": 432000,
        "quota_rule_type": 1,
        "quota_rules": {
          "list": [
            {
              "quota": 432000,
              "begin": 0,
              "end": 1
            },
            {
              "quota": 518400,
              "begin": 1,
              "end": 2
            },
            {
              "quota": 604800,
              "begin": 2,
              "end": 0
            }
          ],
          "based_on_actual_work_time": true
        },
        "at_entry_date": true,
        "auto_reset_month_day": 0
      },
      "perday_duration": 86400,
      "is_newovertime": 0,
      "enter_comp_time_limit": 0,
      "expire_rule": {
        "type": 2,
        "duration": 2,
        "date": {
          "month": 0,
          "day": 0
        },
        "extern_duration_enable": false,
        "extern_duration": {
          "month": 0,
          "day": 0
        }
      }
    }
  ]
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

错误码，详情见错误码说明

errmsg

string

必需

错误码对应的错误信息提示

lists

array [object {9}]

假期列表

必需

integer

假期id

可选

name

string

假期名称

可选

time_attr

integer

可选

假期时间刻度：0-按天请假；1-按小时请假

duration_type

integer

可选

时长计算类型：0-自然日；1-工作日

quota_attr

object

假期发放相关配置

可选

perday_duration

integer

可选

单位换算值，即1天对应的秒数，可将此值除以3600得到一天对应的小时。

is_newovertime

integer

可选

是否关联加班调休，0-不关联，1-关联，关联后改假期类型变为调休假

enter_comp_time_limit

integer

可选

入职时间大于n个月可用该假期，单位为月

expire_rule

object

假期过期规则

可选

修改于 2022-12-05 02:30:19

获取审批数据（旧）

获取成员假期余额