创建分销订单

创建分销订单,会校验分销关系。先要调用接口创建分销关系、添加分销店铺(买家)。

1.请求参数:

请求URL:

POST https://open.fw199.com/gateway/1688/fenxiao/trade/crate

基础参数

参数名 类型 必须 示例值 说明
appid String true 32432143214214 合作伙伴AppId
timestamp String true 1633618722 当前时间戳
seller_nick String true b2b-1624961122 1688账号
sign String true 999de41d862efaa6f1084ead3b3ba480 如何计算生成见示例代码

业务参数

参数名 类型 必须 示例值 说明
request_data Json true 输入参数字段说明 参见文档

示例

{
  "addressParam" : {
    "address" : "东方路200号",
    "areaText" : "浦东新区",
    "cityText" : "上海市",
    "fullName" : "张三",
    "mobile" : "13877778888",
    "phone" : "021-88889999",
    "postCode" : "200120",
    "provinceText" : "上海",
    "townText" : "陆家嘴街道"
  },
  "bestOption" : true,
  "cargoParamList" : [ {
    "cargoPromotionId" : "0",
    "channel" : "thyny",
    "offerId" : 902719378311,
    "outItemCode" : "902993428771",
    "outShopCode" : "661153176",
    "quantity" : 1,
    "specId" : "3304a52052baafcbd679efd04e8589a5"
  } ],
  "encryptOutOrderInfo" : {
    "encryptOrder" : "true",
    "oaid" : "1bESjqND6CLmfX71Lk5eqqIGjBB55sKmu1R6Sc4AicHIeMYib8ibop4zqmRDQPwiau0WdjCXjFo",
    "outPlatformAppkey" : "21366350",
    "outPlatformCode" : "thyny",
    "outPlatformOrderNo" : "2510738042301603488"
  },
  "flow" : "fenxiao",
  "isSplitJxhy" : false,
  "message" : "通过的订单通过千里马1688分销创建订单",
  "outOrderId" : "bxg-1003"
}

2. 请求示例代码(Java)

@Test
    public void One688FenXiaoTradeCreate() throws Exception {
        //业务参数
        String requestData = "{\n" + "  \"addressParam\": {\n" + "    \"address\": \"东方路200号\",\n" + "    \"areaText\": \"浦东新区\",\n" + "    \"cityText\": \"上海市\",\n" + "    \"fullName\": \"张三\",\n" + "    \"mobile\": \"13877778888\",\n" + "    \"phone\": \"021-88889999\",\n" + "    \"postCode\": \"200120\",\n" + "    \"provinceText\": \"上海\",\n" + "    \"townText\": \"陆家嘴街道\"\n" + "  },\n" + "  \"bestOption\": true,\n" + "  \"cargoParamList\": [\n" + "    {\n" + "      \"cargoPromotionId\": \"0\",\n" + "      \"channel\": \"thyny\",\n" + "      \"offerId\": 902719378311,\n" + "      \"outItemCode\": \"902993428771\",\n" + "      \"outShopCode\": \"661153176\",\n" + "      \"quantity\": 1,\n" + "      \"specId\": \"3304a52052baafcbd679efd04e8589a5\"\n" + "    }\n" + "  ],\n" + "  \"encryptOutOrderInfo\": {\n" + "    \"encryptOrder\": \"true\",\n" + "    \"oaid\": \"1bESjqND6CLmfX71Lk5eqqIGjBB55sKmu1R6Sc4AicHIeMYib8ibop4zqmRDQPwiau0WdjCXjFo\",\n" + "    \"outPlatformAppkey\": \"21366350\",\n" + "    \"outPlatformCode\": \"thyny\",\n" + "    \"outPlatformOrderNo\": \"2510738042301603488\"\n" + "  },\n" + "  \"flow\": \"fenxiao\",\n" + "  \"isSplitJxhy\": false,\n" + "  \"message\": \"通过的订单通过千里马1688分销创建订单\",\n" + "  \"outOrderId\": \"bxg-1003\"\n" + "}";
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid", Config.AppId);
        data.put("seller_nick",  Config.AlibabaFenXiaoSellerNick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("request_data", requestData);
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        // 调用服务API
        String response = doHttpRequest(Config.One688FenXiaoTradeCreateUrl, data);
    }

3. 返回结果如下:

成功的结果

{
  "code": 0,
  "message": "ok",
  "data": {
    "mutilOrders": [],
    "orderId": "4356409609904969811",
    "postFee": 9200,
    "success": true,
    "totalSuccessAmount": 9800
  },
  "trace_id": ""
}

失败的结果

{
  "code": 0,
  "message": "ok",
  "data": {
    "code": "SPEC_NO_EXIST",
    "message": "商品[923983820738]不属于同一卖家或者规格[3304a52052baafcbd679efd04e8589a5] 不属于商品[923983820738]:商品[923983820738]不属于同一卖家或者规格[3304a52052baafcbd679efd04e8589a5] 不属于商品[923983820738]",
    "success": false
  },
  "trace_id": ""
}

说明: code为0表示成功,非0为失败,message会包含失败原因。 详细返回字段说明见文档

文档更新时间: 2025-05-26 20:48   作者:admin