中文版

创建订单

POST

/alibaba/trade/createCrossOrder

创建订单最多允许100个SKU，且必须为同一个供应商的商品。超过50个SKU或者一些特殊情况会一次创建多个个订单并返回多个订单号。支持大市场及分销两个场景。根据当前授权用户,区分主子账号下单

请求参数

Body 参数application/json

大吉平台appKey

appKey

string

必需

秘钥，仅调试使用，正式用sign签名

appSecret

string

必需

thirdOrderId

string

商户订单号

必需

flow

string

必需

general（创建大市场订单）

message

string

订单备注

可选

isvBizType

string

可选

开放平台业务码，默认为cross

addressParam

object

中国收货信息

必需

addressId

integer

收货地址ID

可选

fullName

string

姓名

必需

mobile

string

手机

必需

phone

string

电话

必需

postCode

string

邮编

必需

cityText

string

必需

市文本，比如：杭州市

provinceText

string

必需

省份文本，比如：浙江省

areaText

string

必需

区文本，比如：滨江区

townText

string

必需

镇文本，比如：长河镇

address

string

必需

街道地址，比如：网商路699号

districtCode

string

必需

地址编码，比如： 310107

cargoParamList

array [object {3}]

商品信息

必需

offerId

integer

可选

商品对应的offer id

specId

string

商品规格id

可选

quantity

integer

可选

商品数量(计算金额用)

示例

{
  "appKey": "",
  "appSecret": "",
  "thirdOrderId": "T20240708002",
  "flow": "general",
  "message": "备注信息测试",
  "isvBizType": "cross",
  "addressParam": {
    "provinceText": "浙江省",
    "cityText": "杭州市",
    "areaText": "滨江区",
    "townText": "长河镇",
    "address": "网商路699号",
    "postCode": "000000",
    "fullName": "张三",
    "mobile": "18888888888",
    "phone": "18888888888",
    "districtCode": "310107"
  },
  "cargoParamList": [
    {
      "offerId": 623686863670,
      "specId": "53a1eff0fa008b2b9f32a120b0a050f2",
      "quantity": 5
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.dajisaas.com/alibaba/trade/createCrossOrder' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appKey": "",
    "appSecret": "",
    "thirdOrderId": "T20240708002",
    "flow": "general",
    "message": "备注信息测试",
    "isvBizType": "cross",
    "addressParam": {
        "provinceText": "浙江省",
        "cityText": "杭州市",
        "areaText": "滨江区",
        "townText": "长河镇",
        "address": "网商路699号",
        "postCode": "000000",
        "fullName": "张三",
        "mobile": "18888888888",
        "phone": "18888888888",
        "districtCode": "310107"
    },
    "cargoParamList": [
        {
            "offerId": 623686863670,
            "specId": "53a1eff0fa008b2b9f32a120b0a050f2",
            "quantity": 5
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

message

string

消息

必需

data

object

业务数据

必需

totalSuccessAmount

integer

必需

订单总金额（单位分），一次创建多个订单时，该字段为空

orderId

string

必需

订单ID，一次创建多个订单时，该字段为空

success

boolean

是否成功

必需

code

null

返回码

必需

message

null

消息

必需

accountPeriod

null

必需

账期信息，非账期支付订单返回空

failedOfferList

null

失败商品信息

必需

postFee

integer

必需

运费（单位分），一次创建多个订单时，该字段为空

orderList

array[string]

订单列表

必需

timestamp

integer

时间戳

必需

traceId

string

traceId

必需

示例

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "totalSuccessAmount": 1196,
    "orderId": "2257164624870311973",
    "success": true,
    "code": null,
    "message": null,
    "accountPeriod": null,
    "failedOfferList": null,
    "postFee": 300,
    "orderList": []
  },
  "timestamp": 1723619438689,
  "traceId": "307c881d5e6e"
}

预览订单

取消订单