售后服务单列表查询

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

一、接口名称

  • 接口名称:京东售后服务单列表查询
  • 请求路径https://kf.fw199.com/gateway/jd/aftersale/list
  • 请求方式POST

二、请求参数

公共参数

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

业务参数

参数名 类型 必填 示例值 说明
buId String 15029610 京东商家编码(POP 对应 VenderId,厂直/直通车对应 VenderCode)
operatePin String 001 操作人(可传客服 PIN 或系统标识)
operateNick String 张三 操作人姓名(可传客服姓名或系统名称)
serviceId Number 123456 服务单号(京东售后业务主单号)
orderId Number 123456 订单号
applyTimeBegin Date 1727354983000 申请开始时间(与申请结束时间配合使用,时间跨度不超过 7 天)
applyTimeEnd Date 1727354983200 申请结束时间
finishTimeBegin Date 2023-08-10 23:00:00 完成时间开始
finishTimeEnd Date 2023-08-10 23:00:00 完成时间结束
verificationCode String abcd 验证码
expressCode String JDVA1234 快递运单号(如京东快递取件单号)
orderType Number 0 订单类型(如 0 一般订单、2 拍卖订单等)
processResult Number 40 处理结果(如 23 返修换新、40 退货、50 换良等)
customerPin String testPin 客户账号
customerName String testPin 客户姓名
customerTel String 123456 客户手机
approveTimeBegin Date 2023-08-10 23:00:00 审核时间开始
approveTimeEnd Date 2023-08-10 23:00:00 审核时间结束
pageNumber Number 1 页码(从 1 开始)
pageSize Number 10 每页大小(1-50,默认 10)
extJsonStr String {“a”:”a”} 扩展条件(JSON 字符串)
serviceStep Number 10 售后环节(如 10 申请阶段、22 商家审核、50 完成、60 取消)
serviceState Number 1000 售后服务单状态(如 1000 服务单申请、9000 服务单完成等)
serviceStatus Number 10000 服务单环节状态(如 10000 待审核领取、10010 完成、10011 取消等)
updateTimeBegin Date 2023-08-10 23:00:00 服务单更新时间起始(当前不支持拉取数据)
updateTimeEnd Date 2023-08-10 23:00:00 服务单更新时间结束(当前不支持拉取数据)
remindFlag String 1 超时提醒标识(1 返回超时提醒数据)
open_id_buyer String testPin 买家账号 openId
xid_buyer String 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);
}

四、返回结果

1. 返回失败示例

{
    "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"
}

2. 返回成功示例

{
    "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

文档更新时间: 2026-05-07 15:11   作者:admin