English
Product Documentation1688 APITaobao/Tmall API
Product Documentation1688 APITaobao/Tmall API
中文
  1. Taobao / Tmall Order Manage
  • Taobao / Tmall Product Search
    • Image upload By Get
      GET
    • Image upload By Post
      POST
    • Image search
      GET
    • keyword search
      GET
    • shop search
      GET
    • Product details search
      GET
    • Product Logistics Price Get
      GET
    • Hot list type search
      GET
    • List product search
      GET
    • Product Logistics Price Post
      POST
    • Image search2
      GET
  • Taobao / Tmall Order Manage
    • Product Bunker interface(撞库)
      GET
    • Preview order
      POST
    • Create order
      POST
    • Cancel order
      POST
    • View order details
      POST
  • Taobao / Tmall Order Pay
    • Pay order
      POST
  • Taobao / Tmall Message
    • Message Type
  1. Taobao / Tmall Order Manage

View order details

POST
/taobao/purchase/order/query
Query order interface, you can query Taobao order details through this interface.

Request

Body Params application/json
appKey
string 
required
大吉平台appKey
appSecret
string 
required
秘钥,仅调试使用,正式用sign签名
thirdOrderId
string 
optional
商户订单号
purchase_ids
array[string]
optional
采购主单id列表
status
string 
optional
订单状态 BULIDING("BULIDING", "采购单创建中"), WAIT_BUYER_P("WAIT_BUYER_P", "等待付款"), WAIT_SELLER_SEND_GOODS("WAIT_SELLER_SEND_GOODS", "已付款,待发货"), WAIT_BUYER_CONFIRM_GOODS("WAIT_BUYER_CONFIRM_GOODS", "已付款,已发货"), TRADE_CLOSED("TRADE_CLOSED", "交易关闭"); 注意:“已发货”是最终状态。订单已发货后,自动超时确认收货
sort_type
string 
optional
排序类型 递增(ASC)、递减(DESC)
page_no
string 
optional
当前页码
sort_field
string 
optional
排序字段(该字段已失效)默认使用modify_time
page_size
string 
optional
每页展示数量
modify_time_start
integer 
optional
开始范围,订单修改时间,1609225202000
modify_time_end
integer 
optional
结束范围,订单修改时间,1609308425000
Example
{
  "appKey": "",
  "appSecret": "",
  "thirdOrderId": "D0001",
  "purchase_ids": [],
  "status": "",
  "sort_type": "",
  "page_no": "",
  "sort_field": "",
  "page_size": "",
  "modify_time_start": 1609225202000,
  "modify_time_end": 1609308425000
}

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/taobao/purchase/order/query' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appKey": "",
    "appSecret": "",
    "thirdOrderId": "D0001",
    "purchase_ids": [],
    "status": "",
    "sort_type": "",
    "page_no": "",
    "sort_field": "",
    "page_size": "",
    "modify_time_start": 1609225202000,
    "modify_time_end": 1609308425000
}'

Responses

