查询电子面单库存数量

提供给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