售后服务单详情查询
用户在申请售后以后,第三方商家使用此接口,对服务单的详情进行查询。例如服务单信息,订单信息,取件信息,返件信息,明细信息,客户信息,取件预约信息等。在自营直通车、厂直模式下,供应商如需使用接口
一、接口名称
- 接口名称:京东售后服务单详情查询
- 请求路径:
/gateway/jd/aftersale/view - 请求方式:
POST - 网关前缀:
https://kf.fw199.com
二、请求参数
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
| seller_nick | String | 是 | 23242 | 对应蜂巢授权返回 seller_nick字段 |
| sign | String | 是 |
业务参数
| buId | String | 是 | 123456 | 商家编号(最长50,该字段从平台获取) |
|---|---|---|---|---|
| operatePin | String | 是 | testPin | 最长50(①如有,传客服PIN即可;②也可直接传调用系统名称之类;该字段不是强校验) |
| operateNick | String | 是 | testPin | 最长50(①如有,传客服姓名即可;②也可直接传调用系统名称之类;该字段不是强校验) |
| serviceId | Number | 是 | 123456 | 服务单号(该字段从平台获取) |
| orderId | Number | 是 | 123456 | 订单号 |
| extJsonStr | String | 否 | {a: a} | 扩展条件(JSON格式) |
三、请求示例代码(Java)
@Test
public void aftersaleView() throws Exception {
String sellerNick = "xxx";
String apiUrl = "https://kf.fw199.com/gateway/jd/aftersale/view";
// 业务参
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("serviceId", "123456789");
// 参数签名
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",
"request_id": "7516340.39587.17781367520023171",
"result": {
"data": {
"afsContactInfo": {
"cityCode": 0,
"countyCode": 0,
"provinceCode": 0,
"villageCode": 0
},
"applyDetailList": {},
"applyId": 2024672224,
"applyTime": 1727354983000,
"approveDate": 1727408954000,
"approveName": "杰1196",
"approveNotes": "同意",
"approvePin": "杰1196",
"approveResult": 33,
"approveResultName": "客户发货",
"companyId": 709,
"customerExpect": 10,
"customerExpectName": "退货",
"customerInfo": {
"contactInfo": {
"cityCode": 0,
"contactMobile": "158*******1",
"contactName": "李*",
"contactTel": "156*******0",
"countyCode": 0,
"provinceCode": 0,
"villageCode": 0
},
"grade": 56,
"jdPin": "liyanli0804",
"name": "李*",
"open_id_buyer": "ZHhBDV3usA93B9v83LbKMUaDtPG-AMiE1cusb2cPCrg",
"xid_buyer": "o*AATK8rD6EfPuVgANWqI9Xmb4MDQ5OQVSGOSl20UqqoCFL0N6HYo"
},
"expectPickwareType": 40,
"expectPickwareTypeName": "客户发货",
"expressage": {
"expressCode": "YT3755260982217",
"expressCompany": "圆通快递",
"serviceId": 1652418315
},
"extJsonStr": "{\"afsPay\":\"0000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000\",\"payingMember\":\"0\",\"JSY_SMART_VAL\":\"{}\",\"no_shop_responsibility_reason\":\"未命中商责原因\",\"batchTotalJdPrice\":\"12.90\",\"isJdBatch\":\"20\",\"KJ_PRODUCT_STATE\":\"0\",\"afs_topSpeed\":\"1\",\"APPLYREASON\":\"发票问题\",\"user_tag_code\":\"66-663-6613;11-861-8613;\",\"customerExpLimitTime\":\"1727971200894\",\"geekpay\":\"00000000000000000000000000000000000000000000000000\",\"promise_batchId\":\"4\",\"feeRuleId\":\"0000\",\"topSpeedTwoFlag\":\"2\"}",
"orderId": 301521954471,
"orderType": 22,
"orderTypeName": "POPSOP",
"pickwareAddress": {
"cityCode": 1482,
"countyCode": 48936,
"detailAddress": "地宝大厦******",
"oaid": "ZGIwOWU3ABT5Yz05DTH4=",
"provinceCode": 18,
"villageCode": 53632
},
"pickwareType": 40,
"pickwareTypeName": "客户发货",
"processName": "杰1196",
"processNotes": "商家提交聚宝盆退款",
"processPin": "杰1196",
"processResult": 40,
"processResultName": "退货",
"questionDesc": "退",
"questionPic": "",
"questionTypeCid1": 125,
"questionTypeCid1Name": "其他",
"questionTypeCid2": -1,
"questionTypeCid2Name": "",
"receiveDate": 1727409831000,
"refundType": 20,
"refundTypeName": "原返",
"returnWareAddress": {
"cityCode": 1482,
"countyCode": 48936,
"detailAddress": "地宝大厦******",
"oaid": "ZGIwOWU3ABT5Yz05DTH47QCKVJNOvDhtsJ5w==",
"provinceCode": 18,
"villageCode": 53632
},
"returnWareType": 10,
"returnWareTypeName": "自营配送",
"serviceBillDetailList": [
{
"actualPayPrice": 12.9,
"payPrice": 12.9,
"serviceDetailIdLong": 3591045679,
"skuId": 10117450116765,
"skuType": 1,
"skuUuid": "1012_Fu2A1A1395850214050967552",
"wareCid1": 1315,
"wareCid2": 1345,
"wareCid3": 12010,
"wareName": "春夏百搭女精梳棉蝴蝶结船袜学生可爱短筒袜低帮女袜袜子A 白的-1 36.5",
"wareNum": 1,
"wareType": 10
}
],
"serviceCount": 1,
"serviceId": 2600835894,
"serviceStatus": 10010,
"serviceStatusName": "完成",
"sysVersion": 13,
"updateDate": 1728366597000,
"updateName": "杰1196"
},
"success": true
}
},
"trace_id": "97cf4723-9f24-4621-bc3b-47d037ba9550"
}说明: 最外层code为0表示成功,非0为失败,最外层message会包含失败原因。其他字段见京东官方文档https://open.jd.com/v2/#/doc/api?apiCateId=241&apiId=2118&apiName=jingdong.asc.query.view&gwType=0
文档更新时间: 2026-05-07 15:21 作者:admin