应用发起审批 - 接口文档 - 企业微信开发者中心

开发者中心

首页

教程

接口

社区

工具

第三方应用开发

快速入门服务端API 客户端API 运营规范附录更新日志联系我们

第三方应用开发客户端API JS-SDK 审批应用发起审批

应用发起审批

最后更新：2022/10/09

通过JS-SDK，可在应用页面中发起审批，之后审批流程的每次状态变化，都会通知开发者，可按需进行拓展开发，具体参见审批流程引擎
调用前提：
1.通过agentConfig注入应用的权限。查看
2.应用需具有审批权限。

注：企业微信客户端2.5.0及以上版本支持。

请求示例：

wx.invoke('thirdPartyOpenPage', {
    "oaType": "10001",// String
    "templateId": "46af67a118a6ebf000002",// String
    "thirdNo": "thirdNo",// String
    "extData": {
        'fieldList': [{
            'title': '采购类型',
            'type': 'text',
            'value': '市场活动',
        },
        {
            'title': '订单链接',
            'type': 'link',
            'value': 'https://work.weixin.qq.com',
        }],
    }
},
function(res) {
    // 输出接口的回调信息
    console.log(res);
});

参数说明：

参数	必须	说明
oaType	是	操作类型，目前支持：10001-发起审批；10002-查看审批详情。
templateId	是	发起审批的模板ID，在第三方应用-审批接口中创建模板可获取。
thirdNo	是	审批单号，由开发者自行定义，不可重复。
extData	是	详情数据，Json格式，用于审批详情页信息展示。

extData数据说明：
extData在发起时由开发者传入，其中数据将全部展示在审批申请中：
1.开发者可利用此特性，在发起审批时，传入需要申请人、审批人、抄送人看到的信息；
2.若需用户填写数据，可在自行使用表单收集，并传入exData中，用于展示。

{  
    "extData": {
        'fieldList': [
            {
                'title': '采购类型',
                'type': 'text',
                'value': '市场活动',
            },
            {
                'title': '采购说明',
                'type': 'text',
                'value': '购买个人办公电脑',
            },
            {
                'title': '采购金额',
                'type': 'text',
                'value': '4839.00元',
            },
            {
                'title': '申请时间',
                'type': 'text',
                'value': '2018/06/20',
            },
            {
                'title': '订单链接',
                'type': 'link',		// link类型，用于在审批详情页展示第三方订单跳转地址
                'value': 'https://www.qq.com',
            },
        ],

    },
}

参数说明：

参数	必须	说明
title	否	字段标题，将会在审批详情页中展示。
type	否	字段类型，目前支持：text-文本；link:链接。link仅展示在审批详情页。
value	否	字段值，将会在审批详情页中展示。

错误说明：

错误提示	说明
已存在相同的审批编号	oaType为10001时，传入的thirdNo已经被其他审批单占用。
审批申请不存在	oaType为10002时，在历史记录中，传入的thirdNo对应的审批单不存在。
审批模板ID不正确	调用接口时传入了错误的templateId
应用ID不正确	使用了错误的 agentId

下载直播回放

审批控件中的外部选项

本节内容

应用发起审批