Showing
1 changed file
with
235 additions
and
0 deletions
订单/修改订单收货地址.md
0 → 100644
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 | +``` |
-
Please register or login to post a comment