Authored by liqingzhong

增加接口

@@ -5,9 +5,255 @@ @@ -5,9 +5,255 @@
5 | 接口名称 | 接口描述 | 5 | 接口名称 | 接口描述 |
6 |----------|----------| 6 |----------|----------|
7 | [app.change.submit](#1) | 提交换货申请 | 7 | [app.change.submit](#1) | 提交换货申请 |
8 -| [app.change.detail](#2) | 换货详情 |  
9 -| [app.change.setexpress](#3) | 设置物流信息 |  
10 -| [app.change.getDelivery](#4) | 加载商品返回方式列表 |  
11 -| [app.change.goodsList](#5) | 订单可换货商品列表 | 8 +| [app.change.setexpress](#2) | 设置物流信息 |
  9 +| [app.change.getDelivery](#3) | 加载用户可选择退货方式列表 |
  10 +| [app.change.goodsList](#4) | 订单可换货商品列表 |
  11 +| [app.change.detail](#5) | 换货详情 |
12 12
  13 +## 接口描述
13 14
  15 +### 1、提交换货申请
  16 +
  17 +### 入参
  18 +
  19 +```json
  20 +{
  21 + "uid":"8041520",
  22 + "order_code":"160177031",
  23 + "area_code":"150202",
  24 + "consignee_name":"测试三测试",
  25 + "address":"这里是详细地里是详细地",
  26 + "mobile":"18260001111",
  27 + "zip_code":"334455",
  28 + "delivery_tpye":"10",
  29 + "receipt_time":"",
  30 + "goods":[{
  31 + "product_skn":"51164694",
  32 + "product_skc":"292788",
  33 + "product_sku":"926307",
  34 + "goods_type":"1",
  35 + "last_price":"149.00",
  36 + "exchange_reason":"11",
  37 + "new_goods_id":"376673",
  38 + "new_product_sku":"926306"
  39 + }]
  40 +}
  41 +```
  42 +
  43 +### 返回
  44 +
  45 +```json
  46 +
  47 +```
  48 +
  49 +### 3. 加载用户可选择退货方式列表
  50 +
  51 +| Param Name | Param Type | Required | Param Value | Desc |
  52 +| :-- | --: | --: | --: | --: |
  53 +| method | string | true | app.change.getDelivery | 请求方法 不可变 |
  54 +| area_code | string | true | 210000 | 地区信息 |
  55 +| uid | int | true | 3703860 | 用户 ID |
  56 +
  57 +#### 返回
  58 +
  59 +```json
  60 +{
  61 + "alg": "SALT_MD5",
  62 + "code": 200,
  63 + "data": [
  64 + {
  65 + "id": 10,
  66 + "is_default": "Y",
  67 + "name": "寄回换货"
  68 + },
  69 + {
  70 + "id": 20,
  71 + "is_default": "N",
  72 + "name": "上门换货(白金会员专享服务)"
  73 + }
  74 + ],
  75 + "md5": "0555567ba54421187652e086524e6daf",
  76 + "message": "change type"
  77 +}
  78 +```
  79 +### 4.订单可换货商品列表
  80 +
  81 +| Param Name | Param Type | Required | Param Value | Desc |
  82 +| :-- | --: | --: | --: | --: |
  83 +| method | string | true | app.change.goodsList | 请求方法 不可变 |
  84 +| order_code | string | true | 16051520 | 订单号 |
  85 +| uid | int | true | 5986981 | 用户 ID |
  86 +
  87 +#### 返回
  88 +
  89 +```json
  90 +{
  91 + "address": {
  92 + "address": "2",
  93 + "address_id": 0,
  94 + "area": "北京市 北京市 东城区",
  95 + "area_code": "110101",
  96 + "consignee": "啊六00",
  97 + "mobile": "13000000000",
  98 + "zip_code": "0"
  99 + },
  100 + "exchange_reason": [
  101 + {
  102 + "id": 3,
  103 + "name": "不喜欢"
  104 + },
  105 + {
  106 + "id": 2,
  107 + "name": "性价比不高"
  108 + },
  109 + {
  110 + "id": 11,
  111 + "name": "价格变化"
  112 + },
  113 + {
  114 + "id": 4,
  115 + "name": "质量瑕疵"
  116 + },
  117 + {
  118 + "id": 1,
  119 + "name": "尺寸不合适"
  120 + },
  121 + {
  122 + "id": 7,
  123 + "name": "商品有色差"
  124 + },
  125 + {
  126 + "id": 8,
  127 + "name": "图片与实物不符"
  128 + },
  129 + {
  130 + "id": 6,
  131 + "name": "发错货"
  132 + },
  133 + {
  134 + "id": 5,
  135 + "name": "快递延迟"
  136 + }
  137 + ],
  138 + "goods_list": [
  139 + {
  140 + "changeNum": 3,
  141 + "colorId": 2,
  142 + "color_name": "黑色",
  143 + "erpSkuId": 834063,
  144 + "goodsPrice": 139,
  145 + "goods_id": 314411,
  146 + "goods_image": "http://img11.static.yhbimg.com/goodsimg...",
  147 + "goods_type": "ordinary",
  148 + "goods_type_id": 1,
  149 + "hasShoes": 0,
  150 + "isChangeFlag": 1,
  151 + "last_price": "139.00",
  152 + "num": 3,
  153 + "orderId": 5531831,
  154 + "productSkc": 258548,
  155 + "productSkn": 51134695,
  156 + "productSku": 834063,
  157 + "product_id": 239715,
  158 + "product_name": "CLOTtee camouflage Printing Coat Tech Jacket",
  159 + "product_skc": "258548",
  160 + "product_skn": "51134695",
  161 + "product_sku": "834063",
  162 + "sales_price": 139,
  163 + "size_name": "M"
  164 + }
  165 + ]
  166 +}
  167 +```
  168 +
  169 +### 5. 换货详情
  170 +
  171 +| Param Name | Param Type | Required | Param Value | Desc |
  172 +| :-- | --: | --: | --: | --: |
  173 +| method | string | true | app.change.detail | 请求方法 不可变 |
  174 +| area_code | string | true | 210000 | 地区信息 |
  175 +| uid | int | true | 3703860 | 用户 ID |
  176 +
  177 +#### 返回
  178 +
  179 +```json
  180 +{
  181 + "alg": "SALT_MD5",
  182 + "code": 200,
  183 + "data": {
  184 + "address": "金兴路10号长安花园1层警卫室",
  185 + "city": "北京市",
  186 + "consignee_name": "曹苒",
  187 + "county": "朝阳区",
  188 + "create_time": "2013-09-01 08:02:41",
  189 + "delivery_tpye": "20",
  190 + "delivery_tpye_name": "上门换货",
  191 + "goods_list": [
  192 + {
  193 + "color_name": "白",
  194 + "evidence_images": [],
  195 + "goods_image": "http://img11.static.yhbimg.com/goodsimg/2013/08/...",
  196 + "goods_type": "ordinary",
  197 + "goods_type_id": 1,
  198 + "id": 1,
  199 + "new_color_name": "白",
  200 + "new_product_skc": "109629",
  201 + "new_product_skn": "51019282",
  202 + "new_product_sku": "382155",
  203 + "new_size_name": "37码",
  204 + "product_name": "Onitsuka Tiger经典中帮休闲鞋 MEXICO 66 MIDRUNNER ",
  205 + "product_skc": "109629",
  206 + "product_skn": "51019282",
  207 + "product_sku": "382156",
  208 + "reason": "1",
  209 + "reason_name": "尺寸不合适",
  210 + "remark": "尺寸不合适",
  211 + "sales_price": "0.00",
  212 + "size_name": "38码",
  213 + "src_goods_id": 72525,
  214 + "src_product_id": 47953
  215 + }
  216 + ],
  217 + "mobile": "13521322804",
  218 + "notice": {
  219 + "id": 40,
  220 + "remark": "请您耐心等待换货商品发出,客服电话:400-889-9646",
  221 + "title": "您寄回的商品已收到"
  222 + },
  223 + "order_code": "309557854",
  224 + "province": "北京市",
  225 + "source_order_code": 308550118,
  226 + "status": 40,
  227 + "statusList": [
  228 + {
  229 + "act": "Y",
  230 + "key": 0,
  231 + "name": "提交申请"
  232 + },
  233 + {
  234 + "act": "Y",
  235 + "key": 10,
  236 + "name": "审核通过"
  237 + },
  238 + {
  239 + "act": "Y",
  240 + "key": 20,
  241 + "name": "上门取货"
  242 + },
  243 + {
  244 + "act": "Y",
  245 + "key": 30,
  246 + "name": "商品入库"
  247 + },
  248 + {
  249 + "act": "N",
  250 + "key": 50,
  251 + "name": "换货完成"
  252 + }
  253 + ],
  254 + "status_name": "换货发出"
  255 + },
  256 + "md5": "e49188e6fb7b0c9e626e14ddf8a158d3",
  257 + "message": "换货详情"
  258 +}
  259 +```