大麦家礼品代发API

# 售后单列表(游标方式)

接口地址： http://www.damaijia168.com/vv/external/requestKsErp/ksRefundPcursor

请求方式： POST

传参方式： JSON

返回格式： JSON

# 请求头参数

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

# 请求参数

参数 类型 必选 描述
shop_id string 是 店铺id(可在快手小店获取)
params Object 是 参数
begin_time long 是 订单生成时间的开始时间，单位毫秒，不能小于90天前，且需要小于结束时间
end_time 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 全部退款订单
page_size integer 是 每次请求数量，最多一页100条
current_page long 是 当前页码
sort integer 否 排序方式，1时间降序 2时间升序 ，默认降序
query_type integer 否 查找方式，1按创建时间查找 2按更新时间查找 ，默认创建时间
negotiate_status integer 否 协商状态，1待商家处理 2 商家同意 3商家驳回，等待买家修改 默认返回所有数据
pcursor string 是 游标内容，第一次传空串，之后传上一次的pcursor返回值，若返回“nomore”则标识到底
status integer 否 退款状态，枚举：[10, "买家仅退款申请"] [11, "买家退货退款申请"] [20, "平台介入-买家仅退款申请"] [21, "平台介入-买家退货退款申请"] [22, "平台介入-已确认退货退款"] [30, "商品回寄信息待买家更新"] [40, "商品回寄信息待卖家确认"] [50, "退款执行中"] [60, "退款成功"] [70, "退款失败"]
edition string 否 版本 默认:1(不传默认为1)
1:1.0,2:2.0

# 请求示例

{
    "shop_id": "1213231321",
    "params": {
        "begin_time": "1639994598000",
        "end_time": "1640426598000",
        "type": "9",
        "page_size": "22",
        "pcursor": "nomore"

    }
}

# 请求代码示例

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

# 响应参数

名称 类型 示例值 描述
result integer 1 返回码，1正确，其他返回码表示接口未执行成功
data merchant_refund_list_data_view {} 退货订单列表信息
current_page long 1 当前页数，仅第一次返回值有效
page_size integer 100 每页订单数，仅第一次返回值有效
total_page long 10 总页数，仅第一次返回值有效
total_size long 100 总订单数
begin_time long 1597248000000 查询开始时间
end_time long 1597276800000 查询结束时间
pcursor string nomore 游标内容，nomore标识到底
refund_order_info_list list [] 退款单列表
oid long 12020384 订单id
refund_id long 2016300011212478 退款单id
handling_way integer 1 退款方式，枚举：[0, "未知"] [1, "退货退款"] [10, "仅退款"]
negotiate_status integer 1 协商状态，枚举：[0, "未知状态"] [1, "待商家处理"] [2, "商家同意"] [3, "商家驳回，等待买家修改"]
refund_fee long 890 退款金额
sku_id long 92381223 快手skuid
refund_reason integer 1 退款原因，枚举值见https://open.kwaixiaodian.com/docs/dev?id=a6nj_g_ga2i_q
status integer 10 退款状态，枚举：[10, "买家仅退款申请"] [11, "买家退货退款申请"] [20, "平台介入-买家仅退款申请"] [21, "平台介入-买家退货退款申请"] [22, "平台介入-已确认退货退款"] [30, "商品回寄信息待买家更新"] [40, "商品回寄信息待卖家确认"] [50, "退款执行中"] [60, "退款成功"] [70, "退款失败"]
buyer_id long 63523209 买家快手id
refund_type integer 1298723 退款类型，枚举：[0, "未知"] [1, "买家申请退款"] [2, "卖家主动退款"]
seller_id long 92371012 卖家快手id
refund_desc string 描述 退款描述
submit_time long 1543843735000 退货申请时间
rel_item_id long 111 服务商商品id
negotiate_update_time long 1543843735000 协商相关核心信息变更时间
update_time long 1543843735000 更新时间
create_time long 1543843735000 创建时间
rel_sku_id long 120823876 服务商skuid
sku_nick string 111 sku编码
logistics_id long 1234567 物流id
end_time long 1543843735000 结束时间（退款成功或退款失败时间）
item_id long 123456 快手商品id
receipt_status integer 1 货物状态，枚举：[0, "未知"] [1, "未收到货"] [2, "已收到货"]
error_msg string SUCCESS 返回码描述
deduct_money int 消耗点券
status int 状态码，0为成功

# 返回数据

{
   "data": {
  "result": 1,
  "error_msg": "SUCCESS",
  "deduct_money":4
},
  "status": 0
}

# 响应代码

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

← 5-b_快手-售后单详情 →