取号接口

如果使用代发模式,填ewaybill_order_code,去替换ec_order_id字段。
ewaybill_order_code可从小店订单详情接口获取。

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/wxv/waybill/get

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

业务参数

参数名称 参数类型 是否必须 示例值 参数描述
request_data JSON 报文

2. 请求示例代码(Java)

@Test  
public void wayBillGet() throws Exception {  
          String reqData ="{\n" + "    \"ewaybill_order_id\": \"78\",\n" + "    \"order_type\":\"1\",\n" + "    \"delivery_id\": \"ZTO\",\n" + "    \"site_code\": \"579907\",\n" + "    \"ewaybill_acct_id\": \"26\",\n" + "    \n" + "    \"sender\": {\n" + "        \"name\": \"叶泽峰\",\n" + "        \"mobile\": \"18368840752\",\n" + "        \"province\": \"浙江省\",\n" + "        \"city\": \"金华市\",\n" + "        \"county\": \"东阳市\",\n" + "        \"street\": \"\",\n" + "        \"address\": \"汉宁东路468号\"\n" + "    },\n" + "    \"receiver\": {\n" + "        \"name\": \"小*\",\n" + "        \"mobile\": \"131****2717\",\n" + "        \"province\": \"福建省\",\n" + "        \"city\": \"泉州市\",\n" + "        \"county\": \"安溪县\",\n" + "        \"street\": \"\",\n" + "        \"address\": \"****\"\n" + "    },\n" + "    \"order_shop_name\":\"订单店铺名字\",\n" + "    \"ec_order_list\": [\n" + "        {\n" + "            \"ewaybill_order_code\": 3721511129515429888,\n" + "            \"goods_list\": [\n" + "                {\n" + "                    \"good_name\": \"大号仿真减压神器包子发泄捏捏乐慢回弹减压玩具仿真小笼包\",\n" + "                    \"good_count\": 1,\n" + "                    \"product_id\": 10000102290752,\n" + "                    \"sku_id\": 2059341850\n" + "                }\n" + "            ]\n" + "        }\n" + "    ],\n" + "    \"shop_id\": 5009833132232,\n" + "    \"ownerId\": \"59\",\n" + "    \"wp_type\": \"1\"\n" + "}";

    String sellerNick = "xxx";
    //业务参  
    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("request_data", reqData);   
    // 参数签名  
    data.put("sign", Utils.Sign(data, Config.AppSecret));  
    String result = doHttpRequest(apiUrl, data);  
    System.out.println("result:"+result);  
}

3. 返回结果

返回结果如下

{
    "code": 0,
    "message": "处理成功",
    "data": {
        "status": true,
        "waybill_id": "73612959088427",
        "ewaybill_order_id": "3622866922816946177",
        "print_info": "JTdCJTIycHJpbnREYXRhJTIyJTNBJTdCJTIyd2F5YmlsbElkJTIyJTNBJTIyNzM2MTI5NTkwODg0MjclMjIlMkMlMjJwcmludFRpbWUlMjIlM0ElMjIyMDI0JTJGMDklMkYwNSUyMDE4JTNBMjYlMjIlMkMlMjJzMjUlMkYzZWNiYjNhYS01YmNmLTQwNGQtOTcyYS04YTA4YTgxNjIyM2MuaHRtbCUyMiUyQyUyMmN1c3RvbUNvbmZpZyUyMiUzQSU3QiUyMndpZHRoJTIyJTNBNjU2JTJDJTIyaGVpZ2h0JTIyJTNBMzAwJTJDJTIybGVmdCUyMiUzQTYwJTJDJTIydG9wJTIyJTNBOTMwJTdEJTJDJTIyd2lkdGglMjIlM0E3NiUyQyUyMmhlaWdodCUyMiUzQTEzMCU3RCU3RA=="
    }
}

返回code为0表示成功, 非0为失败,失败时message会有失败原因。

文档更新时间: 2025-12-29 20:22   作者:admin