大头笔查询-非关键
提供给商家查询大头笔信息
1.请求参数:
请求URL:
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
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