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

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

一、请求参数

请求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	是

业务参数

无

二、请求示例代码

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

三、返回结果

返回结果如下

{
  "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
    }
  ]
}

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