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 · 请求参数 17 个(必填 2) · 响应参数 37 个 · 限流令牌桶容量 1
Updated At
2026-11-21

头程对账列表

POST/basicOpen/logistics/headLogisticsReconciliation/list
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/logistics/headLogisticsReconciliation/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/logistics/headLogisticsReconciliation/list?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"offset\": 0,\n    \"length\": 20,\n    \"searchFieldTime\": \"shipment_time\",\n    \"searchField\": \"shipment_sn\",\n    \"searchValue\": \"SP230706004\",\n    \"shippingMethodIds\": [],\n    \"businessCodeArr\": [],\n    \"logisticsProviderId\": [],\n    \"logisticsChannelId\": [],\n    \"payStatus\": [],\n    \"sidsArr\": [],\n    \"coeffVariation\": \"\",\n    \"startDate\": \"2024-01-01\",\n    \"endDate\": \"2024-12-31\",\n    \"seniorSearchList\": []\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-05-19 12:00:00",
    "data": {
      "list": [
        {
          "refOrderNo": "SP230706004",
          "orderNo": "FL230724001",
          "logisticsProviderName": "忠迅",
          "logisticsChannelName": "测材积",
          "isNewVersion": 1,
          "businessCode": 1,
          "shipments": [
            "FBA16STCT522",
            "FBA16T004D5L"
          ],
          "fees": [
            {
              "logisticsFeeIcon": "¥",
              "taxFeeIcon": "¥",
              "feeType": 1,
              "logisticsFee": "4704.20",
              "taxFee": "0.00",
              "price": "4704.10",
              "priceCurrency": "CNY",
              "chargeableWeight": "10.00",
              "billingWay": "cbm",
              "remark": "4815",
              "priceIcon": "¥",
              "otherFeeValue": "141132.00",
              "totalFeeValue": "145836.20"
            }
          ],
          "logisticsTrackingNumberList": [
            "4827"
          ],
          "trackingNoList": [
            "123",
            "A111115815"
          ],
          "fundsDiscount": "¥0.00",
          "fundsPayableAmount": "¥23525.50",
          "fundsPaidFee": "¥0.00",
          "fundsUnpaidFee": "¥23525.50",
          "fundsApplyFee": "¥0.00",
          "fundsUnapplyFee": "¥23525.50"
        }
      ]
    },
    "total": 1
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1offset分页偏移量integer—Required分页偏移量,默认0
2length每页条数integer—Required每页条数,默认20,最大200
3searchFieldTime搜索时间类型string—Optional搜索时间类型 shipment_time:发货时间 gmt_create:发货单创建时间 delivery_date:实际妥投时间 transportation_start_time:运输开始时间
4searchField搜索字段名称string—Optional搜索字段名称 shipment_sn:关联单号 tracking_number:物流商单号 replace_tracking_number:查询单号 order_no:头程物流单单号 shipment_id:货件单号
5searchValue搜索字段值string—Optional搜索字段值
6shippingMethodIds运输方式array<any>—Optional运输方式
7businessCodeArr单据类型array<any>—Optional单据类型 1:发货单 2:备货单
8logisticsProviderId物流商array<any>—Optional物流商
9logisticsChannelId物流渠道array<any>—Optional物流渠道
10payStatus付款状态array<any>—Optional付款状态 0:未申请 1:已申请 2:部分付款 3:已付清 4:无
11sidsArr店铺array<any>—Optional店铺
12coeffVariation差异系数string—Optional差异系数
13startDate开始日期string—Optional开始日期
14endDate结束日期string—Optional结束日期
15seniorSearchList批量搜索array<object>—Optional批量搜索
15.1searchField批量搜索字段string—Optional批量搜索字段
15.2searchValue批量搜索值array<any>—Optional批量搜索值

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0:成功
2message消息提示stringsuccessRequired消息提示
3error_details数据校验失败时的错误详情array<any>—Required数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583Required请求链路id
5response_time响应时间string2026-05-19 12:00:00Required响应时间
6data响应数据object—Required响应数据
6.1listlistobject—Optional
6.1.1refOrderNo关联单号stringSP230706004Required关联单号
6.1.2orderNo头程物流单单号stringFL230724001Required头程物流单单号
6.1.3logisticsProviderName物流商string忠迅Required物流商
6.1.4logisticsChannelName物流渠道string测材积Required物流渠道
6.1.5isNewVersion是否新版费用integer1Required是否新版费用,0:否,1:是
6.1.6businessCode单据类型integer1Required单据类型,1:发货单,2:备货单
6.1.7shipments货件号array<any>["FBA16STCT522"]Required货件号
6.1.8fees费用列表array<object>—Required费用列表
6.1.8.1logisticsFeeIcon物流费用币种string¥Required物流费用币种
6.1.8.2taxFeeIcon税费币种string¥Required税费币种
6.1.8.3feeType费用类型integer1Required费用类型,1:预估,2:实际,3:差异
6.1.8.4logisticsFee物流费用string4704.20Required物流费用
6.1.8.5taxFee税费string0.00Required税费
6.1.8.6price单价string4704.10Required单价
6.1.8.7priceCurrency单价币种stringCNYRequired单价币种
6.1.8.8chargeableWeight计费重string10.00Required计费重
6.1.8.9billingWay计费方式stringcbmRequired计费方式
6.1.8.10remark备注string4815Required备注
6.1.8.11priceIcon单价币种string¥Required单价币种
6.1.8.12otherFeeValue总其他费用string141132.00Required总其他费用
6.1.8.13totalFeeValue总物流费用string145836.20Required总物流费用
6.1.9logisticsTrackingNumberList物流商单号列表(旧版物流可能多个物流商单号)array<any>["4827"]Required物流商单号列表(旧版物流可能多个物流商单号)
6.1.10trackingNoList查询单号列表array<any>["123","A111115815"]Required查询单号列表
6.1.11fundsDiscount折扣金额string¥0.00Required折扣金额
6.1.12fundsPayableAmount应付金额string¥23525.50Required应付金额
6.1.13fundsPaidFee已付金额string¥0.00Required已付金额
6.1.14fundsUnpaidFee未付金额string¥23525.50Required未付金额
6.1.15fundsApplyFee申请中string¥0.00Required申请中
6.1.16fundsUnapplyFee未申请string¥23525.50Required未申请
7total总数integer1Required总数

The 头程对账列表 API (/basicOpen/logistics/headLogisticsReconciliation/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.