# 订单数据变更推送接口

# 1.概述

通过【订单数据变更推送】接口，美团企业版将订单的关键数据变更消息推送给客户平台，客户平台接收并解析成功后，在自己平台进行展示或者更新，或者闭环内部逻辑，如买药完结后，展示完结时间等。

 提示：
 1、订单数据变更推送仅作为消息通知功能，不关注下游服务业务处理结果。                                                         
 2、建议提供HTTP接口，HTTPS会进行SSL验证，可能存在证书验证不通过的情况。                                                
 3、消息推送失败会重试推送，消息通知不保证顺序，请下游服务做好幂等处理（根据sqtBizOrderId、firstBusinessType、secondBusinessType、changeTypeList）。                                                      
 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字段说明

名称	类型	是否必填	示例	说明
sqtBizOrderId	Long	是	314442083816943618	美团企业版订单ID
origOrderId	String	是	6045253884937765	业务原始订单ID
entId	Long	是	46574	企业ID
firstBusinessType	String	是	170	一级业务品类编码，详见：4.1.业务类型映射关系
secondBusinessType	String	是	170110	二级业务品类编码，详见：4.1.业务类型映射关系
changeTypeList	List	是	101	变更类型，详见：4.2.变更类型枚举
changeInfo	OrderDataChangeInfo	否		变更信息
changeTime	String	是	2019-10-01 16:40:34	变更时间，格式：yyyy-MM-dd hh:mm:ss

OrderDataChangeInfo字段说明

名称	类型	是否必填	示例	说明
orderTerminateTime	String	否	2019-10-01 16:40:34	买药订单完结时间，格式：yyyy-MM-dd hh:mm:ss，changeType=101 存在

# 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": {
    "sqtBizOrderId": 314442083816943618,
    "origOrderId": "6045253884937765",
    "entId": 46574,
    "firstBusinessType": "170",
    "secondBusinessType": "170110",
    "changeTypeList": [101],
    "changeInfo": {
      "orderTerminateTime": "2019-10-01 16:35:34"
    },
    "changeTime": "2019-10-01 16:40:34"
  }
}

# 3.2.响应示例

# 3.2.1.响应结果

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

# 4.附录

# 4.1.业务类型映射关系

一级业务类型编码	一级业务类型名称	二级业务类型编码	二级业务类型名称
010	到店
		010120	买单
		010110	团购
		010130	扫一扫
		010150	特许报备
		010140	付款码
		010160	预定
		010170	安心付
030	酒店	030110	国内酒店
060	机票	060110	国内机票
040	打车
090	配餐
		090110	盒餐
		090120	现场就餐
020	外卖
050	火车票
070	优选
080	买菜
100	团好货
150	跑腿
130	门票
140	电影票
170	买药	170110	线上购药
180	商品券	180110	外卖商品券
999	其他

# 4.2.变更类型枚举

变更类型编码	变更类型说明
101	买药完结信息变更

# 5.版本记录

版本号	版本日期	更新内容
v1.0	2024-04-29	新增订单数据变更推送接口

← 订单状态变更推送订单列表查询 →