审批实例开始、结束、终止

事件信息

名称	值
中文名称	审批实例开始、结束、终止
英文名称	bpms_instance_change

功能描述

当审批实例开始、结束时，钉钉服务器给开发者回调地址推送审批实例事件。

支持应用类型

应用类型	Stream模式推送	HTTP推送	SyncHTTP/RDS推送
企业内部应用	支持	支持	不支持

订阅规则

你可以在目标应用的事件订阅中进行审批事件的订阅设置，规则如下：

规则	描述	示例	说明
`/v1.0/event/bpms_instance_change/bizCategoryId/{bizCategoryId}/processCode/{processCode}/type/{type}`	针对某个业务分类下特定审批模板的实例开始、结束或终止事件进行订阅。	`/v1.0/event/bpms_instance_change/bizCategoryId/{bizCategoryId}/processCode/{PROC-EA*F-885E-47AA-AEB9-8F59CB10E309}/type/start`	bizCategoryId：审批表单所属的业务分类标识processCode：审批表单的唯一编码详情参考审批 ID 说明。
`/v1.0/event/bpms_instance_change/processCode/{processCode}/type/{type}`	针对某个审批模板下的实例开始、结束或终止事件进行订阅。	`/v1.0/event/bpms_instance_change/processCode/{PROC-EA*F-885E-47AA-AEB9-8F59CB10E309}/type/start`	processCode：审批表单的唯一编码详情参考审批 ID 说明。

事件体描述

HTTP推送

名称	类型	示例值	描述
EventType	String	bpms_instance_change	事件英文名称。
EventTime	Long	1663143335567	事件发生的时间。
CorpId	String	ding9f50b15bxxxx16741	企业corpId。
BizId	String	1663**35567	无业务意义，幂等。
eventId	String	c7c7120f2c07419**ebdba0318c8	事件的唯一Id。
processInstanceId	String	9Qgx5QqjR7axMwxxxx	审批实例id。
finishTime	Long	1495592272000	结束审批实例时间。时间戳，单位毫秒。
createTime	Long	1495592305000	创建审批实例时间。时间戳，单位毫秒。
processCode	String	Pro-xxx	审批模板的唯一码。
bizCategoryId	String	20230xxx	业务分类标识。
businessId	String	yewu1	流程实例业务标识。
type	String	finish	实例状态变更类型：start：审批实例开始finish：审批正常结束（同意或拒绝）terminate：审批终止（发起人撤销审批单）
title	String	自测-1016	审批实例标题。
businessType	String	yewu1	业务身份。
url	String	https://aflow.dingtalk.com/dingtalk/mobile/homepage.htm?corpid\u003dding2c015874d817xxxx\u0026dd_share\u003d	审批实例url，可在钉钉内跳转到审批页面。
staffId	String	manager75	发起审批实例的员工userId。
result	String	agree	审批结果(审批终止时无此参数)：agree：同意refuse：拒绝

事件体示例

{
  "EventType": "bpms_instance_change",
  "EventTime": 1663143335567,
  "CorpId": "ding9f50b15bxxxx16741",
  "BizId": "1663**35567",
  "eventId": "c7c7120f2c07419**ebdba0318c8",
  "result": "agree",
  "processInstanceId": "9Qgx5QqjR7axMwxxxx",
  "finishTime": 1495592272000,
  "createTime": 1495592305000,
  "processCode": "Pro-xxx",
  "bizCategoryId": "20230xxx",
  "businessId": "yewu1",
  "type": "finish",
  "title": "自测-1016",
  "businessType": "yewu1",
  "url": "https://aflow.dingtalk.com/dingtalk/mobile/homepage.htm?corpid\\u003dding2c015874d817xxxx\\u0026dd_share\\u003d",
  "staffId": "manager75"
}

审批实例开始、结束、终止

事件信息#

功能描述#

支持应用类型#

订阅规则#

事件体描述#

事件体示例#

事件信息

功能描述

支持应用类型

订阅规则

事件体描述

事件体示例