简体中文
    1688跨境API
    API及消息列表
    类目
    商品
    订单
    支付
    退货
    会员
    物流
    消息
    回传
    商机
    AI能力
    采购
    工具
    交易
    包裹
    说明
    详细内容

    跨境订单创建

    请求 URLPOST系统级输入参数


    		名称类型是否必须描述文档

    		_aop_timestampString否请求时间戳文档地址

    		_aop_signatureString是请求签名文档地址

    		access_tokenString是用户授权令牌文档地址


    应用级输入参数


    		名称类型是否必须描述示例值

    		flowString是general（创建大市场订单），fenxiao（创建分销订单）,saleproxy流程将校验分销关系,paired(火拼下单),boutiquefenxiao(精选货源分销价下单，采购量1个使用包邮)， boutiquepifa(精选货源批发价下单，采购量大于2使用).general

    		messageString否买家留言留言

    		isvBizTypeString否开放平台业务码,默认为cross。cross(跨境业务),cross_daigou（跨境代购业务）cross

    		addressParamalibaba.trade.fast.address是收货地址信息{"address":"网商路699号","phone": "0517-88990077","mobile": "15251667788","fullName": "张三","postCode": "000000","areaText": "滨江区","townText": "","cityText": "杭州市","provinceText": "浙江省"}

    		cargoParamListalibaba.trade.fast.cargo[]是商品信息[{"specId": "b266e0726506185beaf205cbae88530d","quantity": 5,"offerId": 554456348334},{"specId": "2ba3d63866a71fbae83909d9b4814f01","quantity": 6,"offerId": 554456348334}]

    		invoiceParamalibaba.trade.fast.invoice否发票信息{"invoiceType":0,"cityText": "杭州市","provinceText": "浙江省","address": "网商路699号","phone": "0517-88990077","mobile": "15251667788","fullName": "张五","postCode": "000000","areaText": "滨江区","companyName": "测试公司","taxpayerIdentifier": "123455"}

    		tradeTypeString否由于不同的商品支持的交易方式不同，没有一种交易方式是全局通用的，所以当前下单可使用的交易方式必须通过下单预览接口的tradeModeNameList获取。交易方式类型说明：assureTrade（交易4.0通用担保交易），alipay（大市场通用的支付宝担保交易（目前在做切流，后续会下掉）），period（普通账期交易）, assure（大买家企业采购询报价下单时需要使用的担保交易流程）, creditBuy（诚E赊），bank（银行转账），631staged（631分阶段付款），37staged（37分阶段）；此字段不传则系统默认会选取一个可用的交易方式下单，如果开通了诚E赊默认是creditBuy（诚E赊），未开通诚E赊默认使用的方式是支付宝担宝交易。assureTrade

    		shopPromotionIdString否店铺优惠ID，通过“创建订单前预览数据接口”获得。为空默认使用默认优惠itemCoupon-5600812521_31032085284-398517001570

    		anonymousBuyerBoolean否是否匿名下单

    		fenxiaoChannelString否回流订单下游平台 淘宝-thyny，天猫-tm，淘特-taote，阿里巴巴C2M-c2m，京东-jingdong，拼多多-pinduoduo，微信-weixin，跨境-kuajing，快手-kuaishou，有赞-youzan，抖音-douyin，寺库-siku，美团团好货-meituan，小红书-xiaohongshu，当当-dangdang，苏宁-suning，大V店-davdian，行云-xingyun，蜜芽-miya，菠萝派商城-boluo，快团团-kuaituantuan，其他-otherdouyin

    		inventoryModeString否库存模式，JIT（jit模式）或 NORMAL（仓发模式）,目前只提供给AE使用JIT

    		outOrderIdString否外部订单号988129883123

    		pickupServiceString否上门揽收,目前AE供货可用，其他场景暂不开通.y或n,默认为nn

    		warehouseCodeString否上门揽仓库codeany

    		preSelectPayChannelString否预选的支付渠道，用作财务订单分流。订单信息查询接口返回：result.exAttributes.preSelectPayChannel ，该值是创建订单接口时传入的预选的支付渠道标记。alipay

    		smallProcurementString否是否小额采购，目前AE供货可用，取值y/n，默认为ny

    		useRedEnvelopeString否使用红包：y使用，n不使用。默认使用红包n

    		dropshippingString否是否转运订单，取值y/n，默认为ny

    		addedServiceString否增值服务 toB、toCtoB

    		crossBorderLogisticsSolutionIdString否用户选择的官方物流跨境解决方案sourceIdGLOBAL_CAINIAO_VN_TRANSIT_LAND

    		useCrossBorderLogisticsSolutionBoolean否是否使用跨境物流解决方案预览，默认为false，当海外地址时，参数不生效。当为港澳台地址时，参数生效true

    		extendParamcom.alibaba.ocean.openplatform.biz.trade.param.ExtendParam否下单扩展信息{}










    返回结果


    		名称类型描述示例值

    		resultalibaba.trade.cross.result创建订单结果{}

    		successBoolean是否成功true

    		codeString错误码400

    		messageString错误信息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 }


    相关信息
    1. 买家删除已关闭的订单
    2. 买家补充订单留言接口
    3. 买家确认收货
    4. 创建订单前预览数据接口
    5. 订单列表查看(买家视角)
    6. 取消交易
    7. 订单详情查看(买家视角)
    seo seo