获取代发订单列表
微信小店代发 - 获取代发订单列表
一、接口名称
接口 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"
}文档更新时间: 2026-04-28 09:46 作者:admin