【正向交易接口】场景一：订单信息批量同步

收藏

总帖 > 【正向交易接口】五大场景接口对接说明

场景说明：

买家在有赞店铺下单，下单后在有赞商城后台就会产生对应的订单信息；商家的线下门店系统需要同步有赞店铺的订单信息，进而可以对订单进行发货、同步订单物流信息等。

——在不进行接口对接的情况下，如何批量将有赞的订单信息导出并以csv、excel等文件的形式导入到商家的线下门店系统内？微商城后台-订单-所有订单，选择对应的时间段，点击“批量导出”即可对订单信息进行导出；

——点击批量导出后，会弹出导出的相关配置项，见图中说明；

——生成对应的订单报表后，点击下载即可查看对应报表；

——通过哪个接口可以批量获取微商城的订单信息？

（1）查询卖家已卖出的交易列表：youzan.trades.sold.get

（2）链接地址：https://www.youzanyun.com/apilist/detail/group_trade/trade/youzan.trades.sold.get

（3）重要字段说明：

》》buyer_id：买家ID，买家在有赞下单后才会在订单信息中产生的买家ID，同一个买家从不同渠道进来下来，买家ID的值会不同；该ID主要用于区别下单渠道或者根据一个订单中的买家ID查询该买家在某一个渠道下的下单总量；

》》express_type：物流类型，根据物流配送的类型筛选订单信息，同城送订单：LOCAL_DELIVERY 自提订单：SELF_FETCH 快递配送：EXPRESS

》》offline_id：门店ID，即网点ID，入参增加该字段后，只拉取产生于这个网点的订单；

》》page_no：页码，即拉取第几页的数据，最大不超过100；

》》page_size：每页条数，最大不超过100，建议使用默认值20；

》》status：订单状态，根据订单状态拉取订单，一次只能查询一种状态，待付款：WAIT_BUYER_PAY 待发货：WAIT_SELLER_SEND_GOODS 等待买家确认：WAIT_BUYER_CONFIRM_GOODS 订单完成：TRADE_SUCCESS 订单关闭：TRADE_CLOSE 退款中：TRADE_REFUND

》》tid：订单号，入参订单号则只只查询一笔订单信息，该接口一般不入参tid；

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

（5）HTTP调用示例：

（6）JAVA调用示例：

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

YouzanTradesSoldGetParams youzanTradesSoldGetParams = newYouzanTradesSoldGetParams();

youzanTradesSoldGetParams.setTid(“E20180927170409000100029");

youzanTradesSoldGetParams.setPageNo(1L);

youzanTradesSoldGetParams.setPageSize(50L);

YouzanTradesSoldGet youzanTradesSoldGet = newYouzanTradesSoldGet();

youzanTradesSoldGet.setAPIParams(youzanTradesSoldGetParams);

YouzanTradesSoldGetResult result = client.invoke(youzanTradesSoldGet);

——对于购买了APP开店服务的客户，想要查询某个客户通过APP渠道产生的所有订单信息，以此来统计APP渠道的流量变现的情况，或者用于其他运营用途；这种场景下，使用哪个场景可以专门查询APP渠道的用户订单列表？

（1）根据第三方用户id获取交易订单列表：youzan.trades.sold.outer.get

（2）链接地址：https://www.youzanyun.com/apilist/detail/group_trade/trade/youzan.trades.sold.outer.get

（3）重要字段说明：

》》outer_type：三方用户ua，商家在对接appsdk时，在初始化SDK这步设置的用户ua，值就是申请开发者应用后分配到的client_id；

》》outer_user_id：三方APP用户的user_id，在APPSDK对接流程-打通登录态时传给有赞登录接口的open_user_id；

》》page_no：页码，即拉取第几页的数据，最大不超过100；

》》page_size：每页条数，最大不超过100，建议使用默认值20；

》》use_has_next：是否启用has_next分页判断方式；如果不启用，则按照设置的参数拉取订单；如果启用，需要判断响应参数“has_next”的值，如果为true则继续获取下一页，如果为false则停止获取；

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

（5）HTTP调用示例：

（6）JAVA调用示例：

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

YouzanTradesSoldOuterGetParamsyouzanTradesSoldOuterGetParams = new YouzanTradesSoldOuterGetParams();

youzanTradesSoldOuterGetParams.setOuterUserId("624440060");

youzanTradesSoldOuterGetParams.setOuterType("a9263a4f294b175f63");

youzanTradesSoldOuterGetParams.setPageSize(1L);

youzanTradesSoldOuterGetParams.setPageNo(1L);

YouzanTradesSoldOuterGet youzanTradesSoldOuterGet = newYouzanTradesSoldOuterGet();

youzanTradesSoldOuterGet.setAPIParams(youzanTradesSoldOuterGetParams);

YouzanTradesSoldOuterGetResult result =client.invoke(youzanTradesSoldOuterGet);

总帖 > 【正向交易接口】五大场景接口对接说明