批量获取审批单号

审批应用及有权限的自建应用,可通过Secret调用本接口,以获取企业一段时间内企业微信“审批应用”单据的审批编号,支持按模板类型、申请人、部门、申请单审批状态等条件筛选。
自建应用调用此接口,需在“管理后台-应用管理-审批-API-审批数据权限”中,授权应用允许提交审批单据。

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

推荐使用此接口获取审批数据,旧接口后续将不再维护。

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

请求示例:

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

参数说明:

参数 必须 说明
access_token 调用接口凭证。必须使用审批应用或企业内自建应用的secret获取,获取方式参考:文档-获取access_token
starttime 审批单提交的时间范围,开始时间,UNix时间戳
endtime 审批单提交的时间范围,结束时间,Unix时间戳
cursor 分页查询游标,默认为0,后续使用返回的next_cursor进行分页拉取
size 一次请求拉取审批单数量,默认值为100,上限值为100
filters 筛选条件,可对批量拉取的审批申请设置约束条件,支持设置多个条件
└ key 筛选类型,包括:
template_id - 模板类型/模板id;
creator - 申请人;
department - 审批单提单者所在部门;
sp_status - 审批状态。

注意:
仅“部门”支持同时配置多个筛选条件。
不同类型的筛选条件之间为“与”的关系,同类型筛选条件之间为“或”的关系
└ value 筛选值,对应为:template_id-模板id;creator-申请人userid ;department-所在部门id;sp_status-审批单状态(1-审批中;2-已通过;3-已驳回;4-已撤销;6-通过后撤销;7-已删除;10-已支付)

1 接口频率限制 600次/分钟
2 请求的参数endtime需要大于startime, 起始时间跨度不能超过31天;


返回结果 :

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

参数说明:

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

错误说明

错误码 说明
301055 无审批应用数据拉取权限
301025 请求参数错误
301026 批量拉取审批单内部接口失败
© 1998 - 2020 Tencent Inc. All Rights Reserved