API
创建退货订单
更新时间: 2019-09-03 20:32:50 访问次数:1627
接口说明

卖家或第三方平台通过该接口可创建退货订单,得到退货订单号。

接口英文名称

rma.returnGoodsOrder.createReturnGoodsOrder

使用场景

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

备注

请求说明
URL http://openapi.winit.com.cn/openapi/service
接口测试 http://openapi.sandbox.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
expressNo
String() N 买家退货运单号

outboundOrderNo
String() Y 出库单号
customerOrderNo
String() N 客户订单号
warehouseCode
String() Y 退货目的仓库
VATNoString()
N退货到英国时需要填写
ReturnGoodsList
Array
退货商品列表

-|productCode
String()
Y商品编码,sku

-|productNum
NumberY

商品数量


-|specification
String()
N
规格
-|handleMethod
String()Y批处理方式
SA:直接上架
NS:新品拍照上架
NS:直接拍照上架
-|itemCodeListArray
退货单品条码列表

-|-|itemCodeString()N退货单品条码

-|-|handleMethod
N处理方式
SA:直接上架
NS:新品拍照上架
NS:直接拍照上架

SA:直接上架

NS:新品拍照上架

DE:销毁
请求示例
  {
    "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 退货地址
返回示例
下单成功示例
{
   "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": ""
}