跨境订单创建
请求 URLPOST系统级输入参数
应用级输入参数
名称 | 类型 | 是否必须 | 描述 | 示例值 | |
---|---|---|---|---|---|
flow | String | 是 | general(创建大市场订单),fenxiao(创建分销订单),saleproxy流程将校验分销关系,paired(火拼下单),boutiquefenxiao(精选货源分销价下单,采购量1个使用包邮), boutiquepifa(精选货源批发价下单,采购量大于2使用). | general | |
message | String | 否 | 买家留言 | 留言 | |
isvBizType | String | 否 | 开放平台业务码,默认为cross。cross(跨境业务),cross_daigou(跨境代购业务) | cross | |
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"} | |
tradeType | String | 否 | 由于不同的商品支持的交易方式不同,没有一种交易方式是全局通用的,所以当前下单可使用的交易方式必须通过下单预览接口的tradeModeNameList获取。交易方式类型说明:assureTrade(交易4.0通用担保交易),alipay(大市场通用的支付宝担保交易(目前在做切流,后续会下掉)),period(普通账期交易), assure(大买家企业采购询报价下单时需要使用的担保交易流程), creditBuy(诚E赊),bank(银行转账),631staged(631分阶段付款),37staged(37分阶段);此字段不传则系统默认会选取一个可用的交易方式下单,如果开通了诚E赊默认是creditBuy(诚E赊),未开通诚E赊默认使用的方式是支付宝担宝交易。 | assureTrade | |
shopPromotionId | String | 否 | 店铺优惠ID,通过“创建订单前预览数据接口”获得。为空默认使用默认优惠 | itemCoupon-5600812521_31032085284-398517001570 | |
anonymousBuyer | Boolean | 否 | 是否匿名下单 | ||
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 | |
inventoryMode | String | 否 | 库存模式,JIT(jit模式)或 NORMAL(仓发模式),目前只提供给AE使用 | JIT | |
outOrderId | String | 否 | 外部订单号 | 988129883123 | |
pickupService | String | 否 | 上门揽收,目前AE供货可用,其他场景暂不开通.y或n,默认为n | n | |
warehouseCode | String | 否 | 上门揽仓库code | any | |
preSelectPayChannel | String | 否 | 预选的支付渠道,用作财务订单分流。订单信息查询接口返回:result.exAttributes.preSelectPayChannel ,该值是创建订单接口时传入的预选的支付渠道标记。 | alipay | |
smallProcurement | String | 否 | 是否小额采购,目前AE供货可用,取值y/n,默认为n | y | |
useRedEnvelope | String | 否 | 使用红包:y使用,n不使用。默认使用红包 | n | |
dropshipping | String | 否 | 是否转运订单,取值y/n,默认为n | y | |
addedService | String | 否 | 增值服务 toB、toC | toB | |
crossBorderLogisticsSolutionId | String | 否 | 用户选择的官方物流跨境解决方案sourceId | GLOBAL_CAINIAO_VN_TRANSIT_LAND | |
useCrossBorderLogisticsSolution | Boolean | 否 | 是否使用跨境物流解决方案预览,默认为false,当海外地址时,参数不生效。当为港澳台地址时,参数生效 | true | |
extendParam | com.alibaba.ocean.openplatform.biz.trade.param.ExtendParam | 否 | 下单扩展信息 | {} |
返回结果
名称 | 类型 | 描述 | 示例值 | |
---|---|---|---|---|
result | alibaba.trade.cross.result | 创建订单结果 | {} | |
success | Boolean | 是否成功 | true | |
code | String | 错误码 | 400 | |
message | String | 错误信息 | AddressId invalid:AddressId invalid |
错误码
错误码 | 错误描述 | 解决方案 | |
---|---|---|---|
not support tradeType:【XXXX】 | 不支持的交易类型 | 当前交易可支持的交易类型,需要通过预览接口的tradeModeNameList字段获取 |
支付宝方式下单返回示例
{"totalSuccessAmount":156800,"orderId":"87407346014789305","success":false}
账期支付下单返回示例
{"totalSuccessAmount":156800,"orderId":"87407346015789305","success":false,"accountPeriod":{"tapType":5,"tapDate":360,"tapOverdue":1}}
收货地址说明
1、使用保存的收货地址传参示例:{"addressId":593861699},其中addressId是调用“买家获取保存的收货地址信息列表”接口获取; 2、使用地址编码传参示例:{"address":"桃浦镇 金达路888号贸易8楼","phone": "0517-88990077","mobile": "15251667788","fullName": "张三","postCode": "000000","districtCode": "310107"},其中districtCode需要调用“根据地址解析地区码”接口获取; 3、直接使用文本地址示例:{"address":"网商路699号","phone": "0517-88990077","mobile": "15251667788","fullName": "张三","postCode": "000000","areaText": "滨江区","townText": "","cityText": "杭州市","provinceText": "浙江省"},省市区要传文本; 4、优先级说明,如果同时传入以上参数,系统按从1至3的优先级获取地址,满足1的条件下不会使用上示2中的参数,满足2的条件下不会使用上示3中的参数;
同时创建多个订单的返回值
{ "result":{ "success":true, "orderList":[ { "postFee":48000, "orderAmmount":4848000, "discount":0, "sumPaymentNoCarriageFromClient":4800000, "mergePay":false, "orderId":"105581756010628640", "chooseFreeFreight":false }, { "postFee":50000, "orderAmmount":5050000, "discount":0, "sumPaymentNoCarriageFromClient":5000000, "mergePay":false, "orderId":"105637283010628640", "chooseFreeFreight":false } ] }, "success":true }
推荐
-
-
QQ空间
-
新浪微博
-
人人网
-
豆瓣