大头笔查询-非关键

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

1.请求参数:

请求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 承运商编码,来自[获取签约的快递公司]

2. 请求示例代码(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会包含失败原因。

4. 返回字段说明

名称 类型 示例值 描述
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 通州分拣中心 目的分拣中心
文档更新时间: 2023-03-14 16:57   作者:admin