Qeasy Cloud
Get Started

领星ERP 获取追踪记录列表 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
销售 / 物流追踪看板 · POST · 请求参数 19 个(必填 1) · 响应参数 36 个 · 限流令牌桶容量 1
Updated At
2026-11-21

获取追踪记录列表

POST/basicOpen/logistics/trackRecord/list
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/logistics/trackRecord/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/logistics/trackRecord/list?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"search\": {\n        \"length\": 20,\n        \"page\": 1,\n        \"dateField\": \"shipped_at\",\n        \"startTime\": \"1746057600\",\n        \"endTime\": \"1748736000\",\n        \"receiveCountryCodes\": [\"US\"],\n        \"platformCodes\": [\"10001\"],\n        \"siteCodes\": [\"10011-US\"],\n        \"storeIds\": [\"1234567890\"],\n        \"logisticsProviderIds\": [\"1001\"],\n        \"logisticsTypeIds\": [\"1001\"],\n        \"searchField\": \"query_no\",\n        \"searchValue\": \"9400111899223856928499\",\n        \"seniorSearchList\": [\n            {\n                \"searchField\": \"query_no\",\n                \"searchValue\": [\"9400111899223856928499\"]\n            }\n        ],\n        \"sortField\": \"shipped_at\",\n        \"sortType\": \"desc\"\n    }\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-08-23 09:20:00",
    "total": 1,
    "data": {
      "records": [
        {
          "recordId": 10001,
          "orderNo": "LX202505300001",
          "orderType": "order",
          "queryNo": "9400111899223856928499",
          "logisticsProviderId": 1001,
          "logisticsProviderName": "USPS",
          "status": 1,
          "statusName": "运输中",
          "deliveredDays": 5,
          "stayedDays": 1,
          "lastStayedAt": 1748563200,
          "lastStayedDescription": "Arrived at USPS Regional Facility",
          "shippedAt": 1748217600,
          "purchasedAt": 1748044800,
          "sendCountryCode": "CN",
          "receiveCountryCode": "US",
          "trackSupplierCode": 1001,
          "trackSupplierCarrierName": "USPS",
          "trackSupplierCarrierCode": "USPS",
          "storeId": 1234567890,
          "storeName": "Amazon US Store",
          "siteCode": "US",
          "siteName": "美国",
          "platformCode": "amazon",
          "buyerName": "John Smith",
          "platformName": "Amazon",
          "deliveredTime": "2025-09-07 20:28:01"
        }
      ],
      "total": 1
    }
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1search查询条件object—Required查询条件
1.1length分页长度integer—Optional分页长度,默认20,最大200
1.2page页码integer—Optional页码,默认1
1.3dateField日期筛选类型string—Optional日期筛选类型 shipped_at:发货时间 purchased_at:订购时间
1.4endTime结束时间string—Optional结束时间,10位数字字符串形式的秒级时间戳
1.5startTime开始时间string—Optional开始时间,10位数字字符串形式的秒级时间戳
1.6receiveCountryCodes收件国家二字码(目的地)array<any>—Optional收件国家二字码(目的地)
1.7platformCodes平台列表array<any>—Optional平台列表,传平台编码
1.8siteCodes站点列表array<any>—Optional站点列表,格式为平台编码-站点编码 来源:查询订单管理订单列表 返回的 data>>list>>site_code
1.9storeIds店铺列表array<any>—Optional店铺列表
1.10logisticsProviderIds物流商列表array<any>—Optional物流商列表
1.11logisticsTypeIds物流方式列表array<any>—Optional物流方式列表
1.12searchValue查询单号string—Optional查询单号
1.13searchField查询单号字段string—Optional查询单号字段 platform_no:平台单号 order_no:系统单号 query_no:查询追踪号
1.14seniorSearchList批量查询列表array<object>—Optional批量查询列表
1.14.1searchField查询单号字段string—Optional查询单号字段 platform_no:平台单号 order_no:系统单号 query_no:查询追踪号
1.14.2searchValue查询单号列表array<any>—Optional查询单号列表
1.15sortField排序字段string—Optional排序字段 purchased_at:订购时间 shipped_at:发货时间 receipt_time:上网时间 delivered_time:妥投时间
1.16sortType排序方式string—Optional排序方式 desc:降序 asc:升序

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0:成功
2message消息提示stringsuccessRequired消息提示
3error_details数据校验失败时的错误详情array<any>—Required数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583Required请求链路id
5response_time响应时间string2026-08-23 09:20:00Required响应时间
6total总数integer1Required总数
7data响应数据object—Required响应数据
7.1records追踪记录列表array<object>—Required追踪记录列表
7.1.1recordId追踪记录IDinteger10001Required追踪记录ID
7.1.2orderNo源单号(系统单号)stringLX202505300001Required源单号(系统单号)
7.1.3orderType源单类型stringorderRequired源单类型
7.1.4queryNo查询单号(查询追踪号)string9400111899223856928499Required查询单号(查询追踪号)
7.1.5logisticsProviderId物流商编号integer1001Required物流商编号
7.1.6logisticsProviderName物流商名stringUSPSRequired物流商名
7.1.7status物流状态integer1Required物流状态
7.1.8statusName物流状态名称string运输中Required物流状态名称
7.1.9deliveredDays运输天数integer5Required运输天数
7.1.10stayedDays停留天数integer1Required停留天数
7.1.11lastStayedAt最后停留时间戳(最新信息)integer1748563200Required最后停留时间戳(最新信息)
7.1.12lastStayedDescription最后停留状况描述(最新信息)stringArrived at USPS Regional FacilityRequired最后停留状况描述(最新信息)
7.1.13shippedAt发货时间戳integer1748217600Required发货时间戳
7.1.14purchasedAt订购时间戳integer1748044800Required订购时间戳
7.1.15sendCountryCode发件国家二字码stringCNRequired发件国家二字码
7.1.16receiveCountryCode收件国家二字码stringUSRequired收件国家二字码
7.1.17trackSupplierCode追踪服务商codeinteger1001Required追踪服务商code
7.1.18trackSupplierCarrierName查询承运商名称stringUSPSRequired查询承运商名称
7.1.19trackSupplierCarrierCode查询承运商codestringUSPSRequired查询承运商code
7.1.20storeId店铺IDinteger1234567890Required店铺ID
7.1.21storeName店铺名stringAmazon US StoreRequired店铺名
7.1.22siteCode站点codestringUSRequired站点code
7.1.23siteName站点名string美国Required站点名
7.1.24platformCode平台codestringamazonRequired平台code
7.1.25buyerName买家姓名stringJohn SmithRequired买家姓名
7.1.26platformName平台名称stringAmazonRequired平台名称
7.1.27deliveredTime妥投时间string2025-09-07 20:28:01Optional妥投时间,格式:yyyy-MM-dd HH:mm:ss
7.2total总数integer1Required总数

The 获取追踪记录列表 API (/basicOpen/logistics/trackRecord/list) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.