退换货管理
添加退换单
创建退换货单。
生产环境
https://ssl.glitzcloud.com/agent/v1/orders/return/add测试环境
http://gztest.glitzcloud.com/agent/v1/orders/return/add说明
1、功能名称:添加退换单
2、功能描述:添加退换单
请参阅鉴权签名说明。
请求参数
| 名称 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|
| 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 | 是 | String | [ { "product_sn":"Amy001", "num":"1","reason":"hello-sku-1备注", "disposition":"1" } ] | 产品列表,数组json格式,详见 product_list数据结构 |
返回字段
| 名称 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|
| product_sn | 是 | String | Amy001 | 产品SKU |
| num | 是 | Integer | 1 | 数量 |
| reason | 否 | String | Amy001退货备注 | 退货备注 |
| disposition | 否 | Integer | 1 | 货物处理方式,1:直接上架;6:清理; |
示例
请求示例
{
"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\"}]"
}返回示例
{
"status": 200,
"reqMsg": "ok",
"result": {
"change_no": "GCR16092776172"
}
}示例 3
{
"status": "6001",
"reqMsg": "Reference Order is compulsory",
"result": []
}