ttj1314 / API-Interfaces · Commits

Go to a project

Authored by maelk-liu
Commit 6dab1c41553ca51973d038c6fc9c893c50c37083 1 parent 391193cf

增加接口 app.refund.getList

Inline Side-by-side
Showing 1 changed file with 355 additions and 235 deletions
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 -``` 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 +|[app.refund.getList](#5)|查询退换货列表|
  11 +
  12 +
  13 +## 接口描述
  14 +
  15 +### 1、获取退货订单商品列表(app.refund.goodsList)
  16 +
  17 +#### 请求参数
  18 +| Param Name | Param Type | Required | Param Value | Desc |
  19 +| :-- | --: | --: | --: | --: |
  20 +| method | String | true | app.refund.goodsList| 请求方法|
  21 +| uid | int | true | 7893817 |用户ID |
  22 +| order_code |long | true | 1613656852 |订单号 |
  23 +
  24 +#### 响应内容
  25 +```json
  26 +{
  27 + "code": 200,
  28 + "data": {
  29 + "coupon_amount": "0.00",
  30 + "goods_list": [
  31 + {
  32 + "color_name": "蓝色",
  33 + "goods_id": 355897,
  34 + "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",
  35 + "goods_type": "ordinary",
  36 + "goods_type_id": 1,
  37 + "hasShoes": 0,
  38 + "last_price": "149.00",
  39 + "product_id": 275357,
  40 + "product_name": "Life•After Life X The Simpsons 辛普森一家刺绣牛津纺衬衫",
  41 + "product_skc": 280039,
  42 + "product_skn": 51153138,
  43 + "product_sku": 894428,
  44 + "size_name": "M"
  45 + }
  46 + ],
  47 + "return_amount_info": "",
  48 + "return_amount_mode": [
  49 + {
  50 + "id": 1,
  51 + "is_default": "Y",
  52 + "name": "原卡返还"
  53 + }
  54 + ],
  55 + "return_reason": [
  56 + {
  57 + "id": 3,
  58 + "name": "不喜欢"
  59 + },
  60 + {
  61 + "id": 2,
  62 + "name": "性价比不高"
  63 + },
  64 + {
  65 + "id": 11,
  66 + "name": "价格变化"
  67 + },
  68 + {
  69 + "id": 4,
  70 + "name": "质量瑕疵"
  71 + },
  72 + {
  73 + "id": 1,
  74 + "name": "尺寸不合适"
  75 + },
  76 + {
  77 + "id": 7,
  78 + "name": "商品有色差"
  79 + },
  80 + {
  81 + "id": 8,
  82 + "name": "图片与实物不符"
  83 + },
  84 + {
  85 + "id": 6,
  86 + "name": "发错货"
  87 + },
  88 + {
  89 + "id": 5,
  90 + "name": "快递延迟"
  91 + }
  92 + ],
  93 + "yoho_coin_num": "0.00"
  94 + },
  95 + "md5": "72879cfb65bcd2705e4283d2f5dc1a30",
  96 + "message": "Refund goods list"
  97 +}
  98 +```
  99 +
  100 +
  101 +### 2、提交退货申请(app.refund.submit)
  102 +
  103 +#### 请求参数
  104 +| Param Name | Param Type | Required | Param Value | Desc |
  105 +| :-- | --: | --: | --: | --: |
  106 +| method | String | true |app.refund.submit| 请求方法|
  107 +| order_code |long | true | 1512253171 |订单号 |
  108 +| uid | int | true |8040274 |用户ID |
  109 +| area_code |String | false | " " (默认值为空) |地区编号|
  110 +| goods |String(json数组) | true | [{"goods_type":"1","last_price":"18.00","product_skc":"83007","product_skn":"51001899","product_sku":"307528","remark":" ","returned_reason":1}] |退货商品 |
  111 +| payment |String(json对象) | true | {"alipay_account":" ","alipay_name":" ","area_code":"320115","bank_card":" ","bank_name":" ","city":" ","payee_name":" ","province":" ","remark":" ","return_amount_mode":"1"} |退款设置|
  112 +
  113 +#### 响应内容
  114 +```json
  115 +{
  116 + "code": 200,
  117 + "message": "退货申请成功",
  118 + "data": {
  119 + "apply_id": "428135"
  120 + },
  121 + "md5": "2d4a86d3d308cf8cbdd9870ebd61a3a4"
  122 +}
  123 +```
  124 +##### 响应内容描述
  125 +| Param Name | Param Type | Desc |
  126 +| ---------- | ---------- | ---- |
  127 +| apply_id | String | 退货申请ID |
  128 +
  129 +
  130 +### 3、退货详情(app.refund.detail)
  131 +
  132 +#### 请求参数
  133 +| Param Name | Param Type | Required | Param Value | Desc |
  134 +| :-- | --: | --: | --: | --: |
  135 +| method | String | true | app.refund.detail| 请求方法|
  136 +| id |int | true | 428106 |退货申请ID |
  137 +| uid | int | true | 362719 |用户ID |
  138 +
  139 +
  140 +#### 响应内容
  141 +```json
  142 +{
  143 + "code": 200,
  144 + "message": "退货详情",
  145 + "data": {
  146 + "source_order_code": "1513540278",
  147 + "use_yoho_coin_num": null,
  148 + "status": "20",
  149 + "status_name": "商品寄回",
  150 + "statusList": [
  151 + {
  152 + "name": "提交申请",
  153 + "act": "Y"
  154 + },
  155 + {
  156 + "name": "审核通过",
  157 + "act": "Y"
  158 + },
  159 + {
  160 + "name": "商品寄回",
  161 + "act": "Y"
  162 + },
  163 + {
  164 + "name": "商品入库",
  165 + "act": "N"
  166 + },
  167 + {
  168 + "name": "退款完成",
  169 + "act": "N"
  170 + }
  171 + ],
  172 + "create_time": "2015-11-23 20:20:12",
  173 + "return_amount_mode_name": "YOHO币",
  174 + "return_amount_mode": "4",
  175 + "return_yoho_coin": "0",
  176 + "goods_list": [
  177 + {
  178 + "product_skn": "51146548",
  179 + "product_name": "我是可爱的小秋秋，james，蔡!",
  180 + "goods_image": "?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/90",
  181 + "size_name": null,
  182 + "color_name": null,
  183 + "sales_price": null,
  184 + "reason": "1",
  185 + "remark": "",
  186 + "reason_name": "尺寸不合适",
  187 + "evidence_images": [],
  188 + "goods_type": "ordinary"
  189 + }
  190 + ],
  191 + "notice": {
  192 + "id": 20,
  193 + "title": "商品寄回物流信息",
  194 + "express_company": "南京ems",
  195 + "express_number": "44323566"
  196 + },
  197 + "return_amount": "125.00",
  198 + "return_coupon_amount": "0.00",
  199 + "express_number": "44323566",
  200 + "return_amount_total": "125.00",
  201 + "return_amount_info": "",
  202 + "return_amount_mode_info": []
  203 + },
  204 + "md5": "6fa464cf72538ad2c25fa24d20dcdd20"
  205 +}
  206 +
  207 +}
  208 +```
  209 +
  210 +### 4、保存快递信息(app.refund.setexpress)
  211 +
  212 +#### 请求参数
  213 +| Param Name | Param Type | Required | Param Value | Desc |
  214 +| :-- | --: | --: | --: | --: |
  215 +| method | String | true | app.refund.setexpress| 请求方法|
  216 +| id |int | true | 428120 |退货申请ID |
  217 +| uid | int | true | 362729 |用户ID |
  218 +| express_company |String | true | 南京ems |快递公司名称|
  219 +| express_number |String | true | 44323575 |快递单号 |
  220 +| express_id |int | true | 2 |快递公司ID |
  221 +
  222 +#### 响应内容
  223 +```json
  224 +{
  225 + "code": 200,
  226 + "message": "快递单号设置成功",
  227 + "data": [],
  228 + "md5": "93311f762194b751872601b67fad53f7"
  229 +}
  230 +or
  231 +{
  232 + "code": 412,
  233 + "message": "没有找到该退货申请"
  234 +}
  235 +
  236 +```
  237 +
  238 +### 5、保存快递信息(app.refund.getList)
  239 +
  240 +#### 请求参数
  241 +| Param Name | Param Type | Required | Param Value | Desc |
  242 +| :-- | --: | --: | --: | --: |
  243 +| method | String | true | app.refund.setexpress| 请求方法|
  244 +| id |int | true | 428120 |退货申请ID |
  245 +| uid | int | true | 362729 |用户ID |
  246 +| express_company |String | true | 南京ems |快递公司名称|
  247 +| express_number |String | true | 44323575 |快递单号 |
  248 +| express_id |int | true | 2 |快递公司ID |
  249 +
  250 +#### 响应内容
  251 +```json
  252 +{
  253 + "alg": "SALT_MD5",
  254 + "code": 200,
  255 + "data": {
  256 + "list": [
  257 + {
  258 + "create_time": "2016-06-17",
  259 + "goods": [
  260 + {
  261 + "cn_alphabet": "TYAKASHANanKuanLvSeJiHeTuAnPinTieTaoTouWeiYiT15DS5075G",
  262 + "color_name": "绿色",
  263 + "goods_id": "385775",
  264 + "goods_image": "http://img10.static.yhbimg.com/goodsimg/2015/11/02/06/01361c1986f1dd2eaff70e1f85a35bfacd.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  265 + "goods_type": "ordinary",
  266 + "product_id": "301131",
  267 + "product_name": "TYAKASHA 男款绿色几何图案拼贴套头卫衣 ",
  268 + "product_skn": "51168269",
  269 + "product_sku": "939124",
  270 + "sales_price": "199",
  271 + "size_name": "F"
  272 + }
  273 + ],
  274 + "id": "125954",
  275 + "order_code": "1610005607",
  276 + "order_create_time": "2016-06-17 14:15:05",
  277 + "refund_type": 2,
  278 + "status": "0",
  279 + "status_name": "提交申请",
  280 + "canCancel":"Y"
  281 + },
  282 + {
  283 + "create_time": "2016-04-21",
  284 + "goods": [
  285 + {
  286 + "cn_alphabet": "ChenShanT009",
  287 + "color_name": "蓝色",
  288 + "goods_id": "337829",
  289 + "goods_image": "http://img10.static.yhbimg.com/goodsimg/2015/11/09/05/01b9378014f8b824306b5308f5d32eadc1.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  290 + "goods_type": "ordinary",
  291 + "product_id": "254145",
  292 + "product_name": "AMES BROS 男潮童110-160码剪裁设计纯色长袖衬衫",
  293 + "product_skn": "51142083",
  294 + "product_sku": "869691",
  295 + "sales_price": "79",
  296 + "size_name": "140"
  297 + },
  298 + {
  299 + "cn_alphabet": "ChenShanT009",
  300 + "color_name": "蓝色",
  301 + "goods_id": "337829",
  302 + "goods_image": "http://img10.static.yhbimg.com/goodsimg/2015/11/09/05/01b9378014f8b824306b5308f5d32eadc1.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  303 + "goods_type": "ordinary",
  304 + "product_id": "254145",
  305 + "product_name": "AMES BROS 男潮童110-160码剪裁设计纯色长袖衬衫",
  306 + "product_skn": "51142083",
  307 + "product_sku": "869690",
  308 + "sales_price": "79",
  309 + "size_name": "130"
  310 + },
  311 + {
  312 + "cn_alphabet": "JiuKouShanTHRIVETHISNEWYEARXianLiangShangWuRenShiHeKaYiTaoJKSHK03",
  313 + "color_name": "彩色",
  314 + "goods_id": "425783",
  315 + "goods_image": "http://img10.static.yhbimg.com/goodsimg/2015/12/22/08/01e056030e9d209714651c54ea150e56d0.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  316 + "goods_type": "gift",
  317 + "product_id": "331145",
  318 + "product_name": "九口山 Thrive this new year 限量商务人士贺卡一套",
  319 + "product_skn": "51185287",
  320 + "product_sku": "1006287",
  321 + "sales_price": "0",
  322 + "size_name": "F"
  323 + },
  324 + {
  325 + "cn_alphabet": "MACROPUSMCPA504BK1101ShuangJianBao",
  326 + "color_name": "灰色",
  327 + "goods_id": "338947",
  328 + "goods_image": "http://img11.static.yhbimg.com/goodsimg/2015/09/29/08/010f35a0adf99c9379548eb7f141839a7a.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  329 + "goods_type": "price_gift",
  330 + "product_id": "260951",
  331 + "product_name": "MACROPUS 简约毛呢双肩包",
  332 + "product_skn": "51146106",
  333 + "product_sku": "870894",
  334 + "sales_price": "11",
  335 + "size_name": "F"
  336 + }
  337 + ],
  338 + "id": "429128",
  339 + "order_code": "16093901",
  340 + "order_create_time": "2016-04-21 14:33:32",
  341 + "refund_type": 1,
  342 + "status": "10",
  343 + "status_name": "审核通过",
  344 + "canCancel":"Y"
  345 + }
  346 + ],
  347 + "page": 1,
  348 + "total": 2,
  349 + "total_page": 1
  350 + },
  351 + "md5": "2c60239ca2b6b218cdcfc4ede865ee08",
  352 + "message": "ok"
  353 +}
  354 +
  355 +```