万邑通开发者网站 - 创建退货订单

API

创建退货订单

更新时间： 2021-09-28 01:01:53 访问次数：6149

接口说明

通过该接口可创建退货订单，得到退货订单号。
1.RMA退货：买家提出退货时，卖家或第三方平台创建退货订，提交退货运单号、退货目的仓、退货商品的sku和数量等信息，万邑通返回退货订单号。
2.无RMA退货，卖家可参考快速退货的操作流程进行。

常用工具

请求说明

URL	https://openapi.winit.com.cn/openapi/service
接口测试	https://sandboxopenapi.winit.com.cn/openapi/service
接口名	rma.returnGoodsOrder.createReturnGoodsOrder
验证方法	Token,md5
格式	json
字符编码	UTF-8
http请求方式	http
请求数限制	默认每分钟1000，有需要可申请加大。

请求入参

名称	类型	必填	说明
expressNo	String()	N	买家退货运单号
outboundOrderNo	String()	Y	出库单号
customerOrderNo	String()	N	客户订单号
warehouseCode	String()	Y	退货目的仓库
VATNo	String()	N	退货到英国时需要填写
ReturnGoodsList	Array		退货商品列表
-\|productCode	String()	Y	商品编码，sku
-\|productNum	Number	Y	商品数量
-\|specification	String()	N	规格
-\|handleMethod	String()	Y	批处理方式 SA：直接上架 NS：新品拍照上架 DE：销毁
-\|itemCodeList	Array		退货单品条码列表
-\|-\|itemCode	String()	N	退货单品条码
-\|-\|handleMethod		N	处理方式 SA：直接上架 NS：新品拍照上架 DE：销毁
winitProductCode		N	退货渠道PSC 特殊客户入参，一般不入参
ownerCode		N	退货货主编码特殊客户入参，一般不入参
userInfoSource		O	发件人地址来源 ORI: 使用出库单的收件人信息 IRI: 录入退货人信息
name		Y	退货人名字 UserInfoSource为IRI时必填
email		N	退货人Email UserInfoSource为IRI时必填
phone		N	退货人电话 UserInfoSource为IRI时必填
country		Y	退货人国家 UserInfoSource为IRI时必填
state		N	退货人州省 UserInfoSource为IRI时必填
city		Y	退货人城市 UserInfoSource为IRI时必填
postcode		Y	退货人邮编 UserInfoSource为IRI时必填
houseNo		Y	退货人门牌号 UserInfoSource为IRI时必填
address1		Y	退货人地址 UserInfoSource为IRI时必填
address2		N	退货人地址2 UserInfoSource为IRI时必填

请求示例

Json
XML

  {
    "action":" rma.returnGoodsOrder.createReturnGoodsOrder",
    "app_key":"rebecca",
  "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"4C84981DF6E4E012479FC6675DD3BFAF",
    "data":{
        "expressNo":"1Z31AE0830987653983",
        "outboundOrderNo":"WO0000003291",
        "customerOrderNo":"",
        "warehouseCode":"US0001",
        "ReturnGoodsList":[
            {
                "productCode":"auto_sku22",
                "itemCodeList":[
                    {
                        "itemCode":"S500006000146276977",
                        "handleMethod":"SA"
                    }
                    
                ],
                "productNum":"1",
                "specification":"",
                "handleMethod":"NS"
            }
            ]
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"OWNERERP",
    "sign":"2C2AFDD6807AC7635A0018A13F10A2C7",
    "sign_method":"md5",
    "timestamp":"2015-06-16 001926",
    "version":"1.0"
}

返回出参

名称	类型	必填	说明
returnGoodsOrderNo	String()	Y	WINIT订单号-退货订单号
rmaNo	String()	Y	RMA号
returnAddress	String()	Y	退货地址

返回示例

Json
XML

下单成功示例
{
   "code": "0",
   "msg": "操作成功",
   "data":    {
      "returnAddress": "Winit AU Trade Pty Ltd. Block A2, 391 Park Road #38977601 Regents Park New South Wales 2143 AU ",
      "rmaNo": "9742208",
      "returnGoodsOrderNo": "RT16000000000211CN"
   }
}

错误code

下单失败示例
{
   "code": "02050240094",
   "msg": "当前出库订单[WO0969339140]已生成退货订单，可退货商品数量不足",
   "data": ""
}
{
   "code": "02050240099",
   "msg": "若填写单品列表，列表内单品数量须等于退货数量",
   "data": ""
}
{
   "code": "02050240097",
   "msg": "出库单号:[WO1033768582]状态不支持作废",
   "data": ""
}
{
   "code": "02050240098",
   "msg": "存在已退货单品，创建退货订单失败",
   "data": ""
}
{
   "code": "02050240124",
   "msg": "商品编码不存在",
   "data": ""
}
{
   "code": "02010250344",
   "msg": "退货单品的处理方式不能为空",
   "data": ""
}

关键词

退货订单
创建退货订单
rma.returnGoodsOrder.createReturnGoodsOrder