创建分销订单
创建分销订单,会校验分销关系。先要调用接口创建分销关系、添加分销店铺(买家)。
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