大头笔查询

提供给商家查询大头笔信息

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/jd/alpha/bigshotquery

公共参数

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

业务参数

名称	类型	必须	示例值	描述
- waybillCode	String	是	111	运单号
- providerId	Number	否	1499	承运商ID
- providerCode	String	是	ZTO	承运商编码,来自[获取签约的快递公司]

二、请求示例代码

Java

请求示例代码

@Test
    public void    WayBillBigshotQuery() throws Exception {

        String sellerNick = Config.JDSellerNick ;
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        data.put("seller_nick", sellerNick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("providerCode", "SF");
        data.put("waybillCode", "SF1655275297820");
        // 参数签名
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        doHttpRequest(Config.JDWayBillBigshotQuery, data);
    }

返回结果

{
    "code": 0,
    "message": "ok",
    "data": {
        "data": {
            "bigShotCode": "010W-010",
            "bigShotName": "010W-010",
            "fromBranchName": "",
            "gatherCenterCode": "",
            "gatherCenterName": "",
            "secondSectionCode": "",
            "thirdSectionCode": "",
            "toBranchName": "",
            "waybillCode": "SF1655275297820"
        },
        "statusCode": 0,
        "statusMessage": "大头笔信息查询成功"
    }
}

说明： code为0表示成功，非0为失败，message会包含失败原因。

四、返回字段说明

名称	类型	示例值	描述
resultInfo	com.jd.ldop.alpha.waybill.api.dto.response.ResponseDTO		处理结果
- statusCode	Number	0	结果编码
- statusMessage	String	调用成功	结果描述
data	java.util.List		符合条件的大头笔列表
—	com.jd.ldop.alpha.waybill.api.dto.waybill.BigShotDTO
- waybillCode	String	111	运单号
- bigShotName	String	测试大头笔	大头笔名称
- bigShotCode	String	001	大头笔编码
- gatherCenterName	String	测试集包地	集包地名称
- gatherCenterCode	String	001	集包地编码
- branchName	String	测试站点	网点名称
- branchCode	String	001	网点编码
- secondSectionCode	String	100	二段码
- thirdSectionCode	String	100	三段码
- toTabletrolleyCode	String	100	目的分拣笼车号
- fromTabletrolleyCode	String	100	始发分拣笼车号
- toCrossCode	String	100	目的分拣滑道号
- fromCrossCode	String	100	始发分拣滑道号
- road	String	100	路区
- orderSign	String	100	订单标识
- packageNo	String	111	包裹号
- fromBranchName	String	通州分拣中心	始发分拣中心
- toBranchName	String	通州分拣中心	目的分拣中心