轻易云
注册体验

领星ERP获取追踪记录列表接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
销售 / 物流追踪看板 · POST · 请求参数 19 个(必填 1) · 响应参数 36 个 · 限流令牌桶容量 1
更新日期
2026-11-21

获取追踪记录列表

POST/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&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
    }
  }
}

接口请求参数

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

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array<any>—必填数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583必填请求链路id
5response_time响应时间string2026-08-23 09:20:00必填响应时间
6total总数integer1必填总数
7data响应数据object—必填响应数据
7.1records追踪记录列表array<object>—必填追踪记录列表
7.1.1recordId追踪记录IDinteger10001必填追踪记录ID
7.1.2orderNo源单号(系统单号)stringLX202505300001必填源单号(系统单号)
7.1.3orderType源单类型stringorder必填源单类型
7.1.4queryNo查询单号(查询追踪号)string9400111899223856928499必填查询单号(查询追踪号)
7.1.5logisticsProviderId物流商编号integer1001必填物流商编号
7.1.6logisticsProviderName物流商名stringUSPS必填物流商名
7.1.7status物流状态integer1必填物流状态
7.1.8statusName物流状态名称string运输中必填物流状态名称
7.1.9deliveredDays运输天数integer5必填运输天数
7.1.10stayedDays停留天数integer1必填停留天数
7.1.11lastStayedAt最后停留时间戳(最新信息)integer1748563200必填最后停留时间戳(最新信息)
7.1.12lastStayedDescription最后停留状况描述(最新信息)stringArrived at USPS Regional Facility必填最后停留状况描述(最新信息)
7.1.13shippedAt发货时间戳integer1748217600必填发货时间戳
7.1.14purchasedAt订购时间戳integer1748044800必填订购时间戳
7.1.15sendCountryCode发件国家二字码stringCN必填发件国家二字码
7.1.16receiveCountryCode收件国家二字码stringUS必填收件国家二字码
7.1.17trackSupplierCode追踪服务商codeinteger1001必填追踪服务商code
7.1.18trackSupplierCarrierName查询承运商名称stringUSPS必填查询承运商名称
7.1.19trackSupplierCarrierCode查询承运商codestringUSPS必填查询承运商code
7.1.20storeId店铺IDinteger1234567890必填店铺ID
7.1.21storeName店铺名stringAmazon US Store必填店铺名
7.1.22siteCode站点codestringUS必填站点code
7.1.23siteName站点名string美国必填站点名
7.1.24platformCode平台codestringamazon必填平台code
7.1.25buyerName买家姓名stringJohn Smith必填买家姓名
7.1.26platformName平台名称stringAmazon必填平台名称
7.1.27deliveredTime妥投时间string2025-09-07 20:28:01可选妥投时间,格式:yyyy-MM-dd HH:mm:ss
7.2total总数integer1必填总数

领星ERP的接口:获取追踪记录列表(/basicOpen/logistics/trackRecord/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。