代发订单发货

微信小店代发 - 订单发货(Dropship Order Send)

一、接口名称

 
接口 URLhttps://kf.fw199.com/gateway/wxstore/df/logistics/online
请求方式POST
Content-Typeapplication/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