售后服务单详情查询

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

一、接口名称

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