开发者中心
首页
教程
接口
社区
工具
企业内部开发
快速入门 服务端API 客户端API 附录 更新日志 联系我们
企业内部开发 服务端API 审批 获取企业假期管理配置
获取企业假期管理配置
最后更新：2023/11/30
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取企业假期管理配置
最后更新：2023/11/30

通过本接口可以获取可见范围内员工的“假期管理”配置，包括：各个假期的id、名称、请假单位、时长计算方式、发放规则等。

请求方式：GET(HTTPS)

请求地址：https://qyapi.weixin.qq.com/cgi-bin/oa/vacation/getcorpconf?access_token=ACCESS_TOKEN

参数说明：

参数必须说明
access_token是调用接口凭证。

权限说明

应用类型权限要求
自建应用配置到「审批 - 可调用接口的应用」中
代开发应用具有「审批」权限
第三方应用具有「审批」权限

注： 从2023年12月1日0点起，不再支持通过系统应用secret调用接口，存量企业暂不受影响 查看详情

 

返回结果：

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

参数说明：

参数类型说明
errcodeint32错误码，详情见错误码说明
errmsgstring错误码对应的错误信息提示
listsobj[]假期列表
lists.iduint32假期id
lists.namestring假期名称
lists.time_attruint32假期时间刻度：0-按天请假；1-按小时请假
lists.duration_typeuint32时长计算类型：0-自然日；1-工作日
lists.quota_attrobj假期发放相关配置
lists.quota_attr.typeuint32假期发放类型：0-不限额；1-自动按年发放；2-手动发放；3-自动按月发放
lists.quota_attr.autoreset_timeuint32自动发放时间戳，若假期发放为自动发放，此参数代表自动发放日期。注：返回时间戳的年份是无意义的，请只使用返回时间的月和日；若at_entry_date为true，该字段则无效，假期发放时间为员工入职时间
lists.quota_attr.autoreset_durationuint32自动发放时长，单位为秒。注：只有自动按年发放和自动按月发放时有效，若选择了按照工龄和司龄发放，该字段无效，发放时长请使用区间中的quota
lists.quota_attr.quota_rule_typeuint32额度计算类型，自动按年发放时有效，0-固定额度；1-按工龄计算；2-按司龄计算
lists.quota_attr.quota_rulesobj额度计算规则，自动按年发放时有效
lists.quota_attr.quota_rules.listobj[]额度计算规则区间，只有在选择了按照工龄计算或者按照司龄计算时有效
lists.quota_attr.quota_rules.list.quotauint32区间发放时长，单位为s
lists.quota_attr.quota_rules.list.beginuint32区间开始点，单位为年
lists.quota_attr.quota_rules.list.enduint32区间结束点，无穷大则为0，单位为年
lists.quota_attr.quota_rules.list.based_on_actual_work_timebool是否根据实际入职时间计算假期，选择后会根据员工在今年的实际工作时间发放假期
lists.quota_attr.at_entry_datebool是否按照入职日期发放假期，只有在自动按年发放类型有效，选择后发放假期的时间会成为员工入职的日期
lists.quota_attr.auto_reset_month_dayuint32自动按月发放的发放时间，只有自动按月发放类型有效
lists.perday_durationuint32单位换算值，即1天对应的秒数，可将此值除以3600得到一天对应的小时。
lists.is_newovertimeuint32是否关联加班调休，0-不关联，1-关联，关联后改假期类型变为调休假
lists.enter_comp_time_limituint32入职时间大于n个月可用该假期，单位为月
lists.expire_ruleobj假期过期规则
lists.expire_rule.typeuint32过期规则类型，1-按固定时间过期，2-从发放日按年过期，3-从发放日按月过期，4-不过期
lists.expire_rule.durationuint64有效期，按年过期为年，按月过期为月，只有在以上两种情况时有效
lists.expire_rule.dateobj失效日期，只有按固定时间过期时有效
lists.expire_rule.date.monthuint32失效日期所在月份
lists.expire_rule.date.dayuint32失效日期所在日
lists.expire_rule.extern_duration_enablebool是否允许延长有效期
lists.expire_rule.extern_durationobj延长有效期的具体时间，只有在extern_duration_enable为true时有效
lists.expire_rule.extern_duration.monthuint32延长月数
lists.expire_rule.extern_duration.dayuint32延长天数
接口频率限制 600次/分钟

错误说明：

错误码说明
301062没有假勤权限
301063参数错误
301064内部错误
上一篇
获取审批数据（旧）
下一篇
获取成员假期余额