查询商面单订购关系以及面单使用情况

查询商家和物流商的订购关系以及面单使用情况

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/ks/express/subscribe/query

参数名称 参数类型 是否必须 示例值 参数描述
appid String 合作伙伴AppId
timestamp String 1657525936 当前Unix时间戳,秒
seller_nick String 38173182 快手的店铺账号,对应蜂巢授权返回seller_nick字段
sign String

业务参数

2. 请求示例代码(Java)

  @Test  
public void ExpressSubscribeQuery() throws Exception {  

    String sellerNick = Config.KSSellerNick ;  
    //业务参数  
    Map<String, String> data = new HashMap();  
    data.put("appid",  Config.AppId);  
    data.put("seller_nick", sellerNick);  
    Long timestamp = System.currentTimeMillis();  
    data.put("timestamp", timestamp.toString());  
    // 参数签名  
    data.put("sign", Utils.Sign(data, Config.AppSecret));  
    String result = doHttpRequest(Config.KS_OPEN_EXPRESS_SUBSCRIBE_QUERY, data);  
    System.out.println("result:"+result);  
}

3. 返回结果

返回结果如下

{
  "code": 0,
  "message": "ok",
  "data": [

    {
      "allocatedQuantity": 13,
      "availableQuantity": 0,
      "cancelQuantity": 5,
      "expressCompanyCode": "SF",
      "expressCompanyType": 1,
      "netSiteCode": "",
      "netSiteName": "",
      "recycledQuantity": 0,
      "senderAddress": [
        {
          "cityCode": "3101",
          "cityName": "市辖区",
          "countryCode": "",
          "countryName": "",
          "detailAddress": "东路100号",
          "districtCode": "310115",
          "districtName": "浦东新区",
          "provinceCode": "31",
          "provinceName": "上海市",
          "streetCode": "",
          "streetName": ""
        }
      ],
      "settleAccount": "022321111",
      "usedQuantity": 0
    },
    {
      "allocatedQuantity": 0,
      "availableQuantity": 0,
      "cancelQuantity": 0,
      "expressCompanyCode": "STO",
      "expressCompanyType": 2,
      "netSiteCode": "200590",
      "netSiteName": "上海浦东十部公司",
      "recycledQuantity": 0,
      "senderAddress": [
        {
          "cityCode": "3101",
          "cityName": "市辖区",
          "countryCode": "",
          "countryName": "",
          "detailAddress": "东路100号",
          "districtCode": "310115",
          "districtName": "浦东新区",
          "provinceCode": "31",
          "provinceName": "上海市",
          "streetCode": "",
          "streetName": ""
        }
      ],
      "settleAccount": "",
      "usedQuantity": 0
    } 
  ]
}


4. 返回字段说明

返回字段说明见官方文档: https://open.kwaixiaodian.com/docs/api?apiName=open.express.subscribe.query&version=1

文档更新时间: 2023-06-27 00:08   作者:admin