【逆向交易接口】场景四：商家同意退货

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

场景描述：

当买家申请退货退款时，商家如何在微商城处理“同意退货”？

——微商城后台-订单-全部订单-退款中列表中，点击“买家发起维权”按钮进入退货退款单详情页：

——点击“同意退货，发送退货地址”，进入同意退货操作界面，选择退货地址发送给买家；

——通过哪个接口可以完成“商家同意退货”操作？

（1）商家同意退货：youzan.trade.returngoods.agree

（2）链接地址：https://www.youzanyun.com/apilist/detail/group_trade/seller_refund/youzan.trade.returngoods.agree

（3）重要字段说明：

》》address：收货地址，既买家收到的退货地址，买家将把需要退款的商品寄送到该地址；

》》mobile：收货手机号，既商家处理退货的人员手机号，买家退货时在快递单上填写的商家收货人手机号；

》》name：收货人姓名，既商家负责接收退货的人员姓名，买家退货时在快递单上填写的商家收货人姓名；

》》refund_id：退款ID，买家申请的退款单的唯一ID，退款查询接口可查询到，如https://www.youzanyun.com/apilist/detail/group_trade/trade_advanced/youzan.trade.refund.search ；

》》remark：退货说明，可以加一些备注，比如用户退货时需要注意些什么；

》》version：退款版本号，通过接口操作退款时的退款版本号，退款查询接口可查询到，如https://www.youzanyun.com/apilist/detail/group_trade/trade_advanced/youzan.trade.refund.search ；

（4）调用格式：

通过（2）中链接访问后：

（5）HTTP调用示例：

（6）JAVA调用示例：

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

YouzanTradeReturngoodsAgreeParamsyouzanTradeReturngoodsAgreeParams = new YouzanTradeReturngoodsAgreeParams();

youzanTradeReturngoodsAgreeParams.setTel("051786457974");

youzanTradeReturngoodsAgreeParams.setRemark("test");

youzanTradeReturngoodsAgreeParams.setRefundId("201809041524210000010610");

youzanTradeReturngoodsAgreeParams.setPost(310000L);

youzanTradeReturngoodsAgreeParams.setName("simon");

youzanTradeReturngoodsAgreeParams.setMobile("135123788732");

youzanTradeReturngoodsAgreeParams.setAddress("杭州市");

youzanTradeReturngoodsAgreeParams.setVersion(1529479461149L);

YouzanTradeReturngoodsAgree youzanTradeReturngoodsAgree =new YouzanTradeReturngoodsAgree();

youzanTradeReturngoodsAgree.setAPIParams(youzanTradeReturngoodsAgreeParams);

YouzanTradeReturngoodsAgreeResult result =client.invoke(youzanTradeReturngoodsAgree);

——商家收到退还的商品之后，通过哪个接口更新库存？

（1）全量或增量方式更新SKU库存：youzan.item.quantity.update

（2）链接地址：https://www.youzanyun.com/apilist/detail/group_item/item/youzan.item.quantity.update ；

（3）重要字段说明：

》》item_id：商品ID，需要更新库存信息的商品ID，商品ID可以在对应的订单信息中获得；如果对接了有赞的消息推送服务，也可以在推送消息中获得订单号，再通过接口https://www.youzanyun.com/apilist/detail/group_trade/trade/youzan.trade.get 获取商品ID；了解有赞消息推送：https://www.youzanyun.com/docs/guide/3401/4213 ；

》》quantity：SKU库存数量，此处数量应该填写为多少在后面的“type”字段中会有说明；

》》sku_id：规格ID，更新商品某个具体规格的库存，如果是无规格商品可以不传，有规格的商品则必须传，否则会报错；

》》type：库存更新方式，0为全量更新，1为增量更新；举例说明：原库存是5，如果设置为全量更新，quantity设置为6，则更新后总库存为6；原库存是5，如果设置为增量更新，quantity设置为6，则更新后总库存为11；

（4）调用格式：

通过（2）中链接访问后：

（5）HTTP调用示例：

（6）JAVA调用示例：

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

YouzanItemQuantityUpdateParamsyouzanItemQuantityUpdateParams = new YouzanItemQuantityUpdateParams();

youzanItemQuantityUpdateParams.setItemId(420750871L);

youzanItemQuantityUpdateParams.setQuantity(10L);

youzanItemQuantityUpdateParams.setSkuId(36208142L);

youzanItemQuantityUpdateParams.setType(0L);

YouzanItemQuantityUpdateyouzanItemQuantityUpdate = new YouzanItemQuantityUpdate();

youzanItemQuantityUpdate.setAPIParams(youzanItemQuantityUpdateParams);

YouzanItemQuantityUpdateResult result =client.invoke(youzanItemQuantityUpdate);

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