获取代发订单列表

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

一、接口名称

接口 URLhttps://kf.fw199.com/gateway/wxstore/df/order/list
请求方式POST
Content-Typeapplication/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"
}
文档更新时间: 2026-04-28 09:46   作者:admin