请选择 进入手机版 | 继续访问电脑版

有赞商家社区 - 做生意,用有赞



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

有赞-大羽 发表于 2018-11-8 18:40   阅读: 811   回复: 0   [复制链接] [显示全部楼层] [打印]
场景说明:

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


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

image001.png
——点击批量导出后,会弹出导出的相关配置项,见图中说明;

image003.png
——生成对应的订单报表后,点击下载即可查看对应报表;

image005.png

——通过哪个接口可以批量获取微商城的订单信息?
(1)查询卖家已卖出的交易列表: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)中链接访问后:
image007.png
(5)HTTP调用示例:
image009.png
(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
(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)中链接访问后:
image011.png
(5)HTTP调用示例:
image013.png
(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);


您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

客服工作时间是9:00-18:00,客服妹子当前不在线,若不能及时回复请谅解。试试右上角的搜索吧,论坛有丰富的经验贴、公告贴,相信一定能够帮到您~

快速回复 返回顶部 返回列表