🟢200成功
application/json
Body
code
integer 
required
返回码
message
string 
required
消息
data
object 
required
业务数据
resultsTotal
integer 
required
总条数
pageNo
integer 
required
当前页码
pageSize
integer 
required
每页数量
purchaseOrders
array [object {15}] 
required
采购主单列表明细
timestamp
integer 
required
时间戳
traceId
string 
required
traceId
Example
{
  "code": 200,
  "message": "操作成功",
  "data": {
    "resultsTotal": 1,
    "pageNo": 1,
    "pageSize": 10,
    "purchaseOrders": [
      {
        "receiver": {
          "country": "中国",
          "address": "中华大街 8栋4楼 大洋路99号 张三 18888888888",
          "city": "上海市",
          "district": "浦东新区",
          "state": "上海市"
        },
        "payTime": 1684221253000,
        "purchaseId": 200014688433,
        "sourceMarket": "TAOBAO",
        "purchaseCurrency": "CNY",
        "outerPurchaseId": "2313919804735488",
        "purchaseAmount": 8950,
        "modifyTime": 1685523462000,
        "payAmount": 8950,
        "supplierNick": "tigig7",
        "domesticPostFee": 0,
        "createdTime": 1684221169000,
        "payCurrency": "CNY",
        "subPurchaseOrders": [
          {
            "logisticNumber": "YT7237013144176",
            "logisticCompanyName": "圆通速递",
            "quantity": 3,
            "payTime": 1684221253000,
            "optionFields": {
              "supplierNick": "tigig7",
              "en": "{\"Color classification\":\"Love Owl Weaving\"}",
              "zh": "{\"颜色分类\":\"【爱心猫头鹰】织布\"}"
            },
            "rtsTime": 1684227461000,
            "title": "手提包包女袋子女包中年上班妈咪包编织民族风手机小布包时尚简约",
            "purchaseCurrency": "CNY",
            "purchaseOrderLineOuterId": "3349399071247974559",
            "purchaseAmount": 2940,
            "itemId": "2048014792109129",
            "productAmount": 2940,
            "payAmount": 2953,
            "logisticOrders": [
              {
                "logisticCompanyName": "圆通速递",
                "logisticNumber": "YT7237013144176",
                "rtsTime": 1684227461000
              }
            ],
            "domesticPostFee": 0,
            "purchaseOrderOuterId": "3349399071246974559",
            "payCurrency": "CNY",
            "subPurchaseOrderId": 200014688434,
            "skuInfo": {
              "skuPv": {
                "en": "{\"Color classification\":\"Love Owl Weaving\"}",
                "zh": "{\"颜色分类\":\"【爱心猫头鹰】织布\"}"
              }
            },
            "skuId": 306022244425,
            "status": "WAIT_BUYER_CONFIRM_GOODS"
          },
          {
            "logisticNumber": "YT7237013144176",
            "logisticCompanyName": "圆通速递",
            "quantity": 3,
            "payTime": 1684221253000,
            "optionFields": {
              "supplierNick": "tigig7",
              "en": "{\"Color classification\":\"[Couple cat] Weaving\"}",
              "zh": "{\"颜色分类\":\"【情侣猫咪】织布\"}"
            },
            "rtsTime": 1684227461000,
            "title": "手提包包女袋子女包中年上班妈咪包编织民族风手机小布包时尚简约",
            "purchaseCurrency": "CNY",
            "purchaseOrderLineOuterId": "3349399071248974559",
            "purchaseAmount": 2940,
            "itemId": "2048014792109129",
            "productAmount": 2940,
            "payAmount": 2953,
            "logisticOrders": [
              {
                "logisticCompanyName": "圆通速递",
                "logisticNumber": "YT7237013144176",
                "rtsTime": 1684227461000
              }
            ],
            "domesticPostFee": 0,
            "purchaseOrderOuterId": "3349399071246974559",
            "payCurrency": "CNY",
            "subPurchaseOrderId": 200014688435,
            "skuInfo": {
              "skuPv": {
                "en": "{\"Color classification\":\"[Couple cat] Weaving\"}",
                "zh": "{\"颜色分类\":\"【情侣猫咪】织布\"}"
              }
            },
            "skuId": 306022234185,
            "status": "WAIT_BUYER_CONFIRM_GOODS"
          },
          {
            "logisticNumber": "YT7237013144176",
            "logisticCompanyName": "圆通速递",
            "quantity": 1,
            "payTime": 1684221253000,
            "optionFields": {
              "supplierNick": "tigig7",
              "en": "{\"Color classification\":\"[Large] ethnic embroidery + Yellow Elephant\"}",
              "zh": "{\"颜色分类\":\"【大号】民族风绣花+黄底大象\"}"
            },
            "rtsTime": 1684227461000,
            "title": "单肩包包女民族风帆布包新款卡通质感耐用高级绣花手提小方包女包",
            "purchaseCurrency": "CNY",
            "purchaseOrderLineOuterId": "3349399071249974559",
            "purchaseAmount": 1110,
            "itemId": "2048000629069064",
            "productAmount": 1110,
            "payAmount": 1074,
            "logisticOrders": [
              {
                "logisticCompanyName": "圆通速递",
                "logisticNumber": "YT7237013144176",
                "rtsTime": 1684227461000
              }
            ],
            "domesticPostFee": 0,
            "purchaseOrderOuterId": "3349399071246974559",
            "payCurrency": "CNY",
            "subPurchaseOrderId": 200014688436,
            "skuInfo": {
              "skuPv": {
                "en": "{\"Color classification\":\"[Large] ethnic embroidery + Yellow Elephant\"}",
                "zh": "{\"颜色分类\":\"【大号】民族风绣花+黄底大象\"}"
              }
            },
            "skuId": 5546183944,
            "status": "WAIT_BUYER_CONFIRM_GOODS"
          },
          {
            "logisticNumber": "YT7237013144176",
            "logisticCompanyName": "圆通速递",
            "quantity": 1,
            "payTime": 1684221253000,
            "optionFields": {
              "supplierNick": "tigig7",
              "en": "{\"Color classification\":\"[Beige umbrella elephant] Weaving\"}",
              "zh": "{\"颜色分类\":\"【米色雨伞大象】织布\"}"
            },
            "rtsTime": 1684227461000,
            "title": "手提包包女袋子女包中年上班妈咪包编织民族风手机小布包时尚简约",
            "purchaseCurrency": "CNY",
            "purchaseOrderLineOuterId": "3349399071250974559",
            "purchaseAmount": 980,
            "itemId": "2048014792109129",
            "productAmount": 980,
            "payAmount": 984,
            "logisticOrders": [
              {
                "logisticCompanyName": "圆通速递",
                "logisticNumber": "YT7237013144176",
                "rtsTime": 1684227461000
              }
            ],
            "domesticPostFee": 0,
            "purchaseOrderOuterId": "3349399071246974559",
            "payCurrency": "CNY",
            "subPurchaseOrderId": 200014688437,
            "skuInfo": {
              "skuPv": {
                "en": "{\"Color classification\":\"[Beige umbrella elephant] Weaving\"}",
                "zh": "{\"颜色分类\":\"【米色雨伞大象】织布\"}"
              }
            },
            "skuId": 306022239305,
            "status": "WAIT_BUYER_CONFIRM_GOODS"
          },
          {
            "logisticNumber": "YT7237013144176",
            "logisticCompanyName": "圆通速递",
            "quantity": 1,
            "payTime": 1684221253000,
            "optionFields": {
              "supplierNick": "tigig7",
              "en": "{\"Color classification\":\"[Couple Owl] Weaving\"}",
              "zh": "{\"颜色分类\":\"【情侣猫头鹰】织布\"}"
            },
            "rtsTime": 1684227461000,
            "title": "手提包包女袋子女包中年上班妈咪包编织民族风手机小布包时尚简约",
            "purchaseCurrency": "CNY",
            "purchaseOrderLineOuterId": "3349399071251974559",
            "purchaseAmount": 980,
            "itemId": "2048014792109129",
            "productAmount": 980,
            "payAmount": 986,
            "logisticOrders": [
              {
                "logisticCompanyName": "圆通速递",
                "logisticNumber": "YT7237013144176",
                "rtsTime": 1684227461000
              }
            ],
            "domesticPostFee": 0,
            "purchaseOrderOuterId": "3349399071246974559",
            "payCurrency": "CNY",
            "subPurchaseOrderId": 200014688438,
            "skuInfo": {
              "skuPv": {
                "en": "{\"Color classification\":\"[Couple Owl] Weaving\"}",
                "zh": "{\"颜色分类\":\"【情侣猫头鹰】织布\"}"
              }
            },
            "skuId": 306022243401,
            "status": "WAIT_BUYER_CONFIRM_GOODS"
          }
        ],
        "status": "WAIT_BUYER_CONFIRM_GOODS"
      }
    ]
  },
  "timestamp": 1723716875010,
  "traceId": "185a1c81176e"
}
Previous
Cancel order
Next
Pay order
Built with