查询电子面单库存数量

提供给POP查询单号库存

一、请求参数

请求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	否		网点编码

二、请求示例代码

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);
    }

 `

三、返回结果

返回结果

{
  "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为成功.

四、返回字段说明

名称	类型	示例值	描述
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		单号库存数量