代发-获取代发订单列表

获取代发订单列表

微信小店代发 - 获取代发订单列表

一、接口名称

接口 URL：https://kf.fw199.com/gateway/wxstore/df/order/list 请求方式：POST Content-Type：application/json

　

二、请求参数

参数名	类型	是否必需	说明	示例值
**appid**	string	**是**	开发者分配的 AppID	`Config.AppId`
**seller_nick**	string	**是**	供货商 OpenID，从应用首页获取	`a0dd286e-80df-4d31-9659-4d61a4dc2a9c`
**timestamp**	string	**是**	毫秒级时间戳	`1713824000000`
**sign**	string	**是**	请求参数签名字符串	`682bc45f6d54d28e6664aec2ace60990`
**start_time**	string	**是**	订单获取开始时间，格式：`yyyy-MM-dd HH:mm:ss`
**end_time**	string	**是**	订单获取结束时间，格式：`yyyy-MM-dd HH:mm:ss`
**next_key**	string	否	分页参数，传入上一页请求返回的凭证。首次请求传空字符串	`offset_100`
**page_size**	string	否	每页返回的条数，最大支持 100	`20`
**order_status**	number	否	默认是待发货状态， 如果传了则筛选对应状态，100待发货,199部分发货,200已发货,300已取消	`100`
**shop_appid**	string	否	关联的商家 AppID	`wx9acf39d4f153ceb8`

三、请求示例代码

Java

@Test
public void getDfOrderList() throws Exception {

    String apiUrl = "https://kf.fw199.com/gateway/wxstore/df/order/list";
    // 供货商openid
    String sellerNick = "a0dd286e-80df-4d31-9659-4d61a4dc2a9c";

    // 准备业务与公共参数映射
    Map<String, String> data = new HashMap<>();
    data.put("appid", Config.AppId);
    data.put("seller_nick", sellerNick);

    // 业务参数设置
    data.put("start_time", "2024-07-27 00:00:00");
    data.put("end_time", "2024-07-27 23:59:59");
    data.put("next_key", "");
    data.put("page_size", "20");
    data.put("order_status", "100");
    data.put("shop_appid", "wx9acf39d4f153ceb8");

    // 系统参数
    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": {
        "order_id_list": [
            "4435896307942968320"
        ],
        "next_key": {
            "offset": 100,
            "limit": 100
        },
        "has_more": false
    },
    "trace_id": "684dc615-856b-4c52-bd02-2a55c4d1eeec"
}