V兔API开放平台

参数	类型	必选	描述
shop_id	String	是	店铺 id(可在快手小店获取)
beginTime	Long	是	订单生成时间的开始时间，单位毫秒，不能小于 90 天前，且需要小于结束时间
endTime	Long	是	订单生成时间的截止时间，单位毫秒，不能小于 90 天前，且与开始时间的时间范围不大于 1 天 (与开始时间的时间范围建议做成随时可配置，该范围可能在活动期间随时变化，比如变成小时级或者分钟级)。受春节活动影响，在 2.1 10:00~~2.5 10:00 以及 2.10 10:00~~2.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	否

请求示例

{
  
}

请求代码示例

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	未授权店铺	根据返回链接进行扫码授权