售后服务单详情查询

用户在申请售后以后,第三方商家使用此接口,对服务单的详情进行查询。例如服务单信息,订单信息,取件信息,返件信息,明细信息,客户信息,取件预约信息等。在自营直通车、厂直模式下,供应商如需使用接口


一、接口名称

  • 接口名称:京东售后服务单详情查询
  • 请求路径/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