戴晖 / API-Interfaces · Commits

Go to a project

Authored by qianjun
Commit aba6b28dfa00a710b087fe6b1cd492e2ca151642 1 parent f7c13350

refund express

Inline Side-by-side
Showing 2 changed files with 439 additions and 447 deletions
1 -# 订单服务接口 1 +# 物流服务接口
2 2
3 ## 接口列表 3 ## 接口列表
4 | 接口名称 | 接口描述 | 4 | 接口名称 | 接口描述 |
5 | --------| -------- | 5 | --------| -------- |
6 -|[订单列表](#1)||  
7 -|[订单详情](#2)||  
8 -|[取消订单](#3)||  
9 -|[删除订单](#4)||  
10 -|[确认订单](#5)||  
11 -|[获取电子票列表](#6)||  
12 -|[获取YOHO赠品](#7-yoho)||  
13 -|[购物车列表](#8)||  
14 -|[获取待处理订单总数](#9)||  
15 - 6 +|[app.express.getExpressCompany](#1)|获取物流公司列表|
  7 +|[app.express.getNewExpress](#2)|获取最新退换货物流信息|
  8 +|[app.express.getRefundExpress](#3)|获取退换货物流信息|
16 9
17 10
18 ## 接口描述 11 ## 接口描述
19 12
20 -### 1、订单列表 13 +### 1、获取物流公司列表(app.express.getExpressCompany)
21 14
22 -#### 说明  
23 -订单列表  
24 #### 请求参数 15 #### 请求参数
25 | Param Name | Param Type | Required | Param Value | Desc | 16 | Param Name | Param Type | Required | Param Value | Desc |
26 | :-- | --: | --: | --: | --: | 17 | :-- | --: | --: | --: | --: |
27 -| method | string | true | app.SpaceOrders.get| 请求方法 不可变 |  
28 -| uid | int | true | 1 | |  
29 -| type | int | true | 1 | 订单类型 1:全部订单,2:待付款,3:待发货,4:待收货,5:待评论/成功订单,7:失败/取消 |  
30 -| page | int | false | 1 | 页数 |  
31 -| limit | int | false | 10 | 每页大小 | 18 +| method | String | true | app.express.getExpressCompany| 请求方法|
  19 +| status | int | false | 1(默认值) | 物流公司启用状态 1开启，0关闭 默认开启 |
32 20
33 -#### 响应内容 21 +#### 响应内容 按公司首字母排序
34 ```json 22 ```json
35 { 23 {
36 - "code": 200,  
37 - "data": {  
38 - "order_list": [  
39 - {  
40 - "id": "5528982",  
41 - "order_code": "1519273880",  
42 - "parent_order_code": "0",  
43 - "order_type": 1,  
44 - "refund_status": 0,  
45 - "uid": "5772257",  
46 - "create_time": "1449633428",  
47 - "update_time": "1449633455",  
48 - "pay_expire": "2015-12-09 13:57:08",  
49 - "payment": "2",  
50 - "payment_status": "Y",  
51 - "payment_type": "1",  
52 - "payment_type_str": "在线支付",  
53 - "status": 1,  
54 - "status_str": "已付款",  
55 - "attribute": "5",  
56 - "is_cancel": "N",  
57 - "is_comment": "N",  
58 - "amount": "1.00",  
59 - "shipping_cost": "0.00",  
60 - "use_limit_code": "N",  
61 - "user_confirm_paid": "N",  
62 - "buy_total": 1,  
63 - "order_goods": [  
64 - {  
65 - "buy_number": 1,  
66 - "goods_id": 125106,  
67 - "goods_image": "http://img10.static.yhbimg.com/goodsimg/2014/06/19/02/0118c2721e4f2219f69539dd389f4bacac.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",  
68 - "goods_price": "1.00",  
69 - "goods_type": "ordinary",  
70 - "goods_amount": "1.00",  
71 - "product_id": 84230,  
72 - "product_name": "004 满版龙纹迷彩七分休闲裤",  
73 - "product_skn": 51055461,  
74 - "refund_num": 0,  
75 - "size_name": "M",  
76 - "color_name": "彩色",  
77 - "cn_alphabet": "004QiFenBuKu004PA095",  
78 - "expect_arrival_time": ""  
79 - }  
80 - ]  
81 - }  
82 - ],  
83 - "page": 1,  
84 - "page_total": 27,  
85 - "total": 265  
86 - },  
87 - "message": "ok" 24 + "code": 200,
  25 + "data": {
  26 + "E": [
  27 + {
  28 + "company_alif": "E",
  29 + "company_code": "ems",
  30 + "company_name": "南京ems",
  31 + "company_name_substr": "南京ems",
  32 + "id": 2,
  33 + "is_first": "Y"
  34 + }
  35 + ],
  36 + "H": [
  37 + {
  38 + "company_alif": "H",
  39 + "company_code": "huitongkuaidi",
  40 + "company_name": "汇通快运",
  41 + "company_name_substr": "汇通快运",
  42 + "id": 37,
  43 + "is_first": "Y"
  44 + }
  45 + ],
  46 + "J": [
  47 + {
  48 + "company_alif": "J",
  49 + "company_code": "jd",
  50 + "company_name": "京东快递",
  51 + "company_name_substr": "京东快递",
  52 + "id": 46,
  53 + "is_first": "Y"
  54 + }
  55 + ],
  56 + "S": [
  57 + {
  58 + "company_alif": "S",
  59 + "company_code": "shunfeng",
  60 + "company_name": "顺丰",
  61 + "company_name_substr": "顺丰",
  62 + "id": 23,
  63 + "is_first": "Y"
  64 + },
  65 + {
  66 + "company_alif": "S",
  67 + "company_code": "shentong",
  68 + "company_name": "申通",
  69 + "company_name_substr": "申通",
  70 + "id": 36,
  71 + "is_first": "N"
  72 + }
  73 + ],
  74 + "T": [
  75 + {
  76 + "company_alif": "T",
  77 + "company_code": "tonghetianxia",
  78 + "company_name": "通和天下",
  79 + "company_name_substr": "通和天下",
  80 + "id": 30,
  81 + "is_first": "Y"
  82 + }
  83 + ],
  84 + "Y": [
  85 + {
  86 + "company_alif": "Y",
  87 + "company_code": "yuantong",
  88 + "company_name": "圆通",
  89 + "company_name_substr": "圆通",
  90 + "id": 29,
  91 + "is_first": "Y"
  92 + },
  93 + {
  94 + "company_alif": "Y",
  95 + "company_code": "youshuwuliu",
  96 + "company_name": "优速快递",
  97 + "company_name_substr": "优速快递",
  98 + "id": 32,
  99 + "is_first": "N"
  100 + },
  101 + {
  102 + "company_alif": "Y",
  103 + "company_code": "yunda",
  104 + "company_name": "韵达",
  105 + "company_name_substr": "韵达",
  106 + "id": 39,
  107 + "is_first": "N"
  108 + }
  109 + ],
  110 + "Z": [
  111 + {
  112 + "company_alif": "Z",
  113 + "company_code": "zhaijisong",
  114 + "company_name": "南京ZJS",
  115 + "company_name_substr": "南京ZJS",
  116 + "id": 5,
  117 + "is_first": "Y"
  118 + }
  119 + ]
  120 + },
  121 + "md5": "c773c50ba3acedff6feacace3f95e468",
  122 + "message": "物流公司"
88 } 123 }
89 ``` 124 ```
90 ##### 响应内容描述 125 ##### 响应内容描述
91 | Param Name | Param Type | Desc | 126 | Param Name | Param Type | Desc |
92 | ---------- | ---------- | ---- | 127 | ---------- | ---------- | ---- |
93 -| page | int | 当前页数 |  
94 -| page_total | int | 总页数 |  
95 -| total | int | 总记录数 |  
96 -| order_list | json | 订单列表 |  
97 -| id | string | |  
98 -| order_code | string | |  
99 -| parent_order_code | string | |  
100 -| order_type | int | 订单类型 1:有货,3:iphone,4:android,5:淘宝,6:h5,7:是换货,9:渠道,20:ipad |  
101 -| refund_status | int | 退货状态（该字段基本不用了）0:正常订单,1:退货审核中,2:退货审核不通过,3:退货审核通过,4:退货商品寄回,5:退货库房入库,6:财务退款,7:完成 |  
102 -| uid | string | |  
103 -| create_time| string | 创建时间 |  
104 -| update_time| string | 更新时间 |  
105 -| pay_expire | string | 支付超期时间 |  
106 -| payment | string | 支付方式编号 |  
107 -| payment_status | string | 支付状态 Y:已支付,N:未支付 |  
108 -| payment_type | string | 支付方式 1:在线支付,2:货到付款,3:现金支付,4:抵消支付 |  
109 -| status | int | 状态 0:待付款,1-3:待发货,4-5:待收货(0:未付款,1:已付款,2:备货中,3:配货中,4:已发货,5:运输中,6:已完成)|  
110 -| status_str | string | 状态名称 |  
111 -| is_cancel | string | 是否取消 Y:已取消,N:未取消 |  
112 -| is_comment | string | 是否评论 Y:已评论,N:未评论 |  
113 -| amount | string | 订单金额 |  
114 -| shipping_cost | string | 运费 |  
115 -| use_limit_code | string | 使用限购码 Y:使用,N:未使用 |  
116 -| user_confirm_paid| string | 用户确认支付 Y:是,N:否 |  
117 -| buy_total | int | 购买商品数量 |  
118 -| order_goods| json | 购买商品 |  
119 -| buy_number | int | 购买商品数量 |  
120 -| goods_id | int | |  
121 -| goods_image| string | 商品默认图片 |  
122 -| goods_price| string | 商品价格 |  
123 -| goods_type | string | 商品类型 ordinary:普通商品 |  
124 -| goods_amount | string | 商品总价格 |  
125 -| product_id | int | |  
126 -| product_name | string | 商品名称 |  
127 -| product_skn| int | 商品skn |  
128 -| refund_num | int | 退货数量 |  
129 -| size_name | string | 商品尺寸 |  
130 -| color_name | string | 商品颜色 |  
131 -| cn_alphabet| string | |  
132 -| expect_arrival_time | string | 预期到货时间 |  
133 - 128 +| company_alif | String | 物流公司首字母 |
  129 +| company_code | String | 物流公司编码|
  130 +| company_name | String | 物流公司名称 |
  131 +| company_name_substr| String | 物流公司子字符串 |
  132 +| id | int |物流公司ID |
  133 +| is_first | String |是否首次 |
134 134
135 -### 3、取消订单 135 +### 2、获取最新退换货物流信息(app.express.getNewExpress)
136 136
137 -#### 说明  
138 -根据订单号取消订单  
139 #### 请求参数 137 #### 请求参数
140 -| Param Name | Param Value | Desc|  
141 -| :-------- | --------------:|----:|  
142 -| method | app.SpaceOrders.close| 请求方法 |  
143 -| order_code | 1061003682 | 订单号 | 138 +| Param Name | Param Type | Required | Param Value | Desc |
  139 +| :-- | --: | --: | --: | --: |
  140 +| method | String | true | app.express.getNewExpress| 请求方法|
  141 +| id | int |true | 428106 | 退换货申请ID|
  142 +| uid | int |true | 362719 |用户ID |
  143 +| type | String |true | refund | 类型 （退货：refund,换货：change）|
144 144
145 -#### 响应内容 145 +#### 响应内容 按公司首字母排序
146 ```json 146 ```json
147 { 147 {
148 -"code":200,  
149 -"message":"订单取消成功" 148 + "code": 200,
  149 + "message": "成功获取物流信息",
  150 + "data": {
  151 + "url": "http://www.ems.com.cn/",
  152 + "logo": "http://img12.static.yhbimg.com/taobaocms/2015/08/17/07/02fa410769cbbc3c4b59d6a804a3b8d98e.png",
  153 + "caption": "南京ems",
  154 + "is_support": "3",
  155 + "express_number": "44323566",
  156 + "express_detail": []
  157 + },
  158 + "md5": "3fc5f5f1ea744d14ad4c4ae54e7cf143"
150 } 159 }
151 -```  
152 -  
153 -### 5、确认订单  
154 -  
155 -#### 说明  
156 -根据订单号确认订单  
157 -#### 请求参数  
158 -| Param Name | Param Value | Desc|  
159 -| :-------- | --------------:|----:|  
160 -| method | app.SpaceOrders.confirm| 请求方法 |  
161 -| order_code | 1061003682 | 订单号 |  
162 160
163 -#### 响应内容  
164 -```json  
165 -{  
166 -"code":200,  
167 -"message":"订单确认成功"  
168 -}  
169 -```  
170 -  
171 -  
172 -### 6、获取电子票列表  
173 -  
174 -  
175 -  
176 -#### 说明  
177 -根据订单号获取电子票列表  
178 -#### 请求参数  
179 -| Param Name | Param Value | Desc|  
180 -| :-------- | --------------:|----:|  
181 -| method | app.SpaceOrders.getQrByOrderCode| 请求方法 |  
182 -| order_code | 1061003682 | 订单号 |  
183 -  
184 -#### 响应内容  
185 -```json  
186 -{  
187 - "code": 200,  
188 - "data": {  
189 - "ticks": [{  
190 - "ticket_code":"8611779901",  
191 - "qr_image":"http://img06.static.yhbimg.com/yohood/4063/ticket-8611779901-1-40-1-1.jpg",  
192 - "passkit":"Y"  
193 - }],  
194 - "title": "FURY ANIMALS Normal迷彩系列BUNNY短袖TEE"  
195 - },  
196 - "md5": "24aff7ba505dccb63a14b5d78ae22821",  
197 - "message": "ok"  
198 -}  
199 ``` 161 ```
200 ##### 响应内容描述 162 ##### 响应内容描述
201 | Param Name | Param Type | Desc | 163 | Param Name | Param Type | Desc |
202 | ---------- | ---------- | ---- | 164 | ---------- | ---------- | ---- |
203 -| title | string | 商品名称 |  
204 -| ticks | json | 电子票 |  
205 -| ticket_code| string | 电子票code |  
206 -| qr_image | string | 电子票code二维码图片路径 |  
207 -| passkit | string | |  
208 -  
209 -### 7、获取YOHO赠品  
210 -  
211 -#### 说明  
212 -根据skn获取yohoGift  
213 -#### 请求参数  
214 -| Param Name | Param Value | Desc|  
215 -| :-------- | --------------:|----:|  
216 -| method | web.Shopping.yohoGift| 请求方法 |  
217 -| skn_list | [50001829,50002280]| skn列表 |  
218 -  
219 -#### 响应内容  
220 -```json  
221 - {  
222 - "alg": "SALT_MD5",  
223 - "code": 200,  
224 - "data":  
225 - [  
226 - {  
227 - "default_pic": "http://img11.static.yhbimg.com/goodsimg/2012/03/02/17/019a0794f1eb1ad77ce5d8a2c2b2cf2e50.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",  
228 - "id": 3,  
229 - "price":  
230 - {  
231 - "sales_price": 250,  
232 - "yoho_coin_num": 0  
233 - },  
234 - "product_name": "OVERKILL 天使山羊TEE",  
235 - "storage": 0,  
236 - "storage_list":  
237 - [  
238 - {  
239 - "erp_sku_id": 102009,  
240 - "goods_dimension_id": 201,  
241 - "goods_id": 3,  
242 - "product_id": 3,  
243 - "size":  
244 - {  
245 - "size_name": "L"  
246 - },  
247 - "storage_num": 0  
248 - },  
249 - {  
250 - "erp_sku_id": 102010,  
251 - "goods_dimension_id": 203,  
252 - "goods_id": 3,  
253 - "product_id": 3,  
254 - "size":  
255 - {  
256 - "size_name": "M"  
257 - },  
258 - "storage_num": 0  
259 - },  
260 - {  
261 - "erp_sku_id": 102012,  
262 - "goods_dimension_id": 211,  
263 - "goods_id": 3,  
264 - "product_id": 3,  
265 - "size":  
266 - {  
267 - "size_name": "XL"  
268 - },  
269 - "storage_num": 0  
270 - }  
271 - ],  
272 - "url": "http://www.yohobuy.com/product/pro_3_3/OVERKILL TianShiShanYangTEE.html"  
273 - },  
274 - {  
275 - "default_pic": "http://img10.static.yhbimg.com/goodsimg/2011/06/23/04/0158a984a768a351328138ea3671e270de.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",  
276 - "id": 5,  
277 - "price":  
278 - {  
279 - "sales_price": 138,  
280 - "yoho_coin_num": 0  
281 - },  
282 - "product_name": "MANIA TAKI X 圆领印花短袖TEE",  
283 - "storage": 0,  
284 - "storage_list":  
285 - [  
286 - {  
287 - "erp_sku_id": 102015,  
288 - "goods_dimension_id": 213,  
289 - "goods_id": 5,  
290 - "product_id": 5,  
291 - "size":  
292 - {  
293 - "size_name": "XS"  
294 - },  
295 - "storage_num": 0  
296 - }  
297 - ],  
298 - "url": "http://www.yohobuy.com/product/pro_5_5/MANIA TAKI X YuanLingYinHuaDuanXiuTEE.html"  
299 - }  
300 - ],  
301 - "md5": "d6e4c90434e98a90555d864cf4798679",  
302 - "message": "操作成功"  
303 - }  
304 -``` 165 +| url | String | 物流公司网址 |
  166 +| logo | String | 物流公司logo|
  167 +| caption | String | 物流公司名称 |
  168 +| is_support | String|返回状态(1:查询到物流信息 2:不支持物流公司 3:没有找到物流信息) |
  169 +| express_number| String | 快递单号 |
  170 +| express_detail | json数组 |物流详情 |
305 171
306 -### 8、购物车列表  
307 -  
308 -#### 说明 172 +### 3、获取退换货物流信息(app.express.getRefundExpress)
309 173
310 #### 请求参数 174 #### 请求参数
311 -| Param Name | Param Value | Desc|  
312 -| :-------- | --------------:|----:|  
313 -| method | app.Shopping.cart| 请求方法 |  
314 -| shopping_key | 9c101f734768105aafc792d460d12206 | |  
315 -| uid | 10166061 | | 175 +| Param Name | Param Type | Required | Param Value | Desc |
  176 +| :-- | --: | --: | --: | --: |
  177 +| method | String | true | app.express.getRefundExpress| 请求方法|
  178 +| express_id | int |true | 23 | 快递公司ID|
  179 +| express_number | String |true | 800481228670 |快递单号 |
316 180
317 -#### 响应内容 181 +#### 响应内容 按公司首字母排序
318 ```json 182 ```json
319 { 183 {
320 "code": 200, 184 "code": 200,
321 - "data": {  
322 - "advance_cart_data": {  
323 - "gift_list": [],  
324 - "goods_list": [],  
325 - "price_gift": [],  
326 - "promotion_info": [],  
327 - "shopping_cart_data": {  
328 - "discount_amount": 0,  
329 - "fast_shopping_cost": 0,  
330 - "gain_yoho_coin": 0,  
331 - "goods_count": 0,  
332 - "last_order_amount": 0,  
333 - "order_amount": 0,  
334 - "promotion_formula": "总计¥0.00=商品金额¥0.00",  
335 - "promotion_formula_list": [  
336 - {  
337 - "promotion": "商品金额",  
338 - "promotion_amount": "¥0.00"  
339 - }  
340 - ],  
341 - "selected_goods_count": 0,  
342 - "shipping_cost": 0,  
343 - "str_discount_amount": "¥0.00",  
344 - "str_order_amount": "¥0.00"  
345 - },  
346 - "sold_out_goods_list": [] 185 + "data": [
  186 + {
  187 + "acceptTime": "2014-12-06 12:38:24",
  188 + "accept_address": "客户 签收人: 林汐 已签收",
  189 + "express_id": 3,
  190 + "express_number": "800481228670",
  191 + "order_code": 412506421
347 }, 192 },
348 - "ordinary_cart_data": {  
349 - "gift_list": [],  
350 - "goods_list": [  
351 - {  
352 - "attribute": "1",  
353 - "brand_id": "350",  
354 - "buy_limit": 0,  
355 - "buy_number": "1",  
356 - "color_id": "7",  
357 - "color_name": "蓝色",  
358 - "expect_arrival_time": "",  
359 - "fit_promotions": [  
360 - "8579",  
361 - "8479",  
362 - "8477",  
363 - "8475"  
364 - ],  
365 - "get_yoho_coin": "0",  
366 - "goods_id": "404795",  
367 - "goods_images": "http://....jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",  
368 - "goods_type": "ordinary",  
369 - "is_advance": "N",  
370 - "is_jit": "N",  
371 - "is_limited": "N",  
372 - "is_outlets": "N",  
373 - "is_special": "N",  
374 - "last_price": "319.0",  
375 - "last_vip_price": 369,  
376 - "market_price": 369,  
377 - "max_sort_id": "7",  
378 - "middle_sort_id": "49",  
379 - "product_id": 314449,  
380 - "product_name": "MACROPUS 复古帆布系列 双肩包(男女通用)",  
381 - "product_skc": "306652",  
382 - "product_skn": "51174830",  
383 - "product_sku": "967008",  
384 - "promotion_flag": "103",  
385 - "promotion_id": "0",  
386 - "real_price": 319,  
387 - "real_vip_price": 0,  
388 - "sale_price": 0,  
389 - "sales_price": 369,  
390 - "selected": "Y",  
391 - "shop_id": 0,  
392 - "shopping_cart_goods_id": "94305847",  
393 - "shopping_cart_id": "130769237",  
394 - "size_id": "199",  
395 - "size_name": "F",  
396 - "small_sort_id": "152",  
397 - "storage_number": "99",  
398 - "str_subtotal": "¥369.00",  
399 - "subtotal": 369,  
400 - "supplier_id": 0,  
401 - "uid": "10166061",  
402 - "vip1_price": "350.55",  
403 - "vip2_price": "332.10",  
404 - "vip3_price": "324.72",  
405 - "vip_discount": 1,  
406 - "vip_discount_money": 0,  
407 - "vip_discount_type": "1",  
408 - "vip_price": 0,  
409 - "yoho_coin_num": "0"  
410 - }  
411 - ],  
412 - "price_gift": [  
413 - {  
414 - "gift_price": 39,  
415 - "goods_list": [  
416 - {  
417 - "goods_images": "http://...jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",  
418 - "last_price": 39,  
419 - "market_price": 90,  
420 - "product_id": 269401,  
421 - "product_name": "VOCHIC 欧式多用抗菌艺术砧板",  
422 - "product_skn": 51150012,  
423 - "sales_price": 49,  
424 - "storage_number": 150  
425 - }  
426 - ],  
427 - "max_select_number": "1",  
428 - "promotion_id": 8475,  
429 - "promotion_title": "【全场39元加价购】",  
430 - "promotion_type": "Needpaygift"  
431 - }  
432 - ],  
433 - "promotion_info": [  
434 - {  
435 - "cutdown_amount": 50,  
436 - "promotion_id": 8579,  
437 - "promotion_title": "【包配随行】满￥299减￥50",  
438 - "promotion_type": "Cashreduce"  
439 - }  
440 - ],  
441 - "shopping_cart_data": {  
442 - "discount_amount": 50,  
443 - "fast_shopping_cost": 15,  
444 - "gain_yoho_coin": 0,  
445 - "goods_count": 1,  
446 - "last_order_amount": 319,  
447 - "order_amount": 369,  
448 - "promotion_formula": "总计¥319.00=商品金额¥369.00-活动金额¥50.00",  
449 - "promotion_formula_list": [  
450 - {  
451 - "promotion": "商品金额",  
452 - "promotion_amount": "¥369.00"  
453 - }  
454 - ],  
455 - "selected_goods_count": 1,  
456 - "shipping_cost": 10,  
457 - "str_discount_amount": "¥50.00",  
458 - "str_order_amount": "¥369.00"  
459 - },  
460 - "sold_out_goods_list": [] 193 + {
  194 + "acceptTime": "2014-12-06 08:58:31",
  195 + "accept_address": "北京市通州区城区公司 派件人: 徐宏博 派件中 派件员电话18911353205",
  196 + "express_id": 3,
  197 + "express_number": "800481228670",
  198 + "order_code": 412506421
  199 + },
  200 + {
  201 + "acceptTime": "2014-12-06 07:51:43",
  202 + "accept_address": "快件到达 北京市通州区城区公司",
  203 + "express_id": 3,
  204 + "express_number": "800481228670",
  205 + "order_code": 412506421
  206 + },
  207 + {
  208 + "acceptTime": "2014-12-05 18:28:25",
  209 + "accept_address": "北京转运中心公司 已发出,下一站 北京市通州区城区",
  210 + "express_id": 3,
  211 + "express_number": "800481228670",
  212 + "order_code": 412506421
  213 + },
  214 + {
  215 + "acceptTime": "2014-12-05 18:26:21",
  216 + "accept_address": "快件到达 北京转运中心公司",
  217 + "express_id": 3,
  218 + "express_number": "800481228670",
  219 + "order_code": 412506421
  220 + },
  221 + {
  222 + "acceptTime": "2014-12-04 19:44:16",
  223 + "accept_address": "江苏省南京市雨花区板桥公司 已打包,发往下一站 北京转运中心",
  224 + "express_id": 3,
  225 + "express_number": "800481228670",
  226 + "order_code": 412506421
  227 + },
  228 + {
  229 + "acceptTime": "2014-12-04 18:44:41",
  230 + "accept_address": "快件到达 江苏省南京市雨花区板桥公司",
  231 + "express_id": 3,
  232 + "express_number": "800481228670",
  233 + "order_code": 412506421
461 } 234 }
462 - },  
463 - "md5": "d222cf08c9d43d0c5f3ab31d278cabd8",  
464 - "message": "cart goods list."  
465 -} 235 + ],
  236 + "md5": "74b36d9c9b9ff658eac1b46c196dbc99",
  237 + "message": "物流信息"
466 ``` 238 ```
467 -  
468 -  
469 -### 9、获取待处理订单总数  
470 -  
471 -#### 说明  
472 -根据获取待处理订单总数  
473 -#### 请求参数  
474 -| Param Name | Param Value | Desc |  
475 -| ---------- | ----------- | ---- |  
476 -| method | web.SpaceOrders.getPendingOrderCount| 请求方法 |  
477 -| uid | 5772257 | |  
478 -  
479 -#### 响应内容  
480 -  
481 -```json  
482 -{  
483 - "code": 200,  
484 - "message": "操作成功"  
485 - "data": {  
486 - "count": 100  
487 - }  
488 -}  
489 -```  
  239 +##### 响应内容描述
  240 +| Param Name | Param Type | Desc |
  241 +| ---------- | ---------- | ---- |
  242 +| acceptTime | String | 运货单创建时间 |
  243 +| accept_address | String | 运货单接收地址|
  244 +| express_id | int | 快递公司ID|
  245 +| express_number | String |快递单号 |
  246 +| order_code| long | 订单号 |
  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 +```