跳转到内容
Cheeli 文档
返回官网

售后服务单列表查询

用户在申请售后以后，第三方商家使用此接口，查询京东售后服务单列表。例如服务单号，服务单状态，订单类型等服务单信息。自营直通车、厂直模式下，供应商如需使用接口

一、接口名称

  • 接口名称：京东售后服务单列表查询

  • 请求路径：https://kf.fw199.com/gateway/jd/aftersale/list

  • 请求方式：POST

二、请求参数

公共参数

参数名称参数类型是否必须示例值参数描述
appidString是合作伙伴AppId
timestampString是1657525936当前Unix时间戳，秒
seller_nickString是23242对应蜂巢授权返回 seller_nick字段
signString是

业务参数

参数名类型必填示例值说明
buIdString是15029610京东商家编码（POP 对应 VenderId，厂直/直通车对应 VenderCode）
operatePinString是001操作人（可传客服 PIN 或系统标识）
operateNickString是张三操作人姓名（可传客服姓名或系统名称）
serviceIdNumber否123456服务单号（京东售后业务主单号）
orderIdNumber否123456订单号
applyTimeBeginDate否1727354983000申请开始时间（与申请结束时间配合使用，时间跨度不超过 7 天）
applyTimeEndDate否1727354983200申请结束时间
finishTimeBeginDate否2023-08-10 23:00:00完成时间开始
finishTimeEndDate否2023-08-10 23:00:00完成时间结束
verificationCodeString否abcd验证码
expressCodeString否JDVA1234快递运单号（如京东快递取件单号）
orderTypeNumber否0订单类型（如 0 一般订单、2 拍卖订单等）
processResultNumber否40处理结果（如 23 返修换新、40 退货、50 换良等）
customerPinString否testPin客户账号
customerNameString否testPin客户姓名
customerTelString否123456客户手机
approveTimeBeginDate否2023-08-10 23:00:00审核时间开始
approveTimeEndDate否2023-08-10 23:00:00审核时间结束
pageNumberNumber否1页码（从 1 开始）
pageSizeNumber否10每页大小（1-50，默认 10）
extJsonStrString否{“a”:”a”}扩展条件（JSON 字符串）
serviceStepNumber否10售后环节（如 10 申请阶段、22 商家审核、50 完成、60 取消）
serviceStateNumber否1000售后服务单状态（如 1000 服务单申请、9000 服务单完成等）
serviceStatusNumber否10000服务单环节状态（如 10000 待审核领取、10010 完成、10011 取消等）
updateTimeBeginDate否2023-08-10 23:00:00服务单更新时间起始（当前不支持拉取数据）
updateTimeEndDate否2023-08-10 23:00:00服务单更新时间结束（当前不支持拉取数据）
remindFlagString否1超时提醒标识（1 返回超时提醒数据）
open_id_buyerString否testPin买家账号 openId
xid_buyerString否testPin买家账号 xid

三、请求示例代码

Java

@Test
public void jdAftersaleList() throws Exception {
    String sellerNick = "xxx";
    String apiUrl = "https://kf.fw199.com/gateway/jd/aftersale/list";


    // 业务参数
    Map<String, String> data = new HashMap<>();
    data.put("appid", Config.AppId);
    data.put("seller_nick", sellerNick);


    Long timestamp = System.currentTimeMillis();
    data.put("timestamp", timestamp.toString());


    // 接口业务字段
    data.put("buId", "15029610");
    data.put("operateNick", "张三");
    data.put("operatePin", "001");
    data.put("applyTimeBegin", "1727354983000");
    data.put("applyTimeEnd", "1727354983200");


    // 参数签名
    data.put("sign", Utils.Sign(data, Config.AppSecret));


    String result = doHttpRequest(apiUrl, data);
    System.out.println("result:" + result);
}

四、返回结果

一、返回失败示例

{
    "code": 0,
    "message": "ok",
    "data": {
        "code": "0",
        "pageResult": {
            "data": null,
            "pageNumber": 0,
            "pageSize": 0,
            "success": false,
            "totalCount": 0,
            "code": "10310",
            "msg": "服务单查询申请时间间隔不得大于7天"
        },
        "request_id": "3503690.39587.17781334915095027"
    },
    "trace_id": "8a9cd72c-8bce-4ee0-bd44-44f27d183ae8"
}

二、返回成功示例

{
    "code": 0,
    "message": "ok",
    "data": {
        "code": "0",
        "pageResult": {
            "data": [
                {
                    "actualPayPrice": 12.9,
                    "applyId": 2024672224,
                    "applyTime": 1727354983000,
                    "approveName": "杰1196",
                    "approvePin": "杰1196",
                    "approveResult": 33,
                    "approveResultName": "客户发货",
                    "approveTime": 1727408954000,
                    "customerExpect": 10,
                    "customerExpectName": "退货",
                    "customerGrade": 0,
                    "customerName": "李*",
                    "customerPin": "liyanli0804",
                    "customerTel": "157*******5",
                    "expressCode": "YT3755260982217",
                    "freightUpdateDate": 1727409484000,
                    "oaid": "MWE2MTYyABT5Yz05DTH47QCKVJNOXZu1Yjk1MofTKpZueCWm7Pw9rGGyNsCiD6hOpnNCYyPjWPJ+Z848Cg3IHqU4UidpkUccQnRv1/sUAt+gX63quBFo/fdzArOTFCYZIBtJtIuN3zlL+RAE8YO2vX9vMSrpf65WuhphYg==",
                    "open_id_buyer": "ZHhBDV3usA93B9v83LbKMUaDtPG-AMiE1cusb2cPCrg",
                    "orderId": 301521954471,
                    "orderType": 22,
                    "orderTypeName": "POPSOP",
                    "parentService": 0,
                    "pickwareAddress": "地宝大厦******",
                    "pickwareType": 40,
                    "platformSrc": 106,
                    "platformSrcName": "手机客户端",
                    "processName": "杰1196",
                    "processPin": "杰1196",
                    "processResult": 40,
                    "processResultName": "退货",
                    "processTime": 1728366597000,
                    "questionTypeCid1": 125,
                    "questionTypeCid1Name": "其他",
                    "questionTypeCid2": -1,
                    "questionTypeCid2Name": "",
                    "serviceCount": 1,
                    "serviceId": 2600835894,
                    "serviceStatus": 10010,
                    "serviceStatusName": "完成",
                    "skuId": 10117450116765,
                    "skuType": 1,
                    "skuTypeName": "单品",
                    "skuUuid": "1012_Fu2A1A1395850214050967552",
                    "sysVersion": 13,
                    "updateDate": 1728366597000,
                    "wareName": "春夏百搭女精梳棉蝴蝶结船袜学生可爱短筒袜低帮女袜袜子A 白的-1 36.5",
                    "wareType": 10,
                    "wareTypeName": "主商品",
                    "xid_buyer": "o*AATK8rD6EfPuVgANWqI9Xmb4MDQ5OQVSGOSl20UqqoCFL0N6HYo"
                }
            ],
            "pageNumber": 1,
            "pageSize": 10,
            "success": true,
            "totalCount": 1,
            "code": "",
            "msg": ""
        },
        "request_id": "157722.39587.17781337601453950"
    },
    "trace_id": "90c70ca5-10e1-49b9-8204-da80022d977f"
}

　说明： 最外层code为0表示成功，非0为失败，最外层message会包含失败原因。其他字段见京东官方文档https://open.jd.com/v2/#/doc/api?apiCateId=241&apiId=2136&apiName=jingdong.asc.query.list&gwType=0