English
Product Documentation1688 APITaobao/Tmall API
Product Documentation1688 APITaobao/Tmall API
中文
  1. 1688 Order Manage
  • 1688 Solution Introduction
  • 1688 Product Search
    • Image upload By Get
      GET
    • Image upload By Post
      POST
    • Image search
      GET
    • keyword search
      GET
    • Product details search
      GET
  • 1688 Order Manage
    • Preview order
      POST
    • Create order
      POST
    • Cancel order
      POST
    • View order details
      POST
    • Buyer confirms receipt
      POST
  • 1688 Oder Pay
    • Get payment links for orders in batches
      GET
    • Initiate password-free payment
      POST
  • 1688 Message Service
    • 1688 Message Service
  1. 1688 Order Manage

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.

Request

Body Params application/json
appKey
string 
required
大吉平台appKey
appSecret
string 
required
秘钥,仅调试使用,正式用sign签名
thirdOrderId
string 
required
商户订单号
flow
string 
required
general(创建大市场订单)
message
string 
required
订单备注
isvBizType
string 
required
开放平台业务码,默认为cross
addressParam
object 
required
中国收货信息
provinceText
string 
required
省份文本,比如:浙江省
cityText
string 
required
市文本,比如:杭州市
areaText
string 
required
区文本,比如:滨江区
townText
string 
required
镇文本,比如:长河镇
address
string 
required
街道地址,比如:网商路699号
postCode
string 
required
邮编
fullName
string 
required
姓名
mobile
string 
required
手机
phone
string 
required
电话
districtCode
string 
required
地址编码,比如: 310107
cargoParamList
array [object {3}] 
required
商品信息
offerId
integer 
optional
商品对应的offer id
specId
string 
optional
商品规格ID
quantity
integer 
optional
商品数量(计算金额用)
Example
{
  "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
    }
  ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
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
        }
    ]
}'

Responses

🟠405验证错误
application/json
Body
code
integer 
required
返回码
message
string 
required
消息
data
object 
required
业务数据
totalSuccessAmount
integer 
required
订单总金额(单位分),一次创建多个订单时,该字段为空
orderId
string 
required
订单ID,一次创建多个订单时,该字段为空
success
boolean 
required
是否成功
code
null 
required
返回码
message
null 
required
消息
accountPeriod
null 
required
账期信息,非账期支付订单返回空
failedOfferList
null 
required
失败商品信息
postFee
integer 
required
运费(单位分),一次创建多个订单时,该字段为空
orderList
array[string]
required
订单列表
timestamp
integer 
required
时间戳
traceId
string 
required
traceId
Example
{
  "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记录不存在
Previous
Preview order
Next
Cancel order
Built with