周蓉君 / 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 27 additions and 213 deletions
# 退货服务接口
# 修改订单收货地址服务接口
## 接口列表
| 接口名称 | 接口描述 |
| --------| -------- |
|[app.refund.goodsList](#1)|获取退货订单商品列表|
|[app.refund.submit](#2)|提交退货申请|
|[app.refund.detail](#3)|退货详情|
|[app.refund.setexpress](#4)|保存快递信息|
|[app.SpaceOrders.updateDeliveryAddress](#1)|修改订单收货地址|
|[修改订单收货地址MQ](#2)|修改订单收货地址MQ|
## 接口描述
### 1、获取退货订单商品列表(app.refund.goodsList)
### 1、修改订单收货地址(app.SpaceOrders.updateDeliveryAddress)
#### 请求参数
| Param Name | Param Type | Required | Param Value | Desc |
| :-- | --: | --: | --: | --: |
| method | String | true | app.refund.goodsList| 请求方法|
| uid | int | true | 7893817 |用户ID |
| order_code |long | true | 1613656852 |订单号 |
| method | String | true | app.SpaceOrders.updateDeliveryAddress| 请求方法|
| order_code | String | true | "1607472719" |订单号 |
| user_name | String | true | "周辉" |收货人 |
| mobile | String | true | "13236587561" |手机 |
| area_code | String | true | "320105" |地区编号|
| address | String | true | "南京市建邺区嘉陵江东街18号国家广告产业园5栋17,18楼" |详细地址|
#### 响应内容
```json
{
"code": 200,
"data": {
"coupon_amount": "0.00",
"goods_list": [
{
"color_name": "蓝色",
"goods_id": 355897,
"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",
"goods_type": "ordinary",
"goods_type_id": 1,
"hasShoes": 0,
"last_price": "149.00",
"product_id": 275357,
"product_name": "Life•After Life X The Simpsons 辛普森一家刺绣牛津纺衬衫",
"product_skc": 280039,
"product_skn": 51153138,
"product_sku": 894428,
"size_name": "M"
}
],
"return_amount_info": "",
"return_amount_mode": [
{
"id": 1,
"is_default": "Y",
"name": "原卡返还"
}
],
"return_reason": [
{
"id": 3,
"name": "不喜欢"
},
{
"id": 2,
"name": "性价比不高"
},
{
"id": 11,
"name": "价格变化"
},
{
"id": 4,
"name": "质量瑕疵"
},
{
"id": 1,
"name": "尺寸不合适"
},
{
"id": 7,
"name": "商品有色差"
},
{
"id": 8,
"name": "图片与实物不符"
},
{
"id": 6,
"name": "发错货"
},
{
"id": 5,
"name": "快递延迟"
}
],
"yoho_coin_num": "0.00"
},
"md5": "72879cfb65bcd2705e4283d2f5dc1a30",
"message": "Refund goods list"
}
```
### 2、提交退货申请(app.refund.submit)
#### 请求参数
| Param Name | Param Type | Required | Param Value | Desc |
| :-- | --: | --: | --: | --: |
| method | String | true |app.refund.submit| 请求方法|
| order_code |long | true | 1512253171 |订单号 |
| uid | int | true |8040274 |用户ID |
| area_code |String | false | " " (默认值为空) |地区编号|
| goods |String(json数组) | true | [{"goods_type":"1","last_price":"18.00","product_skc":"83007","product_skn":"51001899","product_sku":"307528","remark":" ","returned_reason":1}] |退货商品 |
| payment |String(json对象) | true | {"alipay_account":" ","alipay_name":" ","area_code":"320115","bank_card":" ","bank_name":" ","city":" ","payee_name":" ","province":" ","remark":" ","return_amount_mode":"1"} |退款设置|
#### 响应内容
```json
{
"code": 200,
"message": "退货申请成功",
"data": {
"apply_id": "428135"
},
"md5": "2d4a86d3d308cf8cbdd9870ebd61a3a4"
}
```
##### 响应内容描述
| Param Name | Param Type | Desc |
| ---------- | ---------- | ---- |
| apply_id | String | 退货申请ID |
### 3、退货详情(app.refund.detail)
#### 请求参数
| Param Name | Param Type | Required | Param Value | Desc |
| :-- | --: | --: | --: | --: |
| method | String | true | app.refund.detail| 请求方法|
| id |int | true | 428106 |退货申请ID |
| uid | int | true | 362719 |用户ID |
#### 响应内容
```json
{
"code": 200,
"message": "退货详情",
"data": {
"source_order_code": "1513540278",
"use_yoho_coin_num": null,
"status": "20",
"status_name": "商品寄回",
"statusList": [
{
"name": "提交申请",
"act": "Y"
},
{
"name": "审核通过",
"act": "Y"
},
{
"name": "商品寄回",
"act": "Y"
},
{
"name": "商品入库",
"act": "N"
},
{
"name": "退款完成",
"act": "N"
}
],
"create_time": "2015-11-23 20:20:12",
"return_amount_mode_name": "YOHO币",
"return_amount_mode": "4",
"return_yoho_coin": "0",
"goods_list": [
{
"product_skn": "51146548",
"product_name": "我是可爱的小秋秋，james，蔡!",
"goods_image": "?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/90",
"size_name": null,
"color_name": null,
"sales_price": null,
"reason": "1",
"remark": "",
"reason_name": "尺寸不合适",
"evidence_images": [],
"goods_type": "ordinary"
}
],
"notice": {
"id": 20,
"title": "商品寄回物流信息",
"express_company": "南京ems",
"express_number": "44323566"
},
"return_amount": "125.00",
"return_coupon_amount": "0.00",
"express_number": "44323566",
"return_amount_total": "125.00",
"return_amount_info": "",
"return_amount_mode_info": []
},
"md5": "6fa464cf72538ad2c25fa24d20dcdd20"
}
"alg": "SALT_MD5",
"code": 200,
"data": {
"relateOrderCode": "N"
},
"md5": "1f7d1c5c325209e77f0989134e7a8b67",
"message": "修改订单收货地址成功"
}
```
#### 注意 relateOrderCode代表是否有关联其他订单：1. 值为"Y",代表有关联其他订单，提示语，关联订单的收货地址将一起修改且不可修改第二次，请确认是否修改; 2.值为"N",代表没有关联其他订单，提示语，收货地址仅且只能修改1次，请确认是否修改。
### 4、保存快递信息(app.refund.setexpress)
## 2、修改订单收货地址MQ
#### 请求参数
| Param Name | Param Type | Required | Param Value | Desc |
| :-- | --: | --: | --: | --: |
| method | String | true | app.refund.setexpress| 请求方法|
| id |int | true | 428120 |退货申请ID |
| uid | int | true | 362729 |用户ID |
| express_company |String | true | 南京ems |快递公司名称|
| express_number |String | true | 44323575 |快递单号 |
| express_id |int | true | 2 |快递公司ID |
### MQ消息数据结构
| | |
| :-- | :-- |
| exchanges | amq.topic |
| route key | order.deliveryAddress |
#### 响应内容
```json
{
"code": 200,
"message": "快递单号设置成功",
"data": [],
"md5": "93311f762194b751872601b67fad53f7"
}
or
{
"code": 412,
"message": "没有找到该退货申请"
}
{"address":"南京市建邺区嘉陵江东街18号国家广告产业园5栋17,18楼","area_code":320105,"city":"南京市","district":"建邺区","mobile":"13236587561","order_code":1607472719,"parent_order_code":"","province":"江苏省","user_name":"钱军"}
```
#### 注意 1.JIT拆单和预售商品拆单有关联其他订单，主订单号parent_order_code为1607472719，是数字类型；2.没有关联其他订单，主订单号parent_order_code为空字符串""，是字符串类型。
\ No newline at end of file
... ...