代发-获取代发电子面单订单详情

获取代发面单订单详情

根据电子面单订单ID查询

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

一、接口名称

接口 URL：https://kf.fw199.com/gateway/wxstore/df/waybill/order 请求方式：POST Content-Type：application/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