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

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



【正向交易接口】场景四:订单物流发货

有赞-大羽 发表于 2018-11-8 19:02   阅读: 299   回复: 0   [复制链接] [显示全部楼层] [打印]

场景说明:
对于需要物流发货的订单,买家下单支付完成后,商家需要进行发货,发货后需要将对应的物流信息同步到有赞,订单状态则由“等待商家发货”变为“商家已发货”。

——如何在微商城后台对订单进行发货?微商城后台-订单-所有订单,找到对应订单后,点击“发货”即可对订单进行发货操作,填写相应物流信息;
image037.png
——填写物流信息后点击发货即可;
image039.png
——通过哪个接口可以快速的对订单进行发货操作?
(1)卖家确认发货:youzan.logistics.online.confirm
(3)重要字段说明:
》》is_no_express:发货是否无需物流,如果为 0 则必须传递物流参数,如果为 1 则无需传递物流参数(out_stype和out_sid),默认为 0;
》》oids:交易明细单号列表,当一个订单包含多种商品时,会自动生成多个oid,如果需要拆单发货,使用该字段指定要发货的商品交易明细编号,多个明细编号用半角逗号“,”分隔;不需要拆单发货,则该字段不传或值为空。该字段可以通过接口https://www.youzanyun.com/apilist/detail/group_trade/trade/youzan.trade.get 获取;
》》out_sid:快递单号,物流发货的实际快递单号;
》》out_stype:物流公司编号,可以通过接口https://www.youzanyun.com/apilist/detail/group_trade/logistics/youzan.logistics.express.get 获取;
》》tid:订单号,需要发货的订单号,可以通过接口https://www.youzanyun.com/apilist/detail/group_trade/trade/youzan.trades.sold.get 获取;
(4)调用格式,通过(2)中链接访问后:
image041.png
(5)HTTP调用示例:
image043.png
(6)JAVA调用示例:
YZClient client = new DefaultYZClient(newToken("token")); //new Sign(appKey, appSecret)
YouzanLogisticsOnlineConfirmParamsyouzanLogisticsOnlineConfirmParams = new YouzanLogisticsOnlineConfirmParams();
youzanLogisticsOnlineConfirmParams.setTid("E20181026105945073600007");
youzanLogisticsOnlineConfirmParams.setIsNoExpress(1L);
YouzanLogisticsOnlineConfirm youzanLogisticsOnlineConfirm =new YouzanLogisticsOnlineConfirm();
youzanLogisticsOnlineConfirm.setAPIParams(youzanLogisticsOnlineConfirmParams);
YouzanLogisticsOnlineConfirmResult result =client.invoke(youzanLogisticsOnlineConfirm);
——如果第一次填写的物流信息有误或者因为其他因素需要更改,该如何操作?微商城后台-订单-所有订单,找到已经发货的订单,点击“修改物流”即可更改物流信息;
image045.png
——需要注意,物流信息只允许更改一次,所以请谨慎更改和填写;
image047.png
——通过哪个接口可以修改物流信息?
(1)修改物流信息:youzan.logistics.online.update
(3)重要字段说明:
》》tid:订单号,需要修改物流信息的订单号,可以通过接口https://www.youzanyun.com/apilist/detail/group_trade/trade/youzan.trades.sold.get 获取;
》》trade_express_modify:需要修改的物流信息,express_id物流公司ID可以通过接口https://www.youzanyun.com/apilist/detail/group_trade/logistics/youzan.logistics.express.get 获取后保存使用;
(4)调用格式,通过(2)中链接访问后:
image049.png
(5)HTTP调用示例:
image051.png
(6)JAVA调用示例:
YZClient client = new DefaultYZClient(newToken("token")); //new Sign(appKey, appSecret)
YouzanLogisticsOnlineUpdateParamsyouzanLogisticsOnlineUpdateParams = new YouzanLogisticsOnlineUpdateParams();
youzanLogisticsOnlineUpdateParams.setTid("E20180930160151010100001");
youzanLogisticsOnlineUpdateParams.setTradeExpressModify("[{"dist_id":"201809301602110000010101", "express_no":"3254222352", "express_id": 3, "version":1}]");
YouzanLogisticsOnlineUpdate youzanLogisticsOnlineUpdate =new YouzanLogisticsOnlineUpdate();
youzanLogisticsOnlineUpdate.setAPIParams(youzanLogisticsOnlineUpdateParams);
YouzanLogisticsOnlineUpdateResult result =client.invoke(youzanLogisticsOnlineUpdate);

总帖 > 【正向交易接口】五大场景接口对接说明
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

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

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