第三方应用开发 服务端API OA 审批 修改成员假期余额
修改成员假期余额

企业可通过审批应用或自建应用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_tokenstring调用接口凭证。必须使用第三方应用accesstoken获取,获取方式参考:文档-获取access_token
useridstring需要修改假期余额的成员的userid
vacation_iduint32假期id
leftdurationuint32设置的假期余额,单位为秒
不能大于1000天或24000小时,当假期时间刻度为按小时请假时,必须为360整倍数,即0.1小时整倍数,按天请假时,必须为8640整倍数,即0.1天整倍数
time_attruint32假期时间刻度:0-按天请假;1-按小时请假
主要用于校验,必须等于企业假期管理配置中设置的假期时间刻度类型
remarksstring修改备注,用于显示在假期余额的修改记录当中,可对修改行为作说明,不超过200字符
注:余额的时长单位都为秒,如果假期时间刻度为“按天”,需要除以86400,得到真实假期余额天数;如果假期时间刻度为“按小时”,需要除以3600得到真实假期余额小时数。

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

返回结果:

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

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring错误码描述
接口频率限制 600次/分钟

错误说明:

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

 

上一篇
获取成员假期余额
下一篇
审批流程引擎