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

售后单列表(游标方式)


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


接口介绍: 查询卖家退款单列表(游标方式)


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


请求方式: GET


返回格式: JSON


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


频率限制: 10 次/秒


请求头参数

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

请求参数

参数 类型 必选 描述
shop_id String 店铺 id(可在快手小店获取)
beginTime Long 订单生成时间的开始时间,单位毫秒,不能小于 90 天前,且需要小于结束时间
endTime Long 订单生成时间的截止时间,单位毫秒,不能小于 90 天前,且与开始时间的时间范围不大于 1 天 (与开始时间的时间范围建议做成随时可配置,该范围可能在活动期间随时变化,比如变成小时级或者分钟级)。受春节活动影响,在 2.1 10:002.5 10:00 以及 2.10 10:002.19 10:00 期间订单的查询时间范围从 1 天缩短至 1 小时。
type Integer 退款单请求类型,8 等待退款 9 全部退款订单
pageSize Integer 每次请求数量,最多一页 100 条
currentPage Long 当前页码
sort Integer 排序方式,1 时间降序 2 时间升序 ,默认降序
queryType Integer 查找方式,1 按创建时间查找 2 按更新时间查找 ,默认创建时间
negotiateStatus Integer 协商状态,1 待商家处理 2 商家同意 3 商家驳回,等待买家修改 默认返回所有数据
pcursor String 游标内容,第一次传空串,之后传上一次的 pcursor 返回值,若返回“nomore”则标识到底
status Integer 退款状态,枚举:[10, "买家仅退款申请"] [11, "买家退货退款申请"] [20, "平台介入-买家仅退款申请"] [21, "平台介入-买家退货退款申请"] [22, "平台介入-已确认退货退款"] [30, "商品回寄信息待买家更新"] [40, "商品回寄信息待卖家确认"] [50, "退款执行中"] [60, "退款成功"] [70, "退款失败"]
vvtype int 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2

请求示例

{
  
}

请求代码示例

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

响应参数

名称 类型 示例值 描述
result Integer 1 返回码,1 正确,其他返回码表示接口未执行成功
data MerchantRefundListDataView {} 退货订单列表信息
currentPage Long 1 当前页数,仅第一次返回值有效
pageSize Integer 100 每页订单数,仅第一次返回值有效
totalPage Long 10 总页数,仅第一次返回值有效
totalSize Long 100 总订单数
beginTime Long 1597248000000 查询开始时间
endTime Long 1597276800000 查询结束时间
pcursor String nomore 游标内容,nomore 标识到底
refundOrderInfoList List [] 退款单列表
oid Long 12020384 订单 id
refundId Long 2016300011212478 退款单 id
handlingWay Integer 1 退款方式,枚举:[0, "未知"] [1, "退货退款"] [10, "仅退款"]
negotiateStatus Integer 1 协商状态,枚举:[0, "未知状态"] [1, "待商家处理"] [2, "商家同意"] [3, "商家驳回,等待买家修改"]
refundFee Long 890 退款金额
skuId Long 92381223 快手 skuid
refundReason Integer 1 退款原因,枚举值见https://open.kwaixiaodian.com/docs/dev?id=a6njGGa2IQ
status Integer 10 退款状态,枚举:[10, "买家仅退款申请"] [11, "买家退货退款申请"] [20, "平台介入-买家仅退款申请"] [21, "平台介入-买家退货退款申请"] [22, "平台介入-已确认退货退款"] [30, "商品回寄信息待买家更新"] [40, "商品回寄信息待卖家确认"] [50, "退款执行中"] [60, "退款成功"] [70, "退款失败"]
buyerId Long 63523209 买家快手 id
refundType Integer 1298723 退款类型,枚举:[0, "未知"] [1, "买家申请退款"] [2, "卖家主动退款"]
sellerId Long 92371012 卖家快手 id
refundDesc String 描述 退款描述
submitTime Long 1543843735000 退货申请时间
relItemId Long 111 服务商商品 id
negotiateUpdateTime Long 1543843735000 协商相关核心信息变更时间
updateTime Long 1543843735000 更新时间
createTime Long 1543843735000 创建时间
relSkuId Long 120823876 服务商 skuid
skuNick String 111 sku 编码
logisticsId Long 1234567 物流 id
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": {
    "currentPage": 1,
    "pageSize": 100,
    "totalPage": 10,
    "totalSize": 100,
    "beginTime": 1597248000000,
    "endTime": 1597276800000,
    "pcursor": "nomore",
    "refundOrderInfoList": [
      {
        "oid": 12020384,
        "refundId": 2016300011212478,
        "handlingWay": 1,
        "negotiateStatus": 1,
        "refundFee": 890,
        "skuId": 92381223,
        "refundReason": 1,
        "status": 10,
        "buyerId": 63523209,
        "refundType": 1298723,
        "sellerId": 92371012,
        "refundDesc": "描述",
        "submitTime": 1543843735000,
        "relItemId": 111,
        "negotiateUpdateTime": 1543843735000,
        "updateTime": 1543843735000,
        "createTime": 1543843735000,
        "relSkuId": 120823876,
        "skuNick": "111",
        "logisticsId": 1234567,
        "endTime": 1543843735000,
        "itemId": 123456,
        "receiptStatus": 1
      }
    ]
  },
  }
  
    
  }
  
}


响应代码

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