周蓉君 / API-Interfaces · Commits

Go to a project

Authored by qianjun
Commit 3fb71b1667ddc3cc5eba709c47fda3a4f766a4ac 1 parent 9cb56e04

update

Inline Side-by-side
Showing 1 changed file with 24 additions and 210 deletions
1 -# 退货服务接口 1 +# 修改订单收货地址服务接口
2 2
3 ## 接口列表 3 ## 接口列表
4 | 接口名称 | 接口描述 | 4 | 接口名称 | 接口描述 |
5 | --------| -------- | 5 | --------| -------- |
6 -|[app.refund.goodsList](#1)|获取退货订单商品列表|  
7 -|[app.refund.submit](#2)|提交退货申请|  
8 -|[app.refund.detail](#3)|退货详情|  
9 -|[app.refund.setexpress](#4)|保存快递信息| 6 +|[app.SpaceOrders.updateDeliveryAddress](#1)|修改订单收货地址|
  7 +|[修改订单收货地址MQ](#2)|修改订单收货地址MQ|
10 8
11 9
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 10
  11 +## 接口描述
128 12
129 -### 3、退货详情(app.refund.detail) 13 +### 1、修改订单收货地址(app.SpaceOrders.updateDeliveryAddress)
130 14
131 #### 请求参数 15 #### 请求参数
132 | Param Name | Param Type | Required | Param Value | Desc | 16 | Param Name | Param Type | Required | Param Value | Desc |
133 | :-- | --: | --: | --: | --: | 17 | :-- | --: | --: | --: | --: |
134 -| method | String | true | app.refund.detail| 请求方法|  
135 -| id |int | true | 428106 |退货申请ID |  
136 -| uid | int | true | 362719 |用户ID |  
137 -  
138 - 18 +| method | String | true | app.SpaceOrders.updateDeliveryAddress| 请求方法|
  19 +| order_code | String | true | "1607472719" |订单号 |
  20 +| user_name | String | true | "周辉" |收货人 |
  21 +| mobile | String | true | "13236587561" |手机 |
  22 +| area_code | String | true | "320105" |地区编号|
  23 +| address | String | true | "南京市建邺区嘉陵江东街18号国家广告产业园5栋17,18楼" |详细地址|
139 #### 响应内容 24 #### 响应内容
140 ```json 25 ```json
141 { 26 {
  27 + "alg": "SALT_MD5",
142 "code": 200, 28 "code": 200,
143 - "message": "退货详情",  
144 "data": { 29 "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" 30 + "relateOrderCode": "N"
165 }, 31 },
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 - 32 + "md5": "1f7d1c5c325209e77f0989134e7a8b67",
  33 + "message": "修改订单收货地址成功"
206 } 34 }
207 ``` 35 ```
  36 +#### 注意 relateOrderCode代表是否有关联其他订单：1. 值为"Y",代表有关联其他订单，提示语，关联订单的收货地址将一起修改且不可修改第二次，请确认是否修改; 2.值为"N",代表没有关联其他订单，提示语，收货地址仅且只能修改1次，请确认是否修改。
208 37
209 -### 4、保存快递信息(app.refund.setexpress) 38 +## 2、修改订单收货地址MQ
210 39
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 | 40 +### MQ消息数据结构
  41 +| | |
  42 +| :-- | :-- |
  43 +| exchanges | amq.topic |
  44 +| route key | order.deliveryAddress |
220 45
221 -#### 响应内容  
222 ```json 46 ```json
223 -{  
224 - "code": 200,  
225 - "message": "快递单号设置成功",  
226 - "data": [],  
227 - "md5": "93311f762194b751872601b67fad53f7"  
228 -}  
229 -or  
230 -{  
231 - "code": 412,  
232 - "message": "没有找到该退货申请"  
233 -}  
234 - 47 +{"address":"南京市建邺区嘉陵江东街18号国家广告产业园5栋17,18楼","area_code":320105,"city":"南京市","district":"建邺区","mobile":"13236587561","order_code":1607472719,"parent_order_code":"","province":"江苏省","user_name":"钱军"}
235 ``` 48 ```
  49 +#### 注意 1.JIT拆单和预售商品拆单有关联其他订单，主订单号parent_order_code为1607472719，是数字类型；2.没有关联其他订单，主订单号parent_order_code为空字符串""，是字符串类型。