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