全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

售后单详情


接口地址: http://api.vv-tool.com/tool/erps/ks-refund-detail


接口介绍: 退货订单详情,当前未单独返回“售后状态”字段,“售后状态”由出参中的 status(退款状态)和 negotiateStatus(协商状态)组合进行识别。
售后状态和对应的组合映射关系如下
待卖家处理 status=10/11 negotiateStatus=1
未同意退款 status=10/11 negotiateStatus=3
待平台判定 status=20/21/22
待买家退货 status=30
待卖家收货 status=40
退款成功 status=50/60
退款关闭 status=70
退款到账 status=60


必须用户授权 : 需要用户的授权,才能拿到被授权的数据


请求方式: GET


返回格式: JSON


接口收费: 请求次数收费,联系运营


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

参数 类型 必选 描述
shop_id String 店铺 id(可在快手小店获取)
refundId Long 退款单 id
vvtype int 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2

请求示例

{
  
}

请求代码示例

cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例

响应参数

名称 类型 示例值 描述
result Integer 1 返回码,1 正确,其他返回码表示接口未执行成功
data MerchantRefundDetailDataView {} 退货单信息
refundId Long 129230087 退款单 id
oid Long 12020384 订单 id
skuId Long 92381223 快手 skuid
refundFee Long 890 退款金额
status Integer 10 退款状态,枚举:[10, "买家仅退款申请"] [11, "买家退货退款申请"] [20, "平台介入-买家仅退款申请"] [21, "平台介入-买家退货退款申请"] [22, "平台介入-已确认退货退款"] [30, "商品回寄信息待买家更新"] [40, "商品回寄信息待卖家确认"] [50, "退款执行中"] [60, "退款成功"] [70, "退款失败"]
refundReason Integer 1 退款原因,枚举值见https://open.kwaixiaodian.com/docs/dev?pageSign=39f65af389784c2c164e95c7d7b69efa1614264111384
buyerId Long 63523209 买家快手 id
sellerId Long 92371012 卖家快手 id
refundType Integer 1298723 退款类型,枚举:[0, "未知"] [1, "买家申请退款"] [2, "卖家主动退款"]
handlingWay Integer 1 退款方式,枚举:[0, "未知"] [1, "退货退款"] [10, "仅退款"]
refundDesc String 描述 退款描述
logisticsId Long 1111 物流 id
pictures String [] 申请人关于退款的举证图片列表
negotiateStatus Integer 1 协商状态,枚举:[0, "未知状态"] [1, "待商家处理"] [2, "商家同意"] [3, "商家驳回,等待买家修改"]
validNegotiateBuyerModifyTimeStamp Long 2130 买家修改商家不同意的退款单时限
updateTime Long 1543843735000 更新时间
relSkuId Long 120823876 服务商 skuid
relItemId Long 111 服务商商品 id
sellerDisagreeImages String [] 商家拒绝图片凭证
logisticsInfo MerchantLogisticsInfoView {} 退货单物流信息
expressNo String SF08237750957 快递单号
expressCode Integer 9 快递公司编号
sellerDisagreeDesc String 拒绝退货 商家拒绝文字说明
sellerDisagreeReason Integer 1 商家拒绝原因。枚举值 10:已协商完毕不退款;11:买家要求与实际应退款金额不一致;12:其他;13:商品已寄出,须寄回后才能退款;14:已发货商品不包邮,请买家承担运费;15:已发货,请选择退货退款;16:已经超过七天无理由退货时限;17:已协商完毕不退款;18:买家要求与实际应退款金额不一致;19:买家未举证/举证无效;20:买家已签收商品,请选择退货退款;21:已经超过七天无理由退货时限;22:已发货商品不包邮,请买家承担运费;23:已经超过七天无理由退货时限;24:商品没问题,买家未举证;25:商品没问题,买家举证无效;26:已协商完毕不退货;27:物流异常未收到货;28:退回商品不完好;29:退回商品与订单商品不一致;30:空包裹
timeLimitNegotiateChange Long 0 买家能修改 WAIT_MODIFY 的时间限制
negotiateReason String 修改退款申请 协商状态变更原因。枚举值 0:未知;10008:修改退款申请;10013:买家同意商家修改退款;10033:同意退款;10036:返回修改
createTime Long 1543843735000 创建时间
negotiateUpdateTime Long 1543843735000 协商相关核心信息变更时间
submitTime Long 1543843735000 退货申请时间
expireTime Long 1543843735000 超期时间(商家处理的截止时间)
endTime Long 1543843735000 结束时间(退款成功或退款失败时间)
itemId Long 123456 快手商品 id
receiptStatus Integer 1 货物状态,枚举值 0:未知;1:未收到货;2:已收到货
error_msg String SUCCESS 返回码说明
withholding_money Integer 该接口扣费金额(点券)

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1469,
    "time": 1617270403,
    "data": {
      "withholding_money":4,
      "result": 1,
    "data": {
    "refundId": 129230087,
    "oid": 12020384,
    "skuId": 92381223,
    "refundFee": 890,
    "status": 10,
    "refundReason": 1,
    "buyerId": 63523209,
    "sellerId": 92371012,
    "refundType": 1298723,
    "handlingWay": 1,
    "refundDesc": "描述",
    "logisticsId": 1111,
    "pictures": "[]",
    "negotiateStatus": 1,
    "validNegotiateBuyerModifyTimeStamp": 2130,
    "updateTime": 1543843735000,
    "relSkuId": 120823876,
    "relItemId": 111,
    "sellerDisagreeImages": "[]",
    "logisticsInfo": {
      "expressNo": "SF08237750957",
      "expressCode": 9
    },
    "sellerDisagreeDesc": "拒绝退货",
    "sellerDisagreeReason": 1,
    "timeLimitNegotiateChange": 0,
    "negotiateReason": "修改退款申请",
    "createTime": 1543843735000,
    "negotiateUpdateTime": 1543843735000,
    "submitTime": 1543843735000,
    "expireTime": 1543843735000,
    "endTime": 1543843735000,
    "itemId": 123456,
    "receiptStatus": 1
  },
  "error_msg": "SUCCESS"
  }
  
    
  }
  



响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
202 系统错误,请稍后再试 稍后重试,或者联系对接群
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权