Showing
2 changed files
with
373 additions
and
30 deletions
订单/MQ.md
0 → 100644
1 | +## 确认订单 | ||
2 | + | ||
3 | +### MQ消息数据结构 | ||
4 | +| | | | ||
5 | +| :-- | :-- | | ||
6 | +| exchanges | amq.topic | | ||
7 | +| route key | order.orderStatus | | ||
8 | + | ||
9 | +```json | ||
10 | +{"orderCode":100000,"status":700} | ||
11 | +``` | ||
12 | + | ||
13 | +## 取消订单 | ||
14 | + | ||
15 | +### MQ消息数据结构 | ||
16 | +| | | | ||
17 | +| :-- | :-- | | ||
18 | +| exchanges | amq.topic | | ||
19 | +| route key | order.orderStatus | | ||
20 | + | ||
21 | +> 用户主动取消 | ||
22 | +```json | ||
23 | +{"order_code":100000,"status":900} | ||
24 | +``` | ||
25 | +> 系统自动取消 | ||
26 | +```json | ||
27 | +{"order_code":100000,"status":906} | ||
28 | +``` | ||
29 | + | ||
30 | +## 订单状态同步 | ||
31 | + | ||
32 | +### MQ消息数据结构 | ||
33 | +| | | | ||
34 | +| :-- | :-- | | ||
35 | +| exchanges | amq.topic | | ||
36 | +| route key | order.erpstatus | | ||
37 | + | ||
38 | + | ||
39 | +> 修改订单收货人地址 | ||
40 | +```json | ||
41 | +{"order_code":100000,"status":200} | ||
42 | +``` | ||
43 | +### 注意:200是已标记状态,准备打印地址单 | ||
44 | + | ||
45 | +> 已交寄 | ||
46 | +```json | ||
47 | +{ | ||
48 | + "order_code":100000, | ||
49 | + "status":600, | ||
50 | + "data":{ | ||
51 | + "express_id": 23, | ||
52 | + "express_number":"25276134639" | ||
53 | + } | ||
54 | +} | ||
55 | +``` | ||
56 | +> 订单妥投 | ||
57 | +```json | ||
58 | +{"order_code":100000,"status":700} | ||
59 | +``` | ||
60 | +> 客服取消 | ||
61 | +```json | ||
62 | +{"order_code":100000,"status":901} | ||
63 | +``` | ||
64 | +> 系统自动取消 | ||
65 | +```json | ||
66 | +{"order_code":100000,"status":906} | ||
67 | +``` | ||
68 | + | ||
69 | + | ||
70 | +## 前台创建换货单 | ||
71 | +### MQ消息数据结构 | ||
72 | +| | | | ||
73 | +| :-- | :-- | | ||
74 | +| exchanges | amq.topic | | ||
75 | +| route key | order.createChangeOrder | | ||
76 | + | ||
77 | +```json | ||
78 | +{ | ||
79 | + "id": 1, | ||
80 | + "city": "南京市", | ||
81 | + "area_code": "320115", | ||
82 | + "address": "江宁经济技术开发区苏源大道87号(有货物流中心订单组)", | ||
83 | + "consignee_name": "测试", | ||
84 | + "county": "江宁区", | ||
85 | + "delivery_tpye": 10, | ||
86 | + "email": "", | ||
87 | + "exchange_mode": 10, | ||
88 | + "mobile": "13776693005", | ||
89 | + "order_code": 16062099, | ||
90 | + "init_order_code": 16062099, | ||
91 | + "source_order_code": 16062099, | ||
92 | + "province": "江苏省", | ||
93 | + "receipt_time": "2", | ||
94 | + "remark": "用户换货", | ||
95 | + "uid": 8041518, | ||
96 | + "zip_code": "211100", | ||
97 | + "goods": [ | ||
98 | + { | ||
99 | + "exchange_reason": "3", | ||
100 | + "goods_type": "1", | ||
101 | + "last_price": "88.00", | ||
102 | + "new_goods_id": 354687, | ||
103 | + "new_product_skc": 279434, | ||
104 | + "new_product_sku": 892152, | ||
105 | + "product_skc": 279434, | ||
106 | + "product_skn": 51152761, | ||
107 | + "product_sku": 892152, | ||
108 | + "remark": "" | ||
109 | + } | ||
110 | + ] | ||
111 | +} | ||
112 | +``` | ||
113 | + | ||
114 | +## ERP创建换货单 | ||
115 | +### MQ消息数据结构 | ||
116 | +| | | | ||
117 | +| :-- | :-- | | ||
118 | +| exchanges | amq.topic | | ||
119 | +| route key | erp.createChangeOrder | | ||
120 | + | ||
121 | +> 成功 | ||
122 | + | ||
123 | +```json | ||
124 | +{ | ||
125 | + "code": 200, | ||
126 | + "message": "ok", | ||
127 | + "data": { | ||
128 | + "id": 1, | ||
129 | + "init_order_code": "111", | ||
130 | + "source_order_code": 1111, | ||
131 | + "new_order_code": 1111, | ||
132 | + "exchange_id": 111, | ||
133 | + "returned_id": 111, | ||
134 | + "exchange_status": 10, | ||
135 | + "returned_status": 10 | ||
136 | + } | ||
137 | +} | ||
138 | +``` | ||
139 | + | ||
140 | +> 客服驳回 | ||
141 | + | ||
142 | +```json | ||
143 | +{ | ||
144 | + "code":500, | ||
145 | + "message":"error", | ||
146 | + "data":{ | ||
147 | + "id": 1, | ||
148 | + "init_order_code": "111", | ||
149 | + "source_order_code": 1111, | ||
150 | + "new_order_code": 1111, | ||
151 | + "exchange_id": 111, | ||
152 | + "returned_id": 111, | ||
153 | + "exchange_status": 91, // 客服驳回 | ||
154 | + "returned_status": 91 // 客服驳回 | ||
155 | + } | ||
156 | +} | ||
157 | +``` | ||
158 | + | ||
159 | +## 前台更新换货快递信息 | ||
160 | +### MQ消息数据结构 | ||
161 | +| | | | ||
162 | +| :-- | :-- | | ||
163 | +| exchanges | amq.topic | | ||
164 | +| route key | order.updateChangeRefundOrderExpressInfo | | ||
165 | + | ||
166 | +```json | ||
167 | +{ "id":1, | ||
168 | + "apply_id":40, | ||
169 | + "express_number":"603596395359", | ||
170 | + "express_name":"顺丰", | ||
171 | + "express_id":"23", | ||
172 | + type:"change" // 表示类型为换货 | ||
173 | +} | ||
174 | +``` | ||
175 | + | ||
176 | +## ERP更新换货单状态 | ||
177 | +### MQ消息数据结构 | ||
178 | +| | | | ||
179 | +| :-- | :-- | | ||
180 | +| exchanges | amq.topic | | ||
181 | +| route key | erp.updateChangeRefundOrderStatus | | ||
182 | +> 审核通过 | ||
183 | +```json | ||
184 | +{ | ||
185 | + "id":1, // id为erp系统换货单id唯一主键 | ||
186 | + "status":10, | ||
187 | + "type":"change" //"change" 表示换货类型,"refund"表示退货类型 | ||
188 | +} | ||
189 | +``` | ||
190 | +> 商品入库(仅商品寄回发该状态) | ||
191 | +```json | ||
192 | +{ | ||
193 | + "id":1, // id为erp系统换货单id唯一主键 | ||
194 | + "status":30, | ||
195 | + "type":"change" //"change" 表示换货类型,"refund"表示退货类型 | ||
196 | +} | ||
197 | +``` | ||
198 | +> 上门换货(仅上门换货发该状态) | ||
199 | +```json | ||
200 | +{ | ||
201 | + "id":1, // id为erp系统换货单id唯一主键 | ||
202 | + "status":40, | ||
203 | + "type":"change" //"change" 表示换货类型,"refund"表示退货类型 | ||
204 | +} | ||
205 | +``` | ||
206 | +> 换货完成 | ||
207 | +```json | ||
208 | +{ | ||
209 | + "id":1, // id为erp系统换货单id唯一主键 | ||
210 | + "status":50, | ||
211 | + "type":"change" //"change" 表示换货类型,"refund"表示退货类型 | ||
212 | +} | ||
213 | +``` | ||
214 | + | ||
215 | + | ||
216 | +## 前台创建退货单 | ||
217 | +### MQ消息数据结构 | ||
218 | +| | | | ||
219 | +| :-- | :-- | | ||
220 | +| exchanges | amq.topic | | ||
221 | +| route key | order.createRefundOrder | | ||
222 | + | ||
223 | +```json | ||
224 | +{ | ||
225 | + "uid": "3342109", | ||
226 | + "alipay_account": "13912008849", | ||
227 | + "alipay_name": "xxxx", | ||
228 | + "area_code": "area_code", | ||
229 | + "bank_card": "6228480605428963215", | ||
230 | + "bank_name": "中国农业银行", | ||
231 | + "city": "南京市", | ||
232 | + "county": "", | ||
233 | + "order_code": "308545172", | ||
234 | + "payee_name": "张璐", | ||
235 | + "province": "江苏省", | ||
236 | + "remark": "尺寸不合适", | ||
237 | + "return_amount_mode": "2", | ||
238 | + "order_returned_id":123,//前台表生成的退货订单主键,其余字段同老接口 | ||
239 | + "returned_goods_list": [ | ||
240 | + { | ||
241 | + "product_sku": "383669", | ||
242 | + "goods_type": "1", | ||
243 | + "last_price": "334", | ||
244 | + "returned_reason": "1", | ||
245 | + "remark": "尺寸不合适", | ||
246 | + "evidence_images": "" | ||
247 | + } | ||
248 | + ] | ||
249 | +} | ||
250 | +``` | ||
251 | + | ||
252 | + | ||
253 | +## ERP创建退货单 | ||
254 | +### MQ消息数据结构 | ||
255 | +| | | | ||
256 | +| :-- | :-- | | ||
257 | +| exchanges | amq.topic | | ||
258 | +| route key | erp.createRefundOrder | | ||
259 | + | ||
260 | + | ||
261 | +> 成功 | ||
262 | + | ||
263 | +```json | ||
264 | +{ | ||
265 | + "code": 200, | ||
266 | + "message": "ok", | ||
267 | + "data": { | ||
268 | + "id":1, //前台退货id唯一主键 | ||
269 | + "returned_id":1, //returned_id为erp退货id唯一主键 | ||
270 | + "returned_status":10, | ||
271 | + "real_returned_amount":100, | ||
272 | + "is_return_coupon":"N", | ||
273 | + "return_yoho_coin":11111 | ||
274 | + } | ||
275 | +} | ||
276 | +``` | ||
277 | + | ||
278 | +> 客服驳回 | ||
279 | + | ||
280 | +```json | ||
281 | +{ | ||
282 | + "code":500, | ||
283 | + "message":"error", | ||
284 | + "data":{ | ||
285 | + "id":1, //id为前台退货id唯一主键 | ||
286 | + "returned_id":1, //returned_id为erp退货id唯一主键 | ||
287 | + "returned_status":91 //客服驳回 | ||
288 | + } | ||
289 | +} | ||
290 | +``` | ||
291 | + | ||
292 | + | ||
293 | +## 前台更新退货快递信息 | ||
294 | +### MQ消息数据结构 | ||
295 | +| | | | ||
296 | +| :-- | :-- | | ||
297 | +| exchanges | amq.topic | | ||
298 | +| route key | order.updateChangeRefundOrderExpressInfo | | ||
299 | + | ||
300 | +```json | ||
301 | +{ "order_returned_id":1, //order_returned_id为前台退货id唯一主键 | ||
302 | + "apply_id":40, //apply_id为erp退货id唯一主键 | ||
303 | + "express_number":"603596395359", | ||
304 | + "express_name":"顺丰", | ||
305 | + "express_id":"23", | ||
306 | + "type":"refund" // 表示类型为退货 | ||
307 | +} | ||
308 | + | ||
309 | + | ||
310 | +``` | ||
311 | + | ||
312 | +## ERP更新退货单状态 | ||
313 | +### MQ消息数据结构 | ||
314 | +| | | | ||
315 | +| :-- | :-- | | ||
316 | +| exchanges | amq.topic | | ||
317 | +| route key | erp.updateChangeRefundOrderStatus | | ||
318 | + | ||
319 | +```json | ||
320 | +{ | ||
321 | + "id":1, // id 为erp系统退货单id唯一主键 | ||
322 | + "status":40, // 0:提交、10:审核通过、20:商品寄回、30:已入库、40:付款结束、91:客服拒退 | ||
323 | + "type":"refund", // change:表示换货类型、refund:表示退货类型 | ||
324 | + "real_returned_amount":100, | ||
325 | + "is_return_coupon":"N", | ||
326 | + "return_yoho_coin":11111 | ||
327 | +} | ||
328 | + | ||
329 | +``` | ||
330 | +## 取消退换货 | ||
331 | + | ||
332 | +### MQ消息数据结构 | ||
333 | +| | | | ||
334 | +| :-- | :-- | | ||
335 | +| exchanges | amq.topic | | ||
336 | +| route key | order.changeRefundCancel | | ||
337 | + | ||
338 | +```json | ||
339 | +{"id": 428013, //erp的退货主键, 或者换货主键 ,根据type传不同的值 | ||
340 | +"status":900, //表示用户主动取消状态 | ||
341 | +"type":1 //1表示退货,2表示换货 | ||
342 | +} | ||
343 | +``` | ||
344 | + | ||
345 | + | ||
346 | +## 修改订单收货地址MQ | ||
347 | + | ||
348 | +### MQ消息数据结构 | ||
349 | +| | | | ||
350 | +| :-- | :-- | | ||
351 | +| exchanges | amq.topic | | ||
352 | +| route key | order.deliveryAddress | | ||
353 | + | ||
354 | +### MQ队列 | ||
355 | +queue:erp.deliveryAddressUpdate | ||
356 | + | ||
357 | +```json | ||
358 | +[{ | ||
359 | + "address": "靖南大街688-10号2楼", | ||
360 | + "address_id": 61, | ||
361 | + "area_code": 330225, | ||
362 | + "city": "宁波市", | ||
363 | + "district": "象山县", | ||
364 | + "email": "canvas220@sina.com", | ||
365 | + "mobile": "15258109727", | ||
366 | + "order_code": 1607472719, | ||
367 | + "parent_order_code": 123, | ||
368 | + "phone": "057465772167", | ||
369 | + "province": "浙江省", | ||
370 | + "user_name": "朱倩倩", | ||
371 | + "zip_code": 315700 | ||
372 | +}] | ||
373 | +``` |
@@ -41,33 +41,3 @@ http://devapi.yoho.cn:58078?method=app.SpaceOrders.updateDeliveryAddress&order_c | @@ -41,33 +41,3 @@ http://devapi.yoho.cn:58078?method=app.SpaceOrders.updateDeliveryAddress&order_c | ||
41 | "message": "修改订单收货地址成功" | 41 | "message": "修改订单收货地址成功" |
42 | } | 42 | } |
43 | ``` | 43 | ``` |
44 | - | ||
45 | -## 修改订单收货地址MQ | ||
46 | - | ||
47 | -### MQ消息数据结构 | ||
48 | -| | | | ||
49 | -| :-- | :-- | | ||
50 | -| exchanges | amq.topic | | ||
51 | -| route key | order.deliveryAddress | | ||
52 | - | ||
53 | -### MQ队列 | ||
54 | -queue:erp.deliveryAddressUpdate | ||
55 | - | ||
56 | -```json | ||
57 | -[{ | ||
58 | - "address": "靖南大街688-10号2楼", | ||
59 | - "address_id": 61, | ||
60 | - "area_code": 330225, | ||
61 | - "city": "宁波市", | ||
62 | - "district": "象山县", | ||
63 | - "email": "canvas220@sina.com", | ||
64 | - "mobile": "15258109727", | ||
65 | - "order_code": 1607472719, | ||
66 | - "parent_order_code": 123, | ||
67 | - "phone": "057465772167", | ||
68 | - "province": "浙江省", | ||
69 | - "user_name": "朱倩倩", | ||
70 | - "zip_code": 315700 | ||
71 | -}] | ||
72 | -``` | ||
73 | -### 注意 1.JIT拆单和预售商品拆单有关联其他订单,主订单号parent_order_code为1607472719;2.没有关联其他订单,主订单号parent_order_code字段可能不存在。 |
-
Please register or login to post a comment