企业申请单接口

若企业客户希望在美团企业版审批流配置的时候，其中某个节点需要第三方外部进行审批，请参考图1

1 审批事件通知

1.1 接入说明

美团企业版为客户提供了第三方审批功能，如果企业客户希望在内部系统完成某个审批节点的审批，可在企业后台配置审批流的时候配置第三方审批节点。流程如下

1. 企业提供美团企业版事件通知接口，美团企业版进行配置
2. 企业联系美团企业版客户成功将第三方审批开关打开
3. 企业在企业后台配置审批流时，配置第三方审批节点
4. 在美团企业版平台操作申请单会发送事件给第三方平台
   1. 第三方审批节点状态变更通知
   2. 申请单状态变更

1.2 接口说明

名称	描述
功能	通知第三方申请单待审通知/申请到状态通知
HTTP方法	POST
请求方	美团企业版平台
响应方	第三方平台
uri	第三方提供

1.3 公共参数

详见：公共参数说明-公共请求参数

1.4 业务请求参数

名称	类型	是否必填	说明
entId	Long	是	企业标识
eventType	Integer	是	事件类型（1：审批任务状态变更，2：单据状态变更）
eventData	EventData	是	事件数据

EventData 字段说明
当eventType=1（审批任务状态变更）时

名称	类型	是否必填	说明
applyType	Integer	是	业务类型（101：出差申请）
applyNum	String	否	申请单号
taskStatus	Integer	是	当前审批任务状态（1：已通过，2：待审批，4：已撤回，5：已驳回）
operateScene	Integer	是	审批任务操作场景（0：美团企业版平台人工触发，1：美团企业版平台系统超时触发，2：外部接口调用触发）
operateTime	Long	是	操作时间（13位毫秒时间戳）

当eventType=2（单据状态变更）时

名称	类型	是否必填	说明
applyType	Integer	是	业务类型（101：出差申请）
applyNum	String	否	申请单号
applyStatus	Integer	是	申请单状态（20：审批中，30：已撤回，40：已驳回，60：已通过，1000：已作废）
operateTime	Long	是	操作时间（13位毫秒时间戳）

1.5 业务响应

名称	类型	说明
status	Integer	0: 调用成功，其他值均为: 调用失败
msg	String	失败时的错误描述
data	String	额外数据，无具体含义

1.6 示例

业务请求参数

{
  "method": "apply.event.message",
  "ts": 1665560874,
  "entId": 49821,
  "data": {
    "eventData": {
      "applyType": 101,
      "applyNum": "1949055",
      "applyStatus": 20
    },
    "entId": 49821,
    "eventType": 2
  }
}

业务响应

{
    "status":0,
    "msg":"success",
    "data":""
}

2 审批结果回调接口

2.1 接入说明

第三方平台接收到审批事件通知后，需要进行内部审批流程，然后调用美团企业版的【审批结果回调接口】告知审批结果。

1. 第三方系统调用美团企业版审批接口。
2. 美团企业版内部处理后会返回第三方系统审批结果

2.2 接口说明

名称	描述
功能	第三方审批通知美团企业版
HTTP方法	POST
请求方	第三方平台
响应方	美团企业版平台
uri	/apply/auditOperate
method	apply.audit.operate

2.3 公共参数

详见：公共参数说明-公共请求参数

2.4 业务请求参数

名称	类型	是否必填	说明
auditRequests	List<AuditRequest>	是	审批结果实体数据，最多10条（含10条）

AuditRequest 字段说明

名称	类型	是否必填	说明
entId	Integer	是	企业标识
applyType	String	是	业务类型（101：出差申请）
applyNum	String	是	申请单号，需要与审批事件推送接口applyNum传值一致
outAuditorId	Integer	否	外部审批人在客户企业系统中的唯一标识，如员工工号、员工邮箱等
outAuditorName	Integer	否	外部审批人姓名
operateType	Integer	是	审批操作类型（3：通过，4：驳回）
remark	Integer	否	审批操作理由

2.5 业务响应

名称	类型	说明
status	Integer	0: 调用成功，其他值均为: 调用失败
msg	String	请求响应信息
data	List<AuditOperateDTO>	批量审批结果

AuditOperateDTO格式数据说明

名称	类型	是否必填	说明
successResult	List<OperateResultDetailDTO>	是	审批成功的单据
failResult	List<OperateResultDetailDTO>	是	审批失败的单据

OperateResultDetailDTO 字段说明

名称	类型	是否必填	说明
status	Integer	是	审批状态 0：操作成功 其他值均为：操作失败
msg	String	是	操作失败原因
applyNum	String	否	申请单号

2.6 示例

业务请求参数

{
   "method":"apply.audit.operate",
   "ts":1665560874,
   "entId":49821,
   "auditRequests":[
      {
         "entId":49821,
         "applyType":101,
         "applyNum":"1992808",
         "operateType":3
      },
      {
         "entId":49821,
         "applyType":101,
         "applyNum":"1992809",
         "operateType":3
      }
   ]
}

业务响应

{
   "status":0,
   "msg":"",
   "data":{
      "successResult":[
         {
            "status":0,
            "msg":"",
            "applyNum":"1992808"
         }
      ],
      "failResult":[
         {
            "status":500,
            "msg":"不可重复审批",
            "applyNum":"1992809"
         }
      ]
   }
}