轻易云
注册体验

领星ERP头程对账列表接口

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

头程对账列表

POST/basicOpen/logistics/headLogisticsReconciliation/list
加工厂
{
  "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
  }
}

接口请求参数

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

接口响应参数

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

领星ERP的接口:头程对账列表(/basicOpen/logistics/headLogisticsReconciliation/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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