/basicOpen/logistics/trackRecord/list{
"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×tamp=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
}
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | search | 查询条件 | object | — | Required | 查询条件 |
| 1.1 | length | 分页长度 | integer | — | Optional | 分页长度,默认20,最大200 |
| 1.2 | page | 页码 | integer | — | Optional | 页码,默认1 |
| 1.3 | dateField | 日期筛选类型 | string | — | Optional | 日期筛选类型 shipped_at:发货时间 purchased_at:订购时间 |
| 1.4 | endTime | 结束时间 | string | — | Optional | 结束时间,10位数字字符串形式的秒级时间戳 |
| 1.5 | startTime | 开始时间 | string | — | Optional | 开始时间,10位数字字符串形式的秒级时间戳 |
| 1.6 | receiveCountryCodes | 收件国家二字码(目的地) | array<any> | — | Optional | 收件国家二字码(目的地) |
| 1.7 | platformCodes | 平台列表 | array<any> | — | Optional | 平台列表,传平台编码 |
| 1.8 | siteCodes | 站点列表 | array<any> | — | Optional | 站点列表,格式为平台编码-站点编码 来源:查询订单管理订单列表 返回的 data>>list>>site_code |
| 1.9 | storeIds | 店铺列表 | array<any> | — | Optional | 店铺列表 |
| 1.10 | logisticsProviderIds | 物流商列表 | array<any> | — | Optional | 物流商列表 |
| 1.11 | logisticsTypeIds | 物流方式列表 | array<any> | — | Optional | 物流方式列表 |
| 1.12 | searchValue | 查询单号 | string | — | Optional | 查询单号 |
| 1.13 | searchField | 查询单号字段 | string | — | Optional | 查询单号字段 platform_no:平台单号 order_no:系统单号 query_no:查询追踪号 |
| 1.14 | seniorSearchList | 批量查询列表 | array<object> | — | Optional | 批量查询列表 |
| 1.14.1 | searchField | 查询单号字段 | string | — | Optional | 查询单号字段 platform_no:平台单号 order_no:系统单号 query_no:查询追踪号 |
| 1.14.2 | searchValue | 查询单号列表 | array<any> | — | Optional | 查询单号列表 |
| 1.15 | sortField | 排序字段 | string | — | Optional | 排序字段 purchased_at:订购时间 shipped_at:发货时间 receipt_time:上网时间 delivered_time:妥投时间 |
| 1.16 | sortType | 排序方式 | string | — | Optional | 排序方式 desc:降序 asc:升序 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | Required | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-08-23 09:20:00 | Required | 响应时间 |
| 6 | total | 总数 | integer | 1 | Required | 总数 |
| 7 | data | 响应数据 | object | — | Required | 响应数据 |
| 7.1 | records | 追踪记录列表 | array<object> | — | Required | 追踪记录列表 |
| 7.1.1 | recordId | 追踪记录ID | integer | 10001 | Required | 追踪记录ID |
| 7.1.2 | orderNo | 源单号(系统单号) | string | LX202505300001 | Required | 源单号(系统单号) |
| 7.1.3 | orderType | 源单类型 | string | order | Required | 源单类型 |
| 7.1.4 | queryNo | 查询单号(查询追踪号) | string | 9400111899223856928499 | Required | 查询单号(查询追踪号) |
| 7.1.5 | logisticsProviderId | 物流商编号 | integer | 1001 | Required | 物流商编号 |
| 7.1.6 | logisticsProviderName | 物流商名 | string | USPS | Required | 物流商名 |
| 7.1.7 | status | 物流状态 | integer | 1 | Required | 物流状态 |
| 7.1.8 | statusName | 物流状态名称 | string | 运输中 | Required | 物流状态名称 |
| 7.1.9 | deliveredDays | 运输天数 | integer | 5 | Required | 运输天数 |
| 7.1.10 | stayedDays | 停留天数 | integer | 1 | Required | 停留天数 |
| 7.1.11 | lastStayedAt | 最后停留时间戳(最新信息) | integer | 1748563200 | Required | 最后停留时间戳(最新信息) |
| 7.1.12 | lastStayedDescription | 最后停留状况描述(最新信息) | string | Arrived at USPS Regional Facility | Required | 最后停留状况描述(最新信息) |
| 7.1.13 | shippedAt | 发货时间戳 | integer | 1748217600 | Required | 发货时间戳 |
| 7.1.14 | purchasedAt | 订购时间戳 | integer | 1748044800 | Required | 订购时间戳 |
| 7.1.15 | sendCountryCode | 发件国家二字码 | string | CN | Required | 发件国家二字码 |
| 7.1.16 | receiveCountryCode | 收件国家二字码 | string | US | Required | 收件国家二字码 |
| 7.1.17 | trackSupplierCode | 追踪服务商code | integer | 1001 | Required | 追踪服务商code |
| 7.1.18 | trackSupplierCarrierName | 查询承运商名称 | string | USPS | Required | 查询承运商名称 |
| 7.1.19 | trackSupplierCarrierCode | 查询承运商code | string | USPS | Required | 查询承运商code |
| 7.1.20 | storeId | 店铺ID | integer | 1234567890 | Required | 店铺ID |
| 7.1.21 | storeName | 店铺名 | string | Amazon US Store | Required | 店铺名 |
| 7.1.22 | siteCode | 站点code | string | US | Required | 站点code |
| 7.1.23 | siteName | 站点名 | string | 美国 | Required | 站点名 |
| 7.1.24 | platformCode | 平台code | string | amazon | Required | 平台code |
| 7.1.25 | buyerName | 买家姓名 | string | John Smith | Required | 买家姓名 |
| 7.1.26 | platformName | 平台名称 | string | Amazon | Required | 平台名称 |
| 7.1.27 | deliveredTime | 妥投时间 | string | 2025-09-07 20:28:01 | Optional | 妥投时间,格式:yyyy-MM-dd HH:mm:ss |
| 7.2 | total | 总数 | integer | 1 | Required | 总数 |
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.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.