修改成员假期余额

企业可通过审批应用或自建应用Secret调用本接口,修改可见范围内员工的“假期余额”。
第三方应用可通过应本接口修改应用可见范围内指定员工的“假期余额”。

请求方式:POST(HTTPS)

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

请求示例:

{
    "userid": "ZhangSan",
    "vacation_id": 1,
    "leftduration": 604800,
    "time_attr": 1,
    "remarks": "PLACE_HOLDER"
}

参数说明:

参数 必须 类型 说明
access_token string 调用接口凭证。必须使用审批应用或企业内自建应用的secret获取,获取方式参考:文档-获取access_token
userid string 需要修改假期余额的成员的userid
vacation_id uint32 假期id
leftduration uint32 设置的假期余额,单位为秒
不能大于1000天或24000小时,当假期时间刻度为按小时请假时,必须为360整倍数,即0.1小时整倍数,按天请假时,必须为8640整倍数,即0.1天整倍数
time_attr uint32 假期时间刻度:0-按天请假;1-按小时请假
主要用于校验,必须等于企业假期管理配置中设置的假期时间刻度类型
remarks string 修改备注,用于显示在假期余额的修改记录当中,可对修改行为作说明,不超过200字符

注:余额的时长单位都为秒,如果假期时间刻度为“按天”,需要除以86400,得到真实假期余额天数;如果假期时间刻度为“按小时”,需要除以3600得到真实假期余额小时数。

权限说明:
审批应用可修改所有成员的假期余额,自建应用仅可修改自建应用可见范围内成员的假期余额。

返回结果:

{
    "errcode": 0,
    "errmsg": "ok"
}

参数说明:

参数 类型 说明
errcode int32 返回码
errmsg string 错误码描述

接口频率限制 600次/分钟

错误说明:

错误码 说明
301062 没有假勤权限
301063 参数错误
301064 内部错误
© 1998 - 2021 Tencent Inc. All Rights Reserved