查询电子面单库存数量
提供给POP查询单号库存
1.请求参数:
请求URL:
POST https://kf.fw199.com/gateway/jd/alpha/waybill/vendor/stock/query
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
| seller_nick | String | 是 | xxxxxx | 京东的账号,对应蜂巢授权返回jdseller字段 |
| sign | String | 是 |
业务参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| - vendorCode | String | 是 | 商家编码 | |
| - providerId | Number | 是 | 承运商ID | |
| - branchCode | String | 否 | 网点编码 |
2. 请求示例代码(Java)
请求示例代码
@Test
public void JDWaybillVendorStockQuery() 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("vendorCode","xxxxxx" );
data.put("providerId","xxxxxx" );
// 参数签名
data.put("sign", Utils.Sign(data, Config.AppSecret));
doHttpRequest(Config.JDWaybillVendorStockQueryUrl, data);
}
`
3. 返回结果如下:
返回结果
{
"code": 0,
"message": "ok",
"data": {
"data": [
{
"amount": 0,
"branchCode": "56210058",
"providerCode": "YDKY",
"providerName": "韵达快运",
"vendorCode": "624092"
},
{
"amount": 78,
"branchCode": "56210540",
"providerCode": "YDKY",
"providerName": "韵达快运",
"vendorCode": "624092"
}
],
"statusCode": 0,
"statusMessage": "调用成功"
}
}
说明: code为0表示成功,非0为失败,message会包含失败原因。业务成功与否见statusCode的值,0为成功.
4. 返回字段说明
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| resultInfo | com.jd.ldop.alpha.waybill.api.dto.response.ResponseDTO | 处理结果 | |
| - statusCode | Number | 结果编码 | |
| - statusMessage | String | 结果描述 | |
| data | java.util.List | 符合条件的单号库存列表 | |
| — | com.jd.ldop.alpha.waybill.api.dto.response.WaybillStockDTO | ||
| - providerCode | String | 承运商编码 | |
| - providerName | String | 承运商名称 | |
| - branchCode | String | 网点编码 | |
| - vendorCode | String | 商家编码 | |
| - vendorName | String | 商家名称 | |
| - amount | Number | 单号库存数量 |
文档更新时间: 2025-11-17 12:16 作者:admin