查询电子面单库存数量
提供给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 | 是 | 38173182 | 京东的账号,对应蜂巢授权返回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","624092" );
data.put("providerId","731302" );
// 参数签名
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 | 单号库存数量 |
文档更新时间: 2024-08-02 11:25 作者:admin