代发订单发货
微信小店代发 - 订单发货(Dropship Order Send)
一、接口名称
接口 URL:https://kf.fw199.com/gateway/wxstore/df/logistics/online
请求方式: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 |
| ds_order_id | string | 是 | 代发订单号 | 4435896307942968320 |
| delivery_list | array | 是 | 物流信息对象列表 | - |
| └─ delivery_id | string | 是 | 快递公司 ID(如 ZTO, SF) | ZTO |
| └─ waybill_id | string | 是 | 快递单号 | 73612959240139 |
| └─ deliver_type | number | 是 | 发货方式,1: 自寄快递发货 | 1 |
| └─ product_infos | array | 是 | 商品明细列表 | - |
| └─ product_id | string | 是 | 商品 ID | 63 |
| └─ sku_id | string | 是 | 商品 SKU | 82 |
| └─ product_cnt | number | 是 | 商品数量 | 2 |
示例请求
{
"ownerId": "a877d3bd-cb6c-467a-becf-ea3db501c0d1",
"ds_order_id": "4435896307942968320",
"delivery_list": [
{
"delivery_id": "SF",
"waybill_id": "SF73612959240139",
"deliver_type": 1,
"product_infos": [
{
"product_id": "10000741839533",
"sku_id": "12739225212",
"product_cnt": 1
}
]
}
]
}
三、请求示例代码 (Java)
import org.junit.Test;
import java.util.HashMap;
import java.util.Map;
import java.util.ArrayList;
import java.util.List;
import com.alibaba.fastjson.JSON;
public class WxstoreDfLogisticsOnlineTest {
@Test
public void dfLogisticsOnline() throws Exception {
String apiUrl = "https://kf.fw199.com/gateway/wxstore/df/logistics/online";
// 供货商openid
String sellerNick = "f524edc1-c2fa-47b0-bfea-f05bbcb14a9a";
// 准备业务请求参数
String reqData = "{\n" + " \"ownerId\": \"a877d3bd-cb6c-467a-becf-ea3db501c0d1\",\n" + " \"ds_order_id\": \"4435896307942968320\",\n" + " \"delivery_list\": [\n" + " {\n" + " \"delivery_id\": \"SF\",\n" + " \"waybill_id\": \"SF73612959240139\",\n" + " \"deliver_type\": 1,\n" + " \"product_infos\": [\n" + " {\n" + " \"product_id\": \"10000741839533\",\n" + " \"sku_id\": \"12739225212\",\n" + " \"product_cnt\": 1\n" + " }\n" + " \n" + " ]\n" + " }\n" + " ]\n" + " }";
data.put("request_data", reqData));
// 参数签名
data.put("sign", Utils.Sign(data, Config.AppSecret));
// 发送请求
String result = doHttpRequest(apiUrl, data);
System.out.println("result:" + result);
}
}
返回结果
成功
{
"code": 10000,
"message": "success",
"result": {
"status": true,
"message": "ok"
}
}
失败
{
"code": 9999,
"message": "请使用电子面单发货 | 代发单需使用微信小店“电子面单”运单号发货。新运单号同步可能延迟,可稍后重试。 rid: 69eddb25-2f3de59f-78c0bb16",
"trace_id": ""
}文档更新时间: 2026-04-28 09:48 作者:admin