通过本接口可以修改可见范围内员工的“假期余额”。
请求方式: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 | 调用接口凭证 |
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得到真实假期余额小时数。
权限说明:
应用类型 | 权限要求 |
---|---|
自建应用 | 配置到「审批 - 可调用接口的应用」中 |
代开发应用 | 具有「审批」权限 |
第三方应用 | 具有「审批」权限 |
注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情
返回结果:
{
"errcode": 0,
"errmsg": "ok"
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
errcode | int32 | 返回码 |
errmsg | string | 错误码描述 |
接口频率限制 600次/分钟
错误说明:
错误码 | 说明 |
---|---|
301062 | 没有假勤权限 |
301063 | 参数错误 |
301064 | 内部错误 |
301098 | 成员不在假期的适用范围内 |