查询订单 - 中文版

查询订单接口，可通过该接口查询淘宝订单详情。

请求参数

Body 参数application/json

appKey

string

必需

大吉平台appKey

appSecret

string

必需

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

thirdOrderId

string

商户订单号

可选

purchase_ids

array[string]

采购主单id列表

可选

status

string

可选

订单状态 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

可选

排序类型递增（ASC）、递减（DESC）

page_no

string

当前页码

可选

sort_field

string

可选

排序字段（该字段已失效）默认使用modify_time

page_size

string

每页展示数量

可选

modify_time_start

integer

可选

开始范围，订单修改时间，1609225202000

modify_time_end

integer

可选

结束范围，订单修改时间，1609308425000

示例

{
  "appKey": "",
  "appSecret": "",
  "thirdOrderId": "D0001",
  "purchase_ids": [],
  "status": "",
  "sort_type": "",
  "page_no": "",
  "sort_field": "",
  "page_size": "",
  "modify_time_start": 1609225202000,
  "modify_time_end": 1609308425000
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

message

string

消息

必需

data

object

业务数据

必需

resultsTotal

integer

总条数

必需

pageNo

integer

当前页码

必需

pageSize

integer

每页数量

必需

purchaseOrders

array [object {15}]

采购主单列表明细

必需

timestamp

integer

时间戳

必需

traceId

string

traceId

必需

示例

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