售后服务单列表查询
用户在申请售后以后,第三方商家使用此接口,查询京东售后服务单列表。例如服务单号,服务单状态,订单类型等服务单信息。自营直通车、厂直模式下,供应商如需使用接口
一、接口名称
- 接口名称:京东售后服务单列表查询
- 请求路径:
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