# 审批事件推送接口

# 1.概述

通过【审批事件推送】接口，美团企业版将审批实例的变更消息推送给客户平台，客户平台接收并解析成功后，在自己平台进行展示，或者闭环内部逻辑，如提交审批后，通知审批人等。

另外，该接口是实现在客户平台进行三方审批的前提，客户平台内部完成审批后，调用三方审批回调接口通知美团企业侧最终结果。

 提示：
 1、审批事件推送仅作为消息通知功能，不关注下游服务业务处理结果。                                                         
 2、建议提供HTTP接口，HTTPS会进行SSL验证，可能存在证书验证不通过的情况。                                                
 3、消息推送失败会重试推送，消息通知不保证顺序，请下游服务做好幂等处理（根据processInstanceId、createTime、finishtime、type、result）。                                                      
 4、下游服务接收通知失败，美团企业版会重试推送5次，每次时间间隔如下：第一次重试间隔60秒，第二次重试间隔120秒，第三次重试间隔1200秒，第四次重试间隔7200秒，第五次重试间隔14400秒

# 2.接口基本信息

名称	描述
请求方式	POST
调用地址	客户平台提供
调用方	美团企业版
响应方	客户平台
响应超时时间	5秒

# 2.1.请求体

名称	类型	是否必填	示例	说明
traceId	String	是		日志查询ID
accessKey	String	是	B3GFJIEHNEM1RLV-TK	美团企业版分配给客户的接入秘钥
content	String	是	UgxoCGPQIzoP	请求体内容，将请求参数JSON序列化后进行加密的结果值，参照：签名实例

# content加密前数据结构

名称	类型	是否必填	示例	说明
ts	Long	是	1617085650321	13位时间戳。若请求发起时间与平台接受请求时间相差大于10分钟，平台将直接拒绝本次请求
entId	Long	是	46574	企业ID
data	Object	是	见data	业务具体请求内容

data字段说明

名称	类型	是否必填	示例	说明
entId	Long	是	100302	企业ID
processInstanceId	String	是	46871	审批流程实例ID
processName	String	是	审批流程	审批流程模板名称
processCode	String	是	sqtAudit1557562829609902083	审批流程模板ID
auditBizType	Integer	是	2002	审批业务类型
auditBizNo	String	是	41536	审批业务编号
relationBizNoList	List<RelationBizNoInfo>	否		审批流程实例关联业务单号列表
eventType	Integer	是	0	审批事件类型
eventData	Object	是		事件数据

RelationBizNoInfo字段说明

名称	类型	是否必填	示例	说明
relationBizNoType	Integer	是	1000	关联业务单号类型
relationBizNo	String	是	1694558054684561455	关联业务单号

# 审批流程实例变更

审批流程实例开始 EventData字段说明

名称	类型	是否必填	示例	说明
operateStaff	UserInfo	是		操作人
type	Integer	是	0	审批实例变更类型
createTime	Long	是	1693206916000	创建时间

审批流程实例结束 EventData字段说明

名称	类型	是否必填	示例	说明
operateStaff	UserInfo	是		操作人
type	Integer	是	1	审批实例变更类型
result	Integer	是	10	审批实例结束类型
createTime	Long	是	1693208941000	创建审批实例时间，13位时间戳
finishTime	Long	是	1693208960857	结束审批实例时间，13位时间戳

# 审批流程节点变更

审批流程节点开始 EventData字段说明

名称	类型	是否必填	示例	说明
nodeCode	String	是	node2e8a52c62e494296b5e4daf7d443c7be	审批节点ID
nodeName	String	是	员工	审批节点名称
nodeType	Integer	是	1	审批节点类型（1-或签）
assigneeType	Integer	是	16000	审批人类型
type	Integer	是	0	审批节点变更类型
createTime	Long	是	1693206916031	创建审批节点时间，13位时间戳
candidatorStaffList	List<UserInfo>	是		待审批人列表

审批流程节点结束 EventData字段说明

名称	类型	是否必填	示例	说明
nodeCode	String	是	node2e8a52c62e494296b5e4daf7d443c7be	审批节点ID
nodeName	String	是	员工	审批节点名称
nodeType	Integer	是	1	审批节点类型（1-或签）
assigneeType	Integer	是	16000	审批人类型
type	Integer	是	1	审批节点变更类型
result	Integer	是	10	审批节点结束类型
createTime	Long	是	1693206916031	创建审批节点时间，13位时间戳
finishTime	Long	是	1693207953933	结束审批节点时间，13位时间戳
assigneeStaffList	List<UserInfo>	是		已审批人列表（撤回操作没有该属性）
remark	String	否	通过	审批备注

# 审批节点抄送

审批节点抄送 EventData字段说明

名称	类型	是否必填	示例	说明
nodeCode	String	是	node5e531eceba814fa4b06c5f581f55c2de	抄送节点ID
nodeName	String	是	抄送员工	抄送节点名称
type	Integer	是	2	审批节点变更类型
createTime	Long	是	1693206918410	执行抄送节点时间，13位时间戳
carbonCopyStaffList	List<UserInfo>	是		抄送人列表

# 审批节点转交

审批节点转交 EventData字段说明

名称	类型	是否必填	示例	说明
nodeCode	String	是	node98f99e0282d247cf95ed6918ec52d27d	转交节点ID
nodeName	String	是	员工	转交节点名称
type	Integer	是	3	审批节点变更类型
createTime	Long	是	1693208330925	执行转交节点时间，13位时间戳
transferredFromStaffList	List<UserInfo>	是		转交审批人列表
transmitToStaffList	List<UserInfo>	是		被转交审批人列表

# 公共参数

UserInfo字段说明

名称	类型	是否必填	示例	说明
staffIdentifier	String	是	zhangsan@meituan.com	审批人在美团系统中的员工唯一标识(根据企业配置唯一标识，获取邮箱、电话、工号)
staffEntIdentifier	String	否		审批人在客户企业系统中的唯一标识

# 2.2.响应参数

名称	类型	是否必填	示例	说明
status	Integer	是	0	请求响应状态，0：接收成功，其他：接收失败
msg	String	否		错误描述信息
data	String	否		响应数据一般为空

# 3.示例

# 3.1.请求示例

# 3.1.1.请求示例

{
  "traceId": "-8783223091504994686",
  "accessKey": "B3GFJIEHNEM1RLV-TK",
  "content": "UgJn07uNgW7S7fJK0R0xVbaLxoCGPQIzoP-_K4Hmp4RduGszhm2mbUs2toZhCtXKP5JGXVTZ9kGts2Wx3IJQCd90ptMoJTDB0vu7mkedEr4KZCvZn77EZLssMC5SpXilmQ-5RXHzvMIT0ASH-IXepTP_O16U37QqCkEb5L1WLy4"
}

# 3.1.2.请求参数content解析

{
    "entId": 617,
    "ts": 1621222860,
    "data": {
        "entId": 100302,
        "processInstanceId": "46871",
        "processName": "审批流程",
        "processCode": "sqtAudit1557562829609902083",
        "auditBizType": 2002,
        "auditBizNo": "41536",
        "relationBizNoList": null,
        "eventType": 0,
        "eventData": {
            "operateStaff": {
                "staffIdentifier": "zhangsan@meituan.com",
                "staffEntIdentifier": null
            },
            "type": 1,
            "result": 14,
            "createTime": 1695634509027,
            "finishTime": 1695634540247
        }
    }
}

# 3.2.响应示例

# 3.2.1.响应结果

{
  "status": 0,
  "msg": "成功",
  "data": {}
}

# 4.附录

# 4.1.审批事件类型

事件类型	事件类型说明
0	审批流程实例变更
1	审批流程节点变更
2	审批节点抄送事件
3	审批节点转交事件

# 4.2.审批业务类型

业务类型	业务类型说明
2002	出差申请
2004	加班用餐申请
2007	用车申请
2009	酒店事中订单审批
2010	火车票事中订单审批
2011	新版事后报备
2013	机票事中订单审批

# 4.3.审批关联业务单号类型

业务类型	业务类型说明
1000	酒店、机票、火车票单程订单订单号
1001	火车票中转订单-第一程订单号
1002	火车票中转订单-第二程订单号

# 4.4.审批实例、节点变更类型

变更类型	变更类型说明
0	开始
1	结束
2	抄送
3	转交

# 4.5.审批实例、节点结束类型

结束类型	结束类型说明
10	人工审批通过
11	人工审批驳回
12	系统审批通过
13	系统审批驳回
14	发起人撤回
15	免审

# 4.6.审批人类型

审批人类型	审批人类型说明
10000	直属上级
11000	指定员工
12000	指定角色
14000	部门主管
15000	申请人自选
16000	第三方外部审批

# 4.7.审批业务单号信息使用

审批业务类型(auditBizType)	审批业务类型说明	业务单号	业务单号获取方法
2009	酒店事中订单审批	美团企业版订单号	relationBizNoList中relationBizNoType=1000的元素的relationBizNo字段值。
2010	火车票事中订单审批	美团企业版订单号	relationBizNoList中relationBizNoType=1000的元素的relationBizNo字段值。
2011	新版事后报备	美团新版事后报备单号	auditBizNo
2013	机票事中订单审批	美团企业版订单号	relationBizNoList中relationBizNoType=1000的元素的relationBizNo字段值。

# 5.版本记录

版本号	版本日期	更新内容
v1.0	2023-09-26	新增接口
v1.1	2023-12-04	新增字段assigneeType
v1.2	2023-12-13	在接口字段上增加到附录的链接

← 我的审批列表查询三方审批结果回调 →