获取代发面单订单详情(根据电子面单订单ID查询)

微信小店代发 - 获取代发面单订单详情(根据电子面单订单ID查询)

一、接口名称

接口 URLhttps://kf.fw199.com/gateway/wxstore/df/waybill/order
请求方式POST
Content-Typeapplication/json


二、请求参数

参数名 类型 是否必需 说明 示例值
appid string 开发者分配的 AppID Config.AppId
seller_nick string 供货商 OpenID (对应业务字段 ownerId) f524edc1-c2fa-47b0-bfea-f05bbcb14a9a
timestamp string 毫秒级时间戳 1713824000000
sign string 请求参数签名字符串 682bc45f6d54d28e6664aec2ace60990
ewaybill_order_id string 电子面单订单 ID (Uint64 的字符串形式) 4435896307942968320

三、请求示例代码 (Java)

import org.junit.Test;
import java.util.HashMap;
import java.util.Map;

public class WxstoreDfWaybillOrderTest {

    @Test
    public void getDfWaybillOrder() throws Exception {

        String apiUrl = "https://kf.fw199.com/gateway/wxstore/df/waybill/order";
        // 供货商openid
        String sellerNick = "f524edc1-c2fa-47b0-bfea-f05bbcb14a9a";

        // 准备请求参数映射
        Map<String, String> data = new HashMap<>();
        data.put("appid",  Config.AppId);
        data.put("seller_nick", sellerNick);

        // 业务参数:电子面单订单ID
        data.put("ewaybill_order_id", "4435896307942968320");

        // 公共参数:时间戳
        Long timestamp = System.currentTimeMillis();
        data.put("timestamp", timestamp.toString());

        // 参数签名
        data.put("sign", Utils.Sign(data, Config.AppSecret));

        // 调用封装好的 HTTP 请求方法
        String result = doHttpRequest(apiUrl, data);
        System.out.println("result:" + result);
    }
}

三、返回结果

{
    "code": 0,
    "message": "ok",
    "data": {
        "errcode": 0,
        "errmsg": "ok",
        "order_info": {
            "ewaybill_order_id": "4435896307942968320",
            "delivery_id": "SF",
            "site_code": "",
            "ewaybill_acct_id": "6643642397",
            "sender": {
                "name": "张三",
                "mobile": "138161271129",
                "province": "上海市",
                "city": "上海市",
                "county": "浦东新区",
                "street": "",
                "address": "东方路200"
            },
            "receiver": {
                "name": "m**",
                "mobile": "138****7333",
                "province": "上海市",
                "city": "上海市",
                "county": "浦东新区",
                "street": "",
                "address": "陆家嘴街道商城路738号1205"
            },
            "ec_order_list": [
                {
                    "ec_order_id": 3735813677907337217,
                    "goods_list": [
                        {
                            "good_name": "夏天男士凉拖",
                            "good_count": 1,
                            "product_id": 10000741839533,
                            "sku_id": 12739225212
                        }
                    ]
                }
            ],
            "remark": "",
            "shop_id": "5009842502159",
            "waybill_id": "SF0227273607835",
            "status": 2,
            "path_info": [],
            "order_type": 1,
            "monthly_card": "0211498704",
            "order_vas_list": [],
            "ext_info": [],
            "sub_waybill_id_list": []
        }
    },
    "trace_id": "2c5237cb-6d04-4090-8de8-8b8d8ea3f6b6"
}

返回字段说明见https://developers.weixin.qq.com/doc/store/shop/API/channels-shop-delivery/ewaybill/api_ewaybill_getorder.html

文档更新时间: 2026-04-28 09:47   作者:admin