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

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

场景说明：

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

——如何在微商城后台对订单进行发货？微商城后台-订单-所有订单，找到对应订单后，点击“发货”即可对订单进行发货操作，填写相应物流信息；

——填写物流信息后点击发货即可；

——通过哪个接口可以快速的对订单进行发货操作？

（1）卖家确认发货：youzan.logistics.online.confirm

（2）链接地址：https://www.youzanyun.com/apilist/detail/group_trade/logistics/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）中链接访问后：

（5）HTTP调用示例：

（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);

——如果第一次填写的物流信息有误或者因为其他因素需要更改，该如何操作?微商城后台-订单-所有订单，找到已经发货的订单，点击“修改物流”即可更改物流信息；

——需要注意，物流信息只允许更改一次，所以请谨慎更改和填写；

——通过哪个接口可以修改物流信息？

（1）修改物流信息：youzan.logistics.online.update

（2）连接地址：https://www.youzanyun.com/apilist/detail/group_trade/trade-delivery/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）中链接访问后：

（5）HTTP调用示例：

（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);

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