Authored by qianjun

add delivery address

  1 +# 退货服务接口
  2 +
  3 +## 接口列表
  4 +| 接口名称 | 接口描述 |
  5 +| --------| -------- |
  6 +|[app.refund.goodsList](#1)|获取退货订单商品列表|
  7 +|[app.refund.submit](#2)|提交退货申请|
  8 +|[app.refund.detail](#3)|退货详情|
  9 +|[app.refund.setexpress](#4)|保存快递信息|
  10 +
  11 +
  12 +## 接口描述
  13 +
  14 +### 1、获取退货订单商品列表(app.refund.goodsList)
  15 +
  16 +#### 请求参数
  17 +| Param Name | Param Type | Required | Param Value | Desc |
  18 +| :-- | --: | --: | --: | --: |
  19 +| method | String | true | app.refund.goodsList| 请求方法|
  20 +| uid | int | true | 7893817 |用户ID |
  21 +| order_code |long | true | 1613656852 |订单号 |
  22 +
  23 +#### 响应内容
  24 +```json
  25 +{
  26 + "code": 200,
  27 + "data": {
  28 + "coupon_amount": "0.00",
  29 + "goods_list": [
  30 + {
  31 + "color_name": "蓝色",
  32 + "goods_id": 355897,
  33 + "goods_image": "http://img10.static.yhbimg.com/goodsimg/2015/10/29/12/01c9c05a2170996e86f5c1f7ed32e48ac7.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  34 + "goods_type": "ordinary",
  35 + "goods_type_id": 1,
  36 + "hasShoes": 0,
  37 + "last_price": "149.00",
  38 + "product_id": 275357,
  39 + "product_name": "Life•After Life X The Simpsons 辛普森一家刺绣牛津纺衬衫",
  40 + "product_skc": 280039,
  41 + "product_skn": 51153138,
  42 + "product_sku": 894428,
  43 + "size_name": "M"
  44 + }
  45 + ],
  46 + "return_amount_info": "",
  47 + "return_amount_mode": [
  48 + {
  49 + "id": 1,
  50 + "is_default": "Y",
  51 + "name": "原卡返还"
  52 + }
  53 + ],
  54 + "return_reason": [
  55 + {
  56 + "id": 3,
  57 + "name": "不喜欢"
  58 + },
  59 + {
  60 + "id": 2,
  61 + "name": "性价比不高"
  62 + },
  63 + {
  64 + "id": 11,
  65 + "name": "价格变化"
  66 + },
  67 + {
  68 + "id": 4,
  69 + "name": "质量瑕疵"
  70 + },
  71 + {
  72 + "id": 1,
  73 + "name": "尺寸不合适"
  74 + },
  75 + {
  76 + "id": 7,
  77 + "name": "商品有色差"
  78 + },
  79 + {
  80 + "id": 8,
  81 + "name": "图片与实物不符"
  82 + },
  83 + {
  84 + "id": 6,
  85 + "name": "发错货"
  86 + },
  87 + {
  88 + "id": 5,
  89 + "name": "快递延迟"
  90 + }
  91 + ],
  92 + "yoho_coin_num": "0.00"
  93 + },
  94 + "md5": "72879cfb65bcd2705e4283d2f5dc1a30",
  95 + "message": "Refund goods list"
  96 +}
  97 +```
  98 +
  99 +
  100 +### 2、提交退货申请(app.refund.submit)
  101 +
  102 +#### 请求参数
  103 +| Param Name | Param Type | Required | Param Value | Desc |
  104 +| :-- | --: | --: | --: | --: |
  105 +| method | String | true |app.refund.submit| 请求方法|
  106 +| order_code |long | true | 1512253171 |订单号 |
  107 +| uid | int | true |8040274 |用户ID |
  108 +| area_code |String | false | " " (默认值为空) |地区编号|
  109 +| goods |String(json数组) | true | [{"goods_type":"1","last_price":"18.00","product_skc":"83007","product_skn":"51001899","product_sku":"307528","remark":" ","returned_reason":1}] |退货商品 |
  110 +| payment |String(json对象) | true | {"alipay_account":" ","alipay_name":" ","area_code":"320115","bank_card":" ","bank_name":" ","city":" ","payee_name":" ","province":" ","remark":" ","return_amount_mode":"1"} |退款设置|
  111 +
  112 +#### 响应内容
  113 +```json
  114 +{
  115 + "code": 200,
  116 + "message": "退货申请成功",
  117 + "data": {
  118 + "apply_id": "428135"
  119 + },
  120 + "md5": "2d4a86d3d308cf8cbdd9870ebd61a3a4"
  121 +}
  122 +```
  123 +##### 响应内容描述
  124 +| Param Name | Param Type | Desc |
  125 +| ---------- | ---------- | ---- |
  126 +| apply_id | String | 退货申请ID |
  127 +
  128 +
  129 +### 3、退货详情(app.refund.detail)
  130 +
  131 +#### 请求参数
  132 +| Param Name | Param Type | Required | Param Value | Desc |
  133 +| :-- | --: | --: | --: | --: |
  134 +| method | String | true | app.refund.detail| 请求方法|
  135 +| id |int | true | 428106 |退货申请ID |
  136 +| uid | int | true | 362719 |用户ID |
  137 +
  138 +
  139 +#### 响应内容
  140 +```json
  141 +{
  142 + "code": 200,
  143 + "message": "退货详情",
  144 + "data": {
  145 + "source_order_code": "1513540278",
  146 + "use_yoho_coin_num": null,
  147 + "status": "20",
  148 + "status_name": "商品寄回",
  149 + "statusList": [
  150 + {
  151 + "name": "提交申请",
  152 + "act": "Y"
  153 + },
  154 + {
  155 + "name": "审核通过",
  156 + "act": "Y"
  157 + },
  158 + {
  159 + "name": "商品寄回",
  160 + "act": "Y"
  161 + },
  162 + {
  163 + "name": "商品入库",
  164 + "act": "N"
  165 + },
  166 + {
  167 + "name": "退款完成",
  168 + "act": "N"
  169 + }
  170 + ],
  171 + "create_time": "2015-11-23 20:20:12",
  172 + "return_amount_mode_name": "YOHO币",
  173 + "return_amount_mode": "4",
  174 + "return_yoho_coin": "0",
  175 + "goods_list": [
  176 + {
  177 + "product_skn": "51146548",
  178 + "product_name": "我是可爱的小秋秋,james,蔡!",
  179 + "goods_image": "?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/90",
  180 + "size_name": null,
  181 + "color_name": null,
  182 + "sales_price": null,
  183 + "reason": "1",
  184 + "remark": "",
  185 + "reason_name": "尺寸不合适",
  186 + "evidence_images": [],
  187 + "goods_type": "ordinary"
  188 + }
  189 + ],
  190 + "notice": {
  191 + "id": 20,
  192 + "title": "商品寄回物流信息",
  193 + "express_company": "南京ems",
  194 + "express_number": "44323566"
  195 + },
  196 + "return_amount": "125.00",
  197 + "return_coupon_amount": "0.00",
  198 + "express_number": "44323566",
  199 + "return_amount_total": "125.00",
  200 + "return_amount_info": "",
  201 + "return_amount_mode_info": []
  202 + },
  203 + "md5": "6fa464cf72538ad2c25fa24d20dcdd20"
  204 +}
  205 +
  206 +}
  207 +```
  208 +
  209 +### 4、保存快递信息(app.refund.setexpress)
  210 +
  211 +#### 请求参数
  212 +| Param Name | Param Type | Required | Param Value | Desc |
  213 +| :-- | --: | --: | --: | --: |
  214 +| method | String | true | app.refund.setexpress| 请求方法|
  215 +| id |int | true | 428120 |退货申请ID |
  216 +| uid | int | true | 362729 |用户ID |
  217 +| express_company |String | true | 南京ems |快递公司名称|
  218 +| express_number |String | true | 44323575 |快递单号 |
  219 +| express_id |int | true | 2 |快递公司ID |
  220 +
  221 +#### 响应内容
  222 +```json
  223 +{
  224 + "code": 200,
  225 + "message": "快递单号设置成功",
  226 + "data": [],
  227 + "md5": "93311f762194b751872601b67fad53f7"
  228 +}
  229 +or
  230 +{
  231 + "code": 412,
  232 + "message": "没有找到该退货申请"
  233 +}
  234 +
  235 +```