Create order

POST

/taobao/purchase/order/create

Create order interface, through which Taobao orders can be automatically generated. Before calling the create order interface, please call the credential stuffing interface (use mpId for itemId and mpSkuid for skuId).

Request

Body Params application/json

appKey

string

required

大吉平台appKey

appSecret

string

required

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

thirdOrderId

string

required

商户订单号

purchase_amount

integer

required

计划购买金额 (单位分)

seller_order_number

string

required

下游订单号（可空）

order_source

string

required

买方平台名称,如：lazada

order_line_list

string

required

商品信息列表，预览商品列表，此处itemId与skuId信息，需要先调用撞库接口获得mpId与mpSkuid，itemId请填写mpId，skuId请填写mpSkuid。

receiver

object

required

收货人地址信息（填写中国仓库信息即可）

country

string

required

一级地址（国家）

state

string

required

二级地址（省、自治区、直辖市）

city

string

required

三级地址（市）

district

string

required

四级地址（县、区、县级市）

address

string

required

详细地址

zip

string

required

邮编

name

string

required

姓名

phone

string

required

电话

mobile_phone

string

required

手机号

tax_id

null

required

税号，可空

warehouse_address_info

object

required

中国仓库地址

country

string

required

一级地址（国家）

state

string

required

二级地址（省、自治区、直辖市）

city

string

required

三级地址（市）

district

string

required

四级地址（县、区、县级市）

address

string

required

详细地址

zip

string

required

邮编

name

string

required

姓名

phone

string

required

手机号

mobile_phone

string

required

电话

channel_order_type

string

required

PANAMA

support_partial_success

boolean

required

如果参数（false）或（空），创建订单逻辑为“一个子单失败，整个主单失败” 如果参数（true），创建订单逻辑为“一个子单失败，部分子单成功，主单返回成功”

order_remark

string

required

订单备注，最长50个字

need_supply_chain_service

boolean

required

false

need_sys_retry

boolean

required

false

Example

{
  "appKey": "",
  "appSecret": "",
  "thirdOrderId": "123123",
  "purchase_amount": 1,
  "seller_order_number": "DJ123",
  "order_source": "lazada",
  "order_line_list": "[{\"itemId\":2048153758314474,\"orderLineNo\":\"1\",\"quantity\":\"3\",\"price\":100,\"currency\":\"CNY\",\"title\":\"测试商品1 \",\"skuId\":3357413213162}]",
  "receiver": {
    "country": "中国",
    "state": "上海市",
    "city": "上海市",
    "district": "张江区",
    "address": "中华大街888号",
    "zip": "000000",
    "name": "张三",
    "phone": "18888888888",
    "mobile_phone": "18888888888",
    "tax_id": null
  },
  "warehouse_address_info": {
    "country": "中国",
    "state": "上海市",
    "city": "上海市",
    "district": "张江区",
    "address": "中华大街888号",
    "zip": "000000",
    "name": "张三",
    "phone": "18888888888",
    "mobile_phone": "18888888888"
  },
  "channel_order_type": "PANAMA",
  "support_partial_success": false,
  "order_remark": "测试请忽略",
  "need_supply_chain_service": false,
  "need_sys_retry": false
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.dajisaas.com/taobao/purchase/order/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appKey": "",
    "appSecret": "",
    "thirdOrderId":"123123",
    "purchase_amount": 1,
    "seller_order_number": "DJ123",
    "order_source": "lazada",
    "order_line_list": "[{\"itemId\":2048153758314474,\"orderLineNo\":\"1\",\"quantity\":\"3\",\"price\":100,\"currency\":\"CNY\",\"title\":\"\u6D4B\u8BD5\u5546\u54C11 \",\"skuId\":3357413213162}]",
    "receiver": {
        "country": "中国",
        "state": "上海市",
        "city": "上海市",
        "district": "张江区",
        "address": "中华大街888号",
        "zip": "000000",
        "name": "张三",
        "phone": "18888888888",
        "mobile_phone": "18888888888",
        "tax_id": null
    },
    "warehouse_address_info":{
        "country": "中国",
        "state": "上海市",
        "city": "上海市",
        "district": "张江区",
        "address": "中华大街888号",
        "zip": "000000",
        "name": "张三",
        "phone": "18888888888",
        "mobile_phone": "18888888888"
    },
    "channel_order_type": "PANAMA",
    "support_partial_success": false,
    "order_remark": "测试请忽略",
    "need_supply_chain_service": false,
    "need_sys_retry": false
}'

Responses

🟢200成功

application/json

Body

code

integer

required

返回码

message

string

required

返回消息

data

object

required

业务数据

success

boolean

required

成功标识

errorMessage

null

required

失败原因

errorCode

null

required

失败返回码

orderList

array [object {6}]

required

采购主订单明细

paymentUrl

string

required

支付链接

outerPurchaseId

string

required

商户订单号

timestamp

integer

required

时间戳

traceId

string

required

traceId

Example

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "success": true,
    "errorMessage": null,
    "errorCode": null,
    "orderList": [
      {
        "orderLineList": [
          {
            "itemId": "2048153758314474",
            "orderLineNo": "1",
            "quantity": 3,
            "supplierNick": null,
            "estimateAmount": 6540,
            "subPurchaseOrderId": 200049919064,
            "estimateCurrency": "CNY",
            "skuId": 3357413213162
          }
        ],
        "purchaseId": "200049919063",
        "supplierNick": null,
        "estimateAmount": 6540,
        "sourceMarket": "淘宝精选",
        "estimateCurrency": "CNY"
      }
    ],
    "paymentUrl": "https://distributor.taobao.global/apps/order/list",
    "outerPurchaseId": "1231234"
  },
  "timestamp": 1723128864292,
  "traceId": "f75dc9b5b035"
}

Preview order

Cancel order