第三方应用开发 服务端API 审批 批量获取审批单号
批量获取审批单号
最后更新:2023/11/30
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
批量获取审批单号
最后更新:2023/11/30

第三方应用开发者可通过安装在企业的第三方应用的AccessToken调用此接口,以获取授权企业一段时间内企业微信“审批应用”单据的审批编号,支持按模板类型、申请人、部门、申请单审批状态等条件筛选。第三方应用必须开启授权审批接口权限。

一次拉取调用最多拉取100个审批记录,可以通过多次拉取的方式来满足需求,但调用频率不可超过600次/分。

 

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/oa/getapprovalinfo?access_token=ACCESS_TOKEN

请求示例:

{
    "starttime" : "1569546000",
    "endtime" : "1569718800",
    "new_cursor" : "",
    "size" : 100 ,
    "filters" : [
        {
            "key": "template_id",
            "value": "ZLqk8pcsAoaXZ1eY56vpAgfX28MPdYU3ayMaSPHaaa"
        },
        {
            "key" : "creator",
            "value" : "WuJunJie"
        },
        {
            "key" : "department",
            "value" : "1"
        },       
        {
            "key" : "sp_status",
            "value" : "1"
        }     
    ]
}

参数说明:

参数必须说明
access_token调用接口凭证。必须使用第三方应用accesstoken获取,获取方式参考:文档-获取access_token (accesstoken决定了此服务商模板拉取审批表单号的目标企业,请务必保证准确)
starttime审批单提交的时间范围,开始时间,UNix时间戳
endtime审批单提交的时间范围,结束时间,Unix时间戳
new_cursor分页查询游标,默认为空串,后续使用返回的new_next_cursor进行分页拉取
size一次请求拉取审批单数量,默认值为100,上限值为100。若仅允许获取在第三方应用可见范围内申请人提交的表单,返回的sp_no_list个数可能和size不一致,开发者需用next_cursor判断表单记录是否拉取完
filters筛选条件,可对批量拉取的审批申请设置约束条件,支持设置多个条件
└ key筛选类型,包括:
template_id - 目标企业审批模板模板id;
creator - 申请人;
department - 审批单提单者所在部门;
sp_status - 审批状态;
record_type - 审批单类型属性,1-请假;2-打卡补卡;3-出差;4-外出;5-加班; 6- 调班;7-会议室预定;8-退款审批;9-红包报销审批

注意:
1、仅“部门”支持同时配置多个筛选条件。
2、不同类型的筛选条件之间为“与”的关系,同类型筛选条件之间为“或”的关系
3、record_type筛选类型仅支持2021/05/31以后新提交的审批单,历史单不支持表单类型属性过滤
└ value筛选值,对应为:template_id-模板id;creator-申请人userid ;department-所在部门id;sp_status-审批单状态(1-审批中;2-已通过;3-已驳回;4-已撤销;6-通过后撤销;7-已删除;10-已支付)
1 接口频率限制 600次/分钟
2 请求的参数endtime需要大于startime, 起始时间跨度不能超过31天;
3 老的分页游标字段cursor和next_cursor待废弃,请开发者使用新字段new_cursor和new_next_cursor。

返回结果 :

{
    "errcode": 0,
    "errmsg": "ok",
    "sp_no_list": [
        "201909270001",
        "201909270002",
        "201909270003"
    ]
}

权限说明:

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

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

参数说明:

参数说明
sp_no_list审批单号列表,包含满足条件的审批申请
new_next_cursor后续请求查询的游标,当返回结果没有该字段时表示审批单已经拉取完

错误说明:

错误码说明
301055无审批应用数据拉取权限
301025请求参数错误
301026批量拉取审批单内部接口失败

 

上一篇
审批申请状态变化回调通知
下一篇
获取审批申请详情