中文版

创建订单

POST

/taobao/purchase/order/create

创建订单接口，通过该接口可自动生成淘宝订单，调用创建订单接口前，请先调用撞库接口
order_line_list字段参数说明：

productId为商品原先的id，

itemId使用撞库接口返回的mpId，

skuId使用撞库接口返回的mpSkuid。

请求参数

Body 参数application/json

appKey

string

必需

大吉平台appKey

appSecret

string

必需

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

thirdOrderId

string

商户订单号

必需

purchase_amount

integer

必需

计划购买金额 (单位分)

seller_order_number

string

下游订单号（可空）

可选

order_source

string

可选

买方电子商务平台,如：lazada

order_line_list

string

必需

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

receiver

object

必需

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

country

string

一级地址（国家）

必需

state

string

必需

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

city

string

三级地址（市）

必需

district

string

必需

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

address

string

详细地址

必需

zip

string

邮编

必需

name

string

姓名

必需

phone

string

电话

必需

mobile_phone

string

手机号

必需

tax_id

null

税号，可空

必需

warehouse_address_info

object

中国仓库地址

必需

country

string

一级地址（国家）

必需

state

string

必需

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

city

string

三级地址（市）

必需

district

string

必需

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

address

string

详细地址

必需

zip

string

邮编

必需

name

string

姓名

必需

mobile_phone

string

手机号

必需

phone

string

电话

必需

channel_order_type

string

PANAMA

可选

support_partial_success

boolean

可选

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

order_remark

string

可选

订单备注，最长50个字

need_supply_chain_service

boolean

false

可选

need_sys_retry

boolean

false

可选

示例

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

示例代码

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

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

message

string

返回消息

必需

data

object

业务数据

必需

success

boolean

成功标识

必需

errorMessage

null

失败原因

必需

errorCode

null

失败返回码

必需

orderList

array [object {6}]

采购主订单明细

必需

paymentUrl

string

支付链接

必需

outerPurchaseId

string

商户订单号

必需

timestamp

integer

时间戳

必需

traceId

string

traceId

必需

示例

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

预览商品

取消订单