Authored by maelk-liu

取消退换货

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 -```  
  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 +}