【多网点接口】场景五：网点订单对接场景

收藏

场景描述：

微商城开启多网点功能之后，用户可能在任意一个网点下单；外部系统在对接这些订单信息时，需要能够区分出订单是属于哪个网点的，以便于做出更准确的数据分析。

——微商城后台查看订单时，在哪个地方能区分出该订单是归属于哪个网点的？微商城后台-订单-所有订单中，点击订单右上角的订单详情，即可在详情中查看订单归属的网点信息；

——通过哪个接口可以查询到订单所归属的网点信息？

（1）获取单笔交易的信息：youzan.trade.get

（3）重要字段说明：

》》tid：订单号，可以从微商城后台订单列表中看到，也可以通过接口https://www.youzanyun.com/apilist/detail/group_trade/trade/youzan.trades.sold.get 批量获取；

》》在响应字段中，offline_id即为网点的ID，可以通过网点ID进一步通过接口https://www.youzanyun.com/apilist/detail/group_shop/multi_store/youzan.multistore.offline.get 查询网点详情；

（4）调用格式，通过（2）中链接访问后：

（5）HTTP调用示例：

（6）JAVA调用示例：

YZClient client= new DefaultYZClient(new Token("token")); //new Sign(appKey,appSecret)

YouzanTradesSoldGetParamsyouzanTradesSoldGetParams = new YouzanTradesSoldGetParams();

YouzanTradesSoldGetyouzanTradesSoldGet = new YouzanTradesSoldGet();

youzanTradesSoldGet.setAPIParams(youzanTradesSoldGetParams);

YouzanTradesSoldGetResultresult = client.invoke(youzanTradesSoldGet);

（7）在响应字段中，从交易基础信息结构体StructurizationTradeOrderInfo—交易基础信息StructurizationOrderInfoDetail中即可看到网点ID：offline_id；

——通过接口获取订单信息虽然方便，但是实时性不太好，需要商家定时、主动的来调取接口；如何能实现有赞产生订单即可实时的由有赞方推送给商家系统？

（1）对接有赞消息推送服务，配置交易消息V3相关推送；消息推送介绍见https://www.youzanyun.com/docs/guide/3401/3448 ；

（2）商家登录有赞云（https://console.youzanyun.com/login ），进入有赞云控制台，在有赞云控制台-消息推送配置中，将推送服务置为打开状态，并填写接收消息推送的服务地址；

（3）在下面推送配置中，勾选交易消息V3里的交易创建/买家付款等消息即可实时接收订单消息；

（4）在选择“消息明细”时，在右侧的参数自定义中可以勾选需要接收的字段，其中就包括网点ID：offline_id字段；