第三方应用开发 服务端API 审批 修改成员假期余额
修改成员假期余额
最后更新:2023/11/30
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
修改成员假期余额
最后更新:2023/11/30

通过本接口可以修改可见范围内员工的“假期余额”。

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

权限说明:

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

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

返回结果:

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

参数说明:

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

错误说明:

错误码说明
301062没有假勤权限
301063参数错误
301064内部错误
301098成员不在假期的适用范围内

 

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