售后服务(aftersale)-退货退款(外部)
买家提交退款申请
基本信息
Path: /aftersale/refund/buyerSubmit
Method: POST
接口描述:
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 | ||
Body |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
refund_way | integer | 非必须 | 退款方式:1应用方退款2平台直接退款 | format: int32 | |
reason_info | string | 必须 | 原因内容 | ||
refund_type | integer | 必须 | 申请类型:1:退款,2:退货 | format: int32 | |
buyer_message | string | 必须 | 退款说明 | ||
buyer_phone | string | 非必须 | 买家电话 | ||
goods_num | integer | 非必须 | 商品数量 | format: int32 | |
refund_amount | number | 必须 | 退款金额 | ||
order_goods_id | string | 必须 | 订单商品ID,0:全部退款 | ||
order_id | string | 必须 | 订单ID | ||
pic_info | string | 非必须 | 退款退货图片 | ||
reason_id | string | 必须 | 原因ID:0:其它 |
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
msg | string | 必须 | 响应信息 | ||
code | integer | 必须 | 响应状态码 | format: int32 | |
data | object | 必须 | |||
├─ id | string | 非必须 |
买家取消退款申请
基本信息
Path: /aftersale/refund/buyerCancel
Method: POST
接口描述:
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 | ||
Body |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
refund_id | string | 必须 | 退款申请ID |
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
msg | string | 必须 | 响应信息 | ||
code | integer | 必须 | 响应状态码 | format: int32 | |
data | object | 必须 | 响应数据 |
卖家处理退款申请
基本信息
Path: /aftersale/refund/sellerDeal
Method: POST
接口描述:
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 | ||
Body |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
return_type | integer | 非必须 | format: int32 | ||
seller_message | string | 非必须 | 卖家备注 | ||
refund_id | string | 必须 | 退款申请ID | ||
refund_state | integer | 必须 | 卖家处理:5:商家拒绝,6:商家同意 | format: int32 | |
has_role | boolean | 非必须 |
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
msg | string | 必须 | 响应信息 | ||
code | integer | 必须 | 响应状态码 | format: int32 | |
data | object | 必须 | 响应数据 |
买家发货
基本信息
Path: /aftersale/refund/buyerDelivery
Method: POST
接口描述:
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 | ||
Body |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
express_id | string | 必须 | 物流公司编号 | ||
invoice_no | string | 必须 | 物流单号 | ||
buyer_id | string | 非必须 | |||
refund_id | string | 必须 | 退款申请ID |
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
msg | string | 必须 | 响应信息 | ||
code | integer | 必须 | 响应状态码 | format: int32 | |
data | object | 必须 | 响应数据 |
商家收货处理
基本信息
Path: /aftersale/refund/sellerReceive
Method: POST
接口描述:
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 | ||
Body |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
goods_state | integer | 必须 | 物流状态:3未收到,4已收货 | format: int32 | |
refund_id | string | 必须 | 退款申请ID |
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
msg | string | 必须 | 响应信息 | ||
code | integer | 必须 | 响应状态码 | format: int32 | |
data | object | 必须 | 响应数据 |
买家查询退款申请列表
基本信息
Path: /aftersale/refund/queryByBuyer
Method: POST
接口描述:
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 | ||
Body |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
goods_name | string | 非必须 | 商品名称 | ||
refund_type | integer | 非必须 | 申请类型:1:退款,2:退货 | format: int32 | |
pageno | integer | 必须 | 每页的记录数 | format: int32 | |
pagesize | integer | 必须 | 页数 | format: int32 | |
store_name | string | 非必须 | 店铺 | ||
to_time | string | 非必须 | 退货退款结束时间 | format: date-time | |
app_id | string | 必须 | 应用ID | ||
from_time | string | 非必须 | 退货退款申请时间 | format: date-time | |
order_id | string | 非必须 | |||
refund_state | integer [] | 非必须 | 处理状态 | item 类型: integer | |
├─ | 非必须 | ||||
order_sn | string | 非必须 | 订单ID |
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
msg | string | 必须 | |||
code | integer | 必须 | format: int32 | ||
data | object [] | 必须 | item 类型: object | ||
├─ store_id | string | 必须 | 店铺ID | ||
├─ goods_name | string | 必须 | 商品名称 | ||
├─ refund_type | integer | 必须 | 申请类型:1:退款,2:退货 | format: int32 | |
├─ buyer_message | string | 必须 | 退款退货申请说明 | ||
├─ buyer_phone | string | 非必须 | |||
├─ buyer_name | string | 必须 | 买家名称 | ||
├─ goods_id | string | 必须 | 商品ID | ||
├─ buyer_id | string | 非必须 | |||
├─ refund_sn | string | 必须 | 退款编号 | ||
├─ reason_info | string | 必须 | 退款原因 | ||
├─ goods_image | string | 必须 | 商品图片 | ||
├─ goods_num | integer | 必须 | 商品数量 | format: int32 | |
├─ refund_amount | number | 必须 | 退款金额 | ||
├─ store_name | string | 必须 | 店铺名称 | ||
├─ id | string | 必须 | 退款ID | ||
├─ order_goods_id | string | 必须 | 订单商品ID | ||
├─ add_time | string | 必须 | 添加时间 | format: date-time | |
├─ order_id | string | 必须 | 订单ID | ||
├─ refund_state | integer | 必须 | 退款状态 | format: int32 | |
├─ order_sn | string | 必须 | 订单编号 | ||
page | object | 非必须 | |||
├─ total | integer | 非必须 | format: int64 | ||
├─ records | integer | 非必须 | format: int64 | ||
├─ pageno | integer | 非必须 | format: int32 | ||
├─ pagesize | integer | 非必须 | format: int32 |
商家查询退款申请列表
基本信息
Path: /aftersale/refund/queryBySeller
Method: POST
接口描述:
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 | ||
Body |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
goods_name | string | 非必须 | 商品名称 | ||
refund_type | integer | 非必须 | 申请类型:1:退款,2:退货 | format: int32 | |
pageno | integer | 必须 | 页码数 | format: int32 | |
buyer_phone | string | 非必须 | 买家电话 | ||
pagesize | integer | 必须 | 每页的记录数 | format: int32 | |
buyer_name | string | 非必须 | 买家 | ||
to_time | string | 非必须 | 结束时间 | format: date-time | |
from_time | string | 非必须 | 提交时间 | format: date-time | |
refund_state | integer [] | 非必须 | 处理状态 | item 类型: integer | |
├─ | 非必须 | ||||
order_sn | string | 非必须 | 订单ID |
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
msg | string | 必须 | |||
code | integer | 必须 | format: int32 | ||
data | object [] | 必须 | item 类型: object | ||
├─ store_id | string | 必须 | 店铺ID | ||
├─ goods_name | string | 必须 | 商品名称 | ||
├─ refund_type | integer | 必须 | 申请类型:1:退款,2:退货 | format: int32 | |
├─ buyer_message | string | 必须 | 退款退货申请说明 | ||
├─ buyer_phone | string | 非必须 | |||
├─ buyer_name | string | 必须 | 买家名称 | ||
├─ goods_id | string | 必须 | 商品ID | ||
├─ buyer_id | string | 非必须 | |||
├─ refund_sn | string | 必须 | 退款编号 | ||
├─ reason_info | string | 必须 | 退款原因 | ||
├─ goods_image | string | 必须 | 商品图片 | ||
├─ goods_num | integer | 必须 | 商品数量 | format: int32 | |
├─ refund_amount | number | 必须 | 退款金额 | ||
├─ store_name | string | 必须 | 店铺名称 | ||
├─ id | string | 必须 | 退款ID | ||
├─ order_goods_id | string | 必须 | 订单商品ID | ||
├─ add_time | string | 必须 | 添加时间 | format: date-time | |
├─ order_id | string | 必须 | 订单ID | ||
├─ refund_state | integer | 必须 | 退款状态 | format: int32 | |
├─ order_sn | string | 必须 | 订单编号 | ||
page | object | 非必须 | |||
├─ total | integer | 非必须 | format: int64 | ||
├─ records | integer | 非必须 | format: int64 | ||
├─ pageno | integer | 非必须 | format: int32 | ||
├─ pagesize | integer | 非必须 | format: int32 |
查看退款处理详情
基本信息
Path: /aftersale/refund/getRefund
Method: POST
接口描述:
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 | ||
Body |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
buyer_id | string | 非必须 | |||
refund_id | string | 必须 | 退款申请ID | ||
seller_id | string | 非必须 |
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
msg | string | 必须 | |||
code | integer | 必须 | format: int32 | ||
data | object | 必须 | |||
├─ return_type | integer | 必须 | 退货类型:1:不用退货,2:需要退货 | format: int32 | |
├─ ship_time | string | 必须 | 发货时间 | format: date-time | |
├─ refund_no | string | 必须 | 退款流水号 | ||
├─ buyer_name | string | 必须 | 买家名称 | ||
├─ buyer_id | string | 必须 | 买家ID | ||
├─ pic_info | string | 必须 | 退款退货图片 | ||
├─ reason_info | string | 必须 | 退款原因 | ||
├─ update_time | string | 非必须 | format: date-time | ||
├─ order_goods | object [] | 必须 | 退款商品 | item 类型: object | |
├─ goods_name | string | 必须 | 商品名称 | ||
├─ goods_image | string | 必须 | 商品图片 | ||
├─ chain_id | string | 必须 | 传播链ID | ||
├─ create_time | string | 非必须 | format: date-time | ||
├─ goods_price | number | 必须 | 商品价格 | ||
├─ goods_discount | number | 非必须 | |||
├─ goods_id | string | 必须 | 商品ID | ||
├─ goods_num | integer | 必须 | 商品数量 | format: int32 | |
├─ id | string | 必须 | 订单商品ID | ||
├─ goods_pay_price | number | 必须 | 商品金额 | ||
├─ order_id | string | 必须 | 订单ID | ||
├─ refund_amount | number | 必须 | 退款金额 | ||
├─ store_name | string | 必须 | 店铺名称 | ||
├─ delay_time | string | 必须 | 收货延迟时间 | format: date-time | |
├─ store_id | string | 必须 | 店铺ID | ||
├─ goods_name | string | 必须 | 商品名称 | ||
├─ refund_type | integer | 必须 | 申请类型:1:退款,2:退货 | format: int32 | |
├─ buyer_message | string | 必须 | 退款退货申请说明 | ||
├─ invoice_no | string | 必须 | 物流单号 | ||
├─ buyer_phone | string | 必须 | 买家电话 | ||
├─ receive_time | string | 必须 | 收货时间 | format: date-time | |
├─ goods_id | string | 必须 | 商品ID | ||
├─ seller_message | string | 必须 | 卖家备注 | ||
├─ refund_sn | string | 必须 | 退款编号 | ||
├─ order_add_time | string | 非必须 | format: date-time | ||
├─ reason_id | string | 必须 | 退款原因ID | ||
├─ seller_time | string | 必须 | 卖家处理时间 | format: date-time | |
├─ express_id | string | 必须 | 物流公司编号 | ||
├─ receive_message | string | 必须 | 收货备注 | ||
├─ goods_image | string | 必须 | 商品默认图片 | ||
├─ refund_time | string | 必须 | 退款时间 | format: date-time | |
├─ goods_num | integer | 必须 | 退款数量 | format: int32 | |
├─ goods_state | integer | 必须 | 物流状态:1:待发货,2:待收货,3:未收到,4:已收货 | format: int32 | |
├─ order_goods_id | string | 必须 | /订单商品ID | ||
├─ add_time | string | 必须 | 添加时间 | format: date-time | |
├─ order_id | string | 必须 | 订单ID | ||
├─ refund_state | integer | 必须 | 申请状态 | format: int32 | |
├─ order_sn | string | 必须 | 订单编号 |