Authored by LUOXC

update

  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字段可能不存在。