Create order

POST

/alibaba/trade/createCrossOrder

A maximum of 100 SKUs are allowed when creating an order, and they must be products from the same supplier. If there are more than 50 SKUs or some special circumstances, multiple orders will be created at one time and multiple order numbers will be returned. Supports both large market and distribution scenarios. According to the current authorized user, distinguish the main and sub-accounts to place orders.

请求参数

Body 参数application/json

appKey

string

必需

大吉平台appKey

appSecret

string

必需

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

thirdOrderId

string

商户订单号

必需

flow

string

必需

general（创建大市场订单）

message

string

订单备注

必需

isvBizType

string

必需

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

addressParam

object

中国收货信息

必需

provinceText

string

必需

省份文本，比如：浙江省

cityText

string

必需

市文本，比如：杭州市

areaText

string

必需

区文本，比如：滨江区

townText

string

必需

镇文本，比如：长河镇

address

string

必需

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

postCode

string

邮编

必需

fullName

string

姓名

必需

mobile

string

手机

必需

phone

string

电话

必需

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
        }
    ]
}'

返回响应

🟠405验证错误

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"
}

🟢200成功

🟠404记录不存在

修改于 2024-08-15 08:13:30

Preview order

Cancel order