添加退换单

1、功能名称：添加退换单

2、功能描述：添加退换单

3、请求地址：https://ssl.glitzcloud.com/agent/v1/orders/return/add

      测试地址：http://gztest.glitzcloud.com/agent/v1/orders/return/add

4、请求方式：POST

5、请求参数

名称 必填 类型 示例值 描述
store_name 是 String The Warehouse USA 仓库名称
order_no 是 String 112233 参考订单号
express_no 是 String 4299991122113 物流单号
rma 否 String rma RMA
receiver_name 否 String ezreal 退件人
receiver_phone 否 String 021-100010101 退件人电话
receiver_zip 否 String 21991 退件人邮编
receiver_add1 否 String 上海浦东新区 地址第一行
receiver_add2 否 String 金科路2889号 地址第二行
receiver_add3 否 String 长泰广场C栋1002 地址第三行
receiver_city 否 String 上海 城市
receiver_state 否 String 上海 省州
receiver_country 否 String 中国 国家
unboxing 否 String y 是否拆箱（n为否，y为是）
product_list 是 Json [ { "product_sn":"Amy001", "num":"1","reason":"hello-sku-1备注", "disposition":"1" } ] 产品列表，数组json格式，详见 product_list数据结构

6、product_list数据结构

名称 必填 类型 示例值 描述
product_sn 是 String Amy001 产品SKU
num 是 Integer 1 数量
reason 否 String Amy001退货备注 退货备注
disposition 否 Integer 1 货物处理方式，1:直接上架；2:检查&拍照；3:检查&拍照，包装；4:检查&拍照，贴标；5:检查&拍照，包装，贴标；6:清理；7:捐赠；8:其他

7、请求示例

           array(
                    'format'=>'json',
                    'apikey'=>'85082f5f62a811e684f500163e06045f',
                    'randoms'=>1234,
                    'sign'=>'656d6fbe6b7dec6c2e77ffe27f04bd6d',
                    'store_name' => 'The Warehouse USA',
                    'order_no' => '112233',
                    'express_no' => '4299991122113',
                    'rma' => 'rma',
                    'receiver_name' => 'ezreal',
                    'receiver_phone' => '021-100010101',
                    'receiver_zip' => '21991',
                    'receiver_add1' => '上海浦东新区',
                    'receiver_add2' => '金科路2889号',
                    'receiver_add3' => '长泰广场C栋1002',
                    'receiver_city' => '上海',
                    'receiver_state' => '上海',
                    'receiver_country' => '中国',
                    'unboxing' => 'y',
                    'products' => '[{"product_sn":"Amy001","num":"1","reason":"hello-sku-1备注"},{"product_sn":"AMY002","num":"2","reason":"hello-sku-2备注" , "disposition" : "1"}]'
             );

8、返回格式：JSON

9、返回示例：

正确时的返回JSON数据包如下：

{"status":200,"reqMsg":"ok","result":{"change_no":"GCR16092776172"}}

错误时的返回JSON数据包如下：

{"status":"6001","reqMsg":"Reference Order is compulsory","result":[]}

10、返回参数说明：

参数 类型 示例值 描述
change_no String GCR16092776172 退换货单号

全局返回码说明