open.seller.order.refund.pcursor.list
需商家授权
GET
获取售后单列表
更新时间: 2024-04-22 16:28:28
查询商家售后单列表(游标方式)，可根据订单id查询关联的全量售后单列表，handlingway为售后方式，status为售后状态
系统环境
环境	域名
线上环境（推荐）	https://openapi.kwaixiaodian.com
线上环境（备用）	https://open.kwaixiaodian.com
系统参数
参数名	类型	必须	详情描述
appkey	String	是	平台分配的appId
timestamp	Number	是	发起请求的Unix时间戳，单位为毫秒
access_token	String	是	访问token，所有需用户授权API使用code模式获取，不需要用户授权API使用client_credentials获取，详情参考《授权说明》文档
version	Number	是	请求的API版本号，目前版本为1
param	JSON	是	业务参数，详见下方的请求入参
method	String	是	请求的API英文名，详见各API定义
sign	String	是	API入参的签名结果参数
signMethod	String	是	签名算法，支持HMAC_SHA256和MD5，推荐使用HMAC_SHA256
请求参数
参数名	类型	必须	示例值	详情描述
beginTime	Long	是	1543817629000	订单生成的开始时间（单位毫秒），在当前时间的近90天内，不能大于90天，且小于截止时间
endTime	Long	是	1543817629000	订单生成的截止时间（单位毫秒）在当前时间的近90天内，不能大于90天，且大于开始时间，且与开始时间的时间范围不大于1天 (与开始时间的时间范围建议做成随时可配置，该范围可能在活动期间随时变化，比如变成小时级或者分钟级)。
type	Integer	是	8	退款单请求类型，8 等待退款 9 全部退款订单
pageSize	Integer	是	50	每次请求数量，最多一页100条
currentPage	Long	是	1	当前页码
sort	Integer	否	1	排序方式，1时间降序 2时间升序 ，默认降序
queryType	Integer	否	1	查找方式，1按创建时间查找 2按更新时间查找 ，默认创建时间
negotiateStatus	Integer	否	1	协商状态，1待商家处理 2 商家同意 3商家驳回，等待买家修改 默认返回所有数据
pcursor	String	是	1543843735000_1	游标内容，第一次传空串，之后传上一次的pcursor返回值，若返回“nomore”则标识到底
status	Integer	否	10	退款状态，枚举：[10, "买家已经申请退款，等待卖家同意"] [12, "卖家已拒绝，等待买家处理"] [20, "协商纠纷，等待平台处理"] [30, "卖家已经同意退款，等待买家退货"] [40, "买家已经退货，等待卖家确认收货"] [45, "卖家已经发货，等待买家确认收货"] [50, "卖家已经同意退款，等待系统执行退款"] [60, "退款成功"] [70, "退款关闭"]
option	RefundPageOption	否	{}	选项
orderId	Long	否	2412314120000	订单id，可根据订单id查询关联的所有售后单列表
返回参数
参数名	类型	示例值	详情描述
code	String	1	主返回码
msg	String	success	主返回信息
sub_code	String	1	子返回码
sub_msg	String	SUCCESS	子返回信息
result	Integer	1	返回码，1正确，其他返回码表示接口未执行成功
data	MerchantRefundListDataView	{}	售后单列表信息
error_msg	String	SUCCESS	返回码描述
错误码
错误码	错误类型	错误描述	解决方法
13	参数非法	参数不合法	分页参数不符合‘nomore’ 或 ‘数字_数字’的格式，请检查
16	系统错误	请求过于频繁	请求过于频繁，请稍后重试
51	参数非法	pageSize 应为20	pageSize超过了100
53	参数非法	page number 过大	page number 过大，分页参数为nomore报错
300002	业务错误	退款单类型错误	退款单类型错误
300003	业务错误	结束时间必须大于开始时间	结束时间必须大于开始时间
300005	业务错误	开始时间不能大于90天前	开始时间不能大于90天前
300019	业务错误	时间范围超限	时间范围超限
300107	业务错误	状态无效	status参数不在RefundStatusEnum里
300109	业务错误	退款单请求类型为等待退款时，退款单状态列表中不能包含非等待退款的状态	退款单请求类型为等待退款时，退款单状态列表中不能包含非等待退款的状态
请求示例
JAVA
CURL
package com.kuaishou.merchant.open.api.sdk.demo;
import com.kuaishou.merchant.open.api.common.utils.GsonUtils;
import com.kuaishou.merchant.open.api.request.refund.OpenSellerOrderRefundPcursorListRequest;
import com.kuaishou.merchant.open.api.response.refund.OpenSellerOrderRefundPcursorListResponse;
import com.kuaishou.merchant.open.api.client.AccessTokenKsMerchantClient;

public class AccessTokenKsMerchantClientDemo {

    public static void main(String[] args) {
        String url = "https://openapi.kwaixiaodian.com";
        String appKey = "your appKey";
        String signSecret = "your app signSecret";
        String accessToken = "your accessToken";

        AccessTokenKsMerchantClient client = new AccessTokenKsMerchantClient(url,appKey,signSecret);

        OpenSellerOrderRefundPcursorListRequest request = new OpenSellerOrderRefundPcursorListRequest();
        request.setAccessToken(accessToken);
        request.setApiMethodVersion(1L);

        request.setBeginTime(1543817629000);
        request.setEndTime(1543817629000);
        request.setType(8);
        request.setPageSize(50);
        request.setCurrentPage(1);
        request.setSort(1);
        request.setQueryType(1);
        request.setNegotiateStatus(1);
        request.setPcursor("1543843735000_1");
        request.setStatus(10);
        RefundPageOption obj1 = new RefundPageOption();
        obj1.setNeedExchange(false);
        request.setOption(obj1);
        request.setOrderId(2412314120000);

        OpenSellerOrderRefundPcursorListResponse response = client.execute(request);

        System.out.println(GsonUtils.toJSON(response));
    }
}

响应示例
JSON
{
  "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,
        "refundReasonDesc": "拍多、拍错",
        "expireTime": 1543843735000
      }
    ]
  },
  "error_msg": "SUCCESS"
}
