您的位置 : 文档中心 -> API信息

com.alibaba.trade:alibaba.trade.fastCreateOrder-1
【最新】快速创建1688订单(推荐使用) 免费

快速创建1688大市场订单和1688代销订单,订单一步创建,不需要先调用订单预览,接口参数简单,地址参数传省市区街道的文本名,不需要额外查询地址码,系统默认选择最优惠下单方式,默认支付宝担保交易方式

API用户授权类型

需要授权

系统级输入参数

名称 类型 是否必须 描述
_aop_timestamp String 请求时间戳
_aop_signature String 请求签名
access_token String 用户授权令牌

应用级输入参数

名称 类型 是否必须 描述 示例值 默认值
flow String 流程 general(创建大市场订单),saleproxy(创建代销市场订单)
subUserId Long 子账号ID 222222
message String 买家留言 留言
+ addressParam alibaba.trade.fast.address 收货地址信息 {"address":"网商路699号","phone": "0517-88990077","mobile": "15251667788","fullName": "张三","postCode": "000000","areaText": "滨江区","townText": "","cityText": "杭州市","provinceText": "浙江省"}
+ cargoParamList alibaba.trade.fast.cargo[] 商品信息 [{"specId": "b266e0726506185beaf205cbae88530d","quantity": 5,"offerId": 554456348334},{"specId": "2ba3d63866a71fbae83909d9b4814f01","quantity": 6,"offerId": 554456348334}]
+ invoiceParam alibaba.trade.fast.invoice 发票信息 {"invoiceType":0,"cityText": "杭州市","provinceText": "浙江省","address": "网商路699号","phone": "0517-88990077","mobile": "15251667788","fullName": "张五","postCode": "000000","areaText": "滨江区","companyName": "测试公司","taxpayerIdentifier": "123455"}

返回结果

名称 类型 是否必须 描述 示例值
+ result alibaba.trade.fast.result 订单详细信息
success Boolean 是否成功 true
code String 错误编码 400
message String 错误描述 error

返回结果

请求参数示例

  flow=general&message=beizhucesi&addressParam={"address":"网商路699号","phone": "0517-88990077","mobile": "15251667788","fullName": "张三","postCode": "000000","areaText": "滨江区","townText": "","cityText": "杭州市","provinceText": "浙江省"}&cargoParamList=[{"specId": "b266e0726506185beaf205cbae88530d","quantity": 5,"offerId": 554456348334},{"specId": "2ba3d63866a71fbae83909d9b4814f01","quantity": 6,"offerId": 554456348334}]&invoiceParam={"invoiceType":0,"cityText": "杭州市","provinceText": "浙江省","address": "网商路699号","phone": "0517-88990077","mobile": "15251667788","fullName": "张五","postCode": "000000","areaText": "滨江区","companyName": "测试公司","taxpayerIdentifier": "123455"} 

接口说明

  系统默认使用最优惠的方式,默认使用支付宝担保交易,参数简单,地址不再需要额外查询地址码,支持地址文本,更不需要再调预创建订单接口就可以快速创建1688大市场订单(flow传:general)和1688代销(一件代发)订单(flow传:saleproxy) 

Java SDK示例

  ApiExecutor apiExecutor = new ApiExecutor("appKey","secKey");
AlibabatradefastCreateOrderParam param = new AlibabatradefastCreateOrderParam();
param.setFlow("general");//大市场普通订单:general,代销订单:saleproxy
param.setMessage("这里是买家留言");
Alibabatradefastaddress address = new Alibabatradefastaddress();
address.setProvinceText("浙江省");
address.setCityText("杭州市");
address.setAreaText("滨江区");
address.setAddress("网商路699号");
address.setFullName("张三");
address.setMobile("13988888888");
address.setPostCode("888888");
param.setAddressParam(address);
List<Alibabatradefastcargo> cargoList = new ArrayList<Alibabatradefastcargo>();
Alibabatradefastcargo cargo = new Alibabatradefastcargo();
cargo.setOfferId(557856910956L);
cargo.setSpecId("a63c985e3358d02b842322fc287be521");
cargo.setQuantity(5D);
cargoList.add(cargo);
param.setCargoParamList(cargoList.toArray(new Alibabatradefastcargo[]{}));
AlibabatradefastCreateOrderResult result = apiExecutor.execute(param,"accessToken");
if (result.getSuccess()) {
    String orderId = result.getResult().getOrderId();
    System.out.println(orderId);
} 

错误码

错误码 错误描述 解决方案
400 请求参数错误 检查请求参数是否满足要求
500 系统错误 稍后再试或者帮助中心提单咨询
FAIL_BIZ_FAIL_BIZ_SYSTEM_ERROR 系统繁忙, 请重试!:系统繁忙, 请重试! 1、检查OfferID与specId的对应关系,specId对应的规格必须属于offerID对应的商品

API工具