Taobao Order Creation

POST

/v2/taobao/order/create

请求参数

Header 参数

access-key

string

必需

默认值:

58c0201dfdf148eca63cbf6bb5e7cf03

nonce-str

string

可选

默认值:

nonce-str

timestamp

string

必需

默认值:

1715669977082

user-id

string

必需

默认值:

2100007341207

signature

string

必需

默认值:

B7F83FE2ADC8D8F044F2E01F0FFE8C80

Body 参数application/json

purchaseAmount

integer

预算金额(分)

必需

sellerOrderNumber

string

买方电商平台订单号

可选

orderSource

string

买方电子商务平台

可选

orderLineList

array[object (OrderLine) {6}]

订单行列表

必需

itemMapId

string

商品map ID

必需

orderLineNo

string

子订单号

必需

quantity

integer

数量

必需

price

integer

价格(分)

必需

currency

string

货币类型

可选

skuId

string

SKU ID

必需

receiver

object (Receiver)

买方信息

必需

zip

string

邮政编码

可选

country

string

国家

可选

address

string

地址

可选

city

string

城市

可选

phone

string

电话

可选

mobilePhone

string

手机号

可选

district

string

区/县

可选

name

string

姓名

可选

state

string

州/省

可选

remark

string

订单备注

可选

示例

{
  "orderLineList": [
    {
      "currency": "CNY",
      "itemMapId": "NeZYO6vIHuENAqbW6iWQb7dqmzNNcIX-IQGrQ53mhv0",
      "orderLineNo": "c7769346-52bc-4a44-b010-531f3bddd8e84",
      "price": 3990,
      "quantity": 1,
      "skuId": "7579055774996"
    }
  ],
  "orderSource": "pp",
  "purchaseAmount": 3990,
  "receiver": {
    "address": "xxxxxxxxxxxx",
    "city": "杭州市",
    "country": "中国",
    "district": "西湖区",
    "mobilePhone": "123456789",
    "name": "张三",
    "phone": "123456789",
    "state": "浙江省",
    "zip": "100000"
  },
  "remark": null,
  "sellerOrderNumber": "cfd3f181-7b3f-455a-92e1-c191341058b94"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/taobao/order/create' \
--header 'access-key;' \
--header 'nonce-str: nonce-str' \
--header 'timestamp;' \
--header 'user-id;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{"orderLineList":[{"currency":"CNY","itemMapId":"NeZYO6vIHuENAqbW6iWQb7dqmzNNcIX-IQGrQ53mhv0","orderLineNo":"c7769346-52bc-4a44-b010-531f3bddd8e84","price":3990,"quantity":1,"skuId":"7579055774996"}],"orderSource":"pp","purchaseAmount":3990,"receiver":{"address":"xxxxxxxxxxxx","city":"杭州市","country":"中国","district":"西湖区","mobilePhone":"123456789","name":"张三","phone":"123456789","state":"浙江省","zip":"100000"},"remark":null,"sellerOrderNumber":"cfd3f181-7b3f-455a-92e1-c191341058b94"}'

返回响应

🟢200成功

application/json

Body

requestId

string

请求ID

可选

code

integer

返回码

可选

developId

integer

开发者ID

可选

msg

string

返回码对应信息

可选

data

object (CreateOrderV2VO)

返回内容

可选

integer

订单id

可选

orderNo

string

订单编号

可选

subOrderVOS

array[object (SubOrderV2VO) {19}]

子订单

可选

createTime

string

创建时间

可选

示例

{
  "requestId": "d38cb0b2ee394420b4ff91ea54735bc2",
  "code": 200,
  "developId": "1110890638347337996",
  "msg": "成功",
  "data": {
    "id": "1232660121121718305",
    "orderNo": "1232660114964480209",
    "subOrderVOS": [
      {
        "subOrderId": "1232660121499206213",
        "orderNo": "1232660114964480209",
        "quantity": 1,
        "title": "2025新款休闲短袖衬衫男士夏季薄款韩版潮流半袖衬衣帅气寸衫上衣",
        "purchaseCurrency": "CNY",
        "purchaseAmount": "3990",
        "itemMapId": "NeZYO6vIHuENAqbW6iWQb7dqmzNNcIX-IQGrQ53mhv0",
        "domesticPostFee": 0,
        "closeReason": null,
        "skuId": "7579055774996",
        "status": "WAIT_BUYER_P",
        "goodsStatus": null,
        "refundType": null,
        "taobaoPurchaseId": "200066132047",
        "taobaoSubPurchaseId": "200066132048",
        "subOrderResult": "{\"alipay_pay_order_no\":\"2025042422001191951401076644\",\"quantity\":1,\"item_id\":\"NeZYO6vIHuENAqbW6iWQb7dqmzNNcIX-IQGrQ53mhv0\",\"purchase_currency\":\"CNY\",\"option_fields\":{\"SKU_IMG_URL\":\"https://img.alicdn.com/bao/uploaded/i1/2202282511/O1CN01f70KIV1UQ5HNQRt17_!!2202282511.jpg\",\"supplierNick\":\"淘不出掌心86\",\"serviceList\":\"[{\\\"code\\\":\\\"7d\\\",\\\"desc\\\":\\\"七天无理由退货\\\",\\\"imageUrl\\\":\\\"https://img.alicdn.com/imgextra/i4/O1CN01gk3LQL1xZoiKiMXXc_!!6000000006458-2-tps-40-40.png\\\",\\\"name\\\":\\\"七天无理由退货\\\"},{\\\"code\\\":\\\"byf\\\",\\\"desc\\\":\\\"退货宝，每个货源主单仅理赔一次\\\",\\\"imageUrl\\\":\\\"https://img.alicdn.com/imgextra/i4/O1CN01yEf3Jo1JCNoyT4cgz_!!6000000000992-2-tps-40-40.png\\\",\\\"name\\\":\\\"退货宝\\\"}]\",\"en\":\"{\\\"颜色\\\":\\\"850浅灰\\\",\\\"尺码\\\":\\\"M80-105斤\\\"}\",\"shopName\":\"小淘男装服饰\",\"shopId\":\"115037976\",\"zh\":\"{\\\"颜色\\\":\\\"850浅灰\\\",\\\"尺码\\\":\\\"M80-105斤\\\"}\"},\"sku_id\":\"7579055774996\",\"title\":\"2025新款休闲短袖衬衫男士夏季薄款韩版潮流半袖衬衣帅气寸衫上衣\",\"purchase_order_line_outer_id\":\"2541678672104451492\",\"pay_currency\":\"CNY\",\"purchase_amount\":3990,\"purchase_order_outer_id\":\"2541678672104451492\",\"domestic_post_fee\":0,\"closed\":false,\"sub_purchase_order_id\":\"200066132048\",\"itemMapId\":\"NeZYO6vIHuENAqbW6iWQb7dqmzNNcIX-IQGrQ53mhv0\",\"product_amount\":\"3990\",\"status\":\"WAIT_BUYER_P\"}",
        "errorCode": null,
        "errorMessage": null,
        "refundStatus": 0
      }
    ],
    "createTime": "2025-04-24 11:51:15"
  }
}

修改于 2025-04-25 03:53:00

Taobao image search interface

Taobao order paging query