| 名称 | 类型 | 是否必须 | 描述 | 示例值 | |
|---|---|---|---|---|---|
| flow | String | 是 | general（创建大市场订单），fenxiao（创建分销订单）,saleproxy流程将校验分销关系,paired(火拼下单),boutiquefenxiao(精选货源分销价下单，采购量1个使用包邮)， boutiquepifa(精选货源批发价下单，采购量大于2使用). | general | |
| 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"} | |
| isvBizTypeStr | String | 否 | 开放平台业务码,区分具体业务,isv_fxgl等 | 请咨询运营，不同解决方案使用不同业务码 | |
| isvBizTypeErp | Boolean | 否 | erp分销场景时传入true。会修改默认的isvBizType为erp_buy。其他场景不用传入 | false | |
| isvBizTypePD | Boolean | 否 | 拍单场景时传入true。会修改默认的isvBizTyp为isv_pd_buy | false | |
| shopPromotionId | String | 否 | 店铺优惠ID，通过“创建订单前预览数据接口”获得。为空默认使用默认优惠 | itemCoupon-5600812521_31032085284-398517001570 | |
| tradeType | String | 否 | 由于不同的商品支持的交易方式不同，没有一种交易方式是全局通用的，所以当前下单可使用的交易方式必须通过下单预览接口的tradeModeNameList获取。交易方式类型说明：assureTrade（交易4.0通用担保交易），alipay（大市场通用的支付宝担保交易（目前在做切流，后续会下掉）），period（普通账期交易）, assure（大买家企业采购询报价下单时需要使用的担保交易流程）, creditBuy（诚E赊），bank（银行转账），631staged（631分阶段付款），37staged（37分阶段）；此字段不传则系统默认会选取一个可用的交易方式下单，如果开通了诚E赊默认是creditBuy（诚E赊），未开通诚E赊默认使用的方式是支付宝担宝交易。 | assureTrade | |
| encryptOutOrderInfo | alibaba.trade.fastCreateOrder.EncryptOutOrderInfo | 否 | 下游加密订单信息，用于下游平台打单使用。如果下游明文，encryptOrder传入false | {} | |
| instanceId | String | 否 | 批发团instanceId,从alibaba.pifatuan.product.list获取 | 4063139_1662080400000 | |
| proxySettleRecordId | String | 否 | 分账普通下单采购单id，交易flow为“proxy” | 4051300002 | |
| fenxiaoChannel | String | 否 | 回流订单下游平台 淘宝-thyny，天猫-tm，淘特-taote，阿里巴巴C2M-c2m，京东-jingdong，拼多多-pinduoduo，微信-weixin，跨境-kuajing，快手-kuaishou，有赞-youzan，抖音-douyin，寺库-siku，美团团好货-meituan，小红书-xiaohongshu，当当-dangdang，苏宁-suning，大V店-davdian，行云-xingyun，蜜芽-miya，菠萝派商城-boluo，快团团-kuaituantuan，其他-other | douyin | |
| outOrderId | String | 否 | 外部订单号,可用于幂等。通过订单列表接口可以传入该值查询订单信息 | 123 | |
| preSelectPayChannel | String | 否 | 预选的支付渠道，用作财务订单分流。订单信息查询接口返回：result.exAttributes.preSelectPayChannel ，该值是创建订单接口时传入的预选的支付渠道标记。 | alipay | |
| noUseRedEnvelope | Boolean | 否 | 弃用 | false | |
| useRedEnvelope | String | 否 | 使用红包：n不使用，y使用。默认使用红包 | n |
| 名称 | 类型 | 描述 | 示例值 | |
|---|---|---|---|---|
| result | alibaba.trade.fast.result | 订单详细信息 | ||
| success | Boolean | 是否成功 | true | |
| code | String | 错误编码 | 400 | |
| message | String | 错误描述 | error |
| 错误码 | 错误描述 | 解决方案 | |
|---|---|---|---|
| 400 | 请求参数错误 | 检查请求参数是否满足要求 | |
| 400 | User authorization is required | TOKEN失效，需要重新获取 | |
| 400 | Address is required | 收货地址必须要填 | |
| 400 | Cargo list is required | 货品信息必须要填 | |
| 400 | max cargo count is | 超过最大购买数 | |
| 400 | OfferId and quantity is required | 商品ID和购买数量必须要填 | |
| 400 | AddressId or FullName and Address is required | 收货地址信息要填完整 | |
| 400 | FullName length is required in 2~25 | 收货人信息长度范围为2-25 | |
| 400 | phone length is required 1~30 | 电话号码长度范围为1-30 | |
| 400 | Flow is empty or not exist | flow参数必填，若接口没有要求传flow则可以忽略 | |
| 400 | Cargo list not duplicate is required | 货品信息出现了重复的情况，需要累加处理 | |
| 400 | not support tradeType: | 不支持的交易方式 | |
| 400 | availableQuota less than sumPayment | 可用额度不足，需要先联系卖家提升账期可用额度 | |
| 500 | view order service error | 接口调用出错，请检查参数是否正确或稍后重试 | |
| FAIL_BIZ_FAIL_BIZ_UNSUPPORT_MIX | 该卖家不支持混批,所有货品数量应该达到最小起批量。请重新选择货品或修改购买数量后进行下单。 | - | |
| FAIL_BIZ_FAIL_BIZ_BOOKED_BEYOND_THE_MAX_QUANTITY | 该订单中部分货品的订购数量超过了最大允许的购买量。 | - | |
| FAIL_BIZ_FAIL_BIZ_BOOKED_LESS_THAN_LEAST_QUANTITY | 该订单中部分货品的订购数量小于最小起批量。 | - | |
| FAIL_BIZ_FAIL_BIZ_ILLEGAL_OFFER | 该订单中部分货品不支持交易，请联系卖家。 | - | |
| FAIL_BIZ_FAIL_BIZ_LESS_THAN_MIX_BEGIN | 该订单中部分货品数量小于混批起批量，请重新选择货品进行下单。 | - | |
| FAIL_BIZ_FAIL_BIZ_ILLEGAL_CARGO_DATA | 货品信息错误或者货品已失效，请重试 | - | |
| FAIL_BIZ_QUANTITY_UNMATCH_SELLUNIT_SCALE | 您该笔订单的货品数量不符合订购要求，请查看卖家设置并修改。 | - | |
| FAIL_BIZ_ORDER_VIEW_RESULT_NOT_GET | 订单展示服务没有返回处理结果。 | - | |
| FAIL_BIZ_PRODUCT_TRADE_STAT_ERROR | 库存不足或扣减库存时出现了问题。请确认购买数量后重新提交订单。 | - | |
| FAIL_BIZ_FAIL_BIZ_PROXY_RELATED_NOT_FUND | 卖家未授权代销，您不能在此通道下单!请联系卖家授权! | - | |
| FAIL_BIZ_FAIL_BIZ_QUANTITY_OUT_OF_SCOPE | 订购数量必须大于0小于等于10亿。 | - | |
| FAIL_BIZ_MESSAGE_LENGTH_IS_ILLEGA | 您的留言过长，留言长度须小于500个字符，请更改留言! | - | |
| FAIL_BIZ_FAIL_BIZ_CARGO_CANNOT_AUTH | 您无权购买该订单中部分私密货品，请联系卖家。 | - | |
| FAIL_BIZ_FAIL_BIZ_ILLEGAL_SELLER_NOT_ENABLED | 卖家处于无效状态!不允许进行交易! | - | |
| FAIL_BIZ_CARGO_CARRIAGE_HAS_CHANGED | 该货品运费已变化，请重新确认订单或者联系卖家。 | - | |
| FAIL_BIZ_RECEIVE_ADDRESS_MOBILE_PHONE_NULL | 收货地址里的电话和手机不能同时为空。 | - | |
| FAIL_BIZ_XXX_ALL_ORDER_BLOCKS_SOME_COMMIT_ERROR | 部分订单提交逻辑处理失败。 | - | |
| FAIL_BIZ_SYSTEM_ERROR | 系统繁忙,请重试! | - | |
| FAIL_BIZ_FAIL_BIZ_CARGO_CARRIAGE_HAS_ERROR | 获取该货品运费发生错误，请重试。 | - | |
| FAIL_BIZ_FAIL_BIZ_OFFER_PREHEATING | 该订单中存在商品未到指定开售时间。 | - | |
| FAIL_BIZ_TRADE_TYPE_HAS_CHANGED_RE_SELECT | 交易方式发生变化请重新选择。 | - | |
| FAIL_BIZ_NO_SERVICE_INFO | 未获取到服务信息，服务数据可能发生变化! | - | |
| FAIL_BIZ_TAOBAO_TP_EXCEPTION | 系统错误，订单创建失败! | - | |
| FAIL_BIZ_ORDER_COMMIT_ORDERPARAM_NOT_CONSTRUCTED | 交时没有成功构造创建订单的参数。 | - |
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); }
字段长度说明详细街道地址（address）必须不超过200个字，不要用地址做其他用途，需要留言或备注的有专门字段，留言（message）和订单备忘（参见：alibaba.order.memoAdd）都支持500字