/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×tamp=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
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | offset | 分页偏移量 | integer | — | Required | 分页偏移量,默认0 |
| 2 | length | 每页条数 | integer | — | Required | 每页条数,默认20,最大200 |
| 3 | searchFieldTime | 搜索时间类型 | string | — | Optional | 搜索时间类型 shipment_time:发货时间 gmt_create:发货单创建时间 delivery_date:实际妥投时间 transportation_start_time:运输开始时间 |
| 4 | searchField | 搜索字段名称 | string | — | Optional | 搜索字段名称 shipment_sn:关联单号 tracking_number:物流商单号 replace_tracking_number:查询单号 order_no:头程物流单单号 shipment_id:货件单号 |
| 5 | searchValue | 搜索字段值 | string | — | Optional | 搜索字段值 |
| 6 | shippingMethodIds | 运输方式 | array<any> | — | Optional | 运输方式 |
| 7 | businessCodeArr | 单据类型 | array<any> | — | Optional | 单据类型 1:发货单 2:备货单 |
| 8 | logisticsProviderId | 物流商 | array<any> | — | Optional | 物流商 |
| 9 | logisticsChannelId | 物流渠道 | array<any> | — | Optional | 物流渠道 |
| 10 | payStatus | 付款状态 | array<any> | — | Optional | 付款状态 0:未申请 1:已申请 2:部分付款 3:已付清 4:无 |
| 11 | sidsArr | 店铺 | array<any> | — | Optional | 店铺 |
| 12 | coeffVariation | 差异系数 | string | — | Optional | 差异系数 |
| 13 | startDate | 开始日期 | string | — | Optional | 开始日期 |
| 14 | endDate | 结束日期 | string | — | Optional | 结束日期 |
| 15 | seniorSearchList | 批量搜索 | array<object> | — | Optional | 批量搜索 |
| 15.1 | searchField | 批量搜索字段 | string | — | Optional | 批量搜索字段 |
| 15.2 | searchValue | 批量搜索值 | array<any> | — | Optional | 批量搜索值 |
| 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-05-19 12:00:00 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | list | list | object | — | Optional | |
| 6.1.1 | refOrderNo | 关联单号 | string | SP230706004 | Required | 关联单号 |
| 6.1.2 | orderNo | 头程物流单单号 | string | FL230724001 | Required | 头程物流单单号 |
| 6.1.3 | logisticsProviderName | 物流商 | string | 忠迅 | Required | 物流商 |
| 6.1.4 | logisticsChannelName | 物流渠道 | string | 测材积 | Required | 物流渠道 |
| 6.1.5 | isNewVersion | 是否新版费用 | integer | 1 | Required | 是否新版费用,0:否,1:是 |
| 6.1.6 | businessCode | 单据类型 | integer | 1 | Required | 单据类型,1:发货单,2:备货单 |
| 6.1.7 | shipments | 货件号 | array<any> | ["FBA16STCT522"] | Required | 货件号 |
| 6.1.8 | fees | 费用列表 | array<object> | — | Required | 费用列表 |
| 6.1.8.1 | logisticsFeeIcon | 物流费用币种 | string | ¥ | Required | 物流费用币种 |
| 6.1.8.2 | taxFeeIcon | 税费币种 | string | ¥ | Required | 税费币种 |
| 6.1.8.3 | feeType | 费用类型 | integer | 1 | Required | 费用类型,1:预估,2:实际,3:差异 |
| 6.1.8.4 | logisticsFee | 物流费用 | string | 4704.20 | Required | 物流费用 |
| 6.1.8.5 | taxFee | 税费 | string | 0.00 | Required | 税费 |
| 6.1.8.6 | price | 单价 | string | 4704.10 | Required | 单价 |
| 6.1.8.7 | priceCurrency | 单价币种 | string | CNY | Required | 单价币种 |
| 6.1.8.8 | chargeableWeight | 计费重 | string | 10.00 | Required | 计费重 |
| 6.1.8.9 | billingWay | 计费方式 | string | cbm | Required | 计费方式 |
| 6.1.8.10 | remark | 备注 | string | 4815 | Required | 备注 |
| 6.1.8.11 | priceIcon | 单价币种 | string | ¥ | Required | 单价币种 |
| 6.1.8.12 | otherFeeValue | 总其他费用 | string | 141132.00 | Required | 总其他费用 |
| 6.1.8.13 | totalFeeValue | 总物流费用 | string | 145836.20 | Required | 总物流费用 |
| 6.1.9 | logisticsTrackingNumberList | 物流商单号列表(旧版物流可能多个物流商单号) | array<any> | ["4827"] | Required | 物流商单号列表(旧版物流可能多个物流商单号) |
| 6.1.10 | trackingNoList | 查询单号列表 | array<any> | ["123","A111115815"] | Required | 查询单号列表 |
| 6.1.11 | fundsDiscount | 折扣金额 | string | ¥0.00 | Required | 折扣金额 |
| 6.1.12 | fundsPayableAmount | 应付金额 | string | ¥23525.50 | Required | 应付金额 |
| 6.1.13 | fundsPaidFee | 已付金额 | string | ¥0.00 | Required | 已付金额 |
| 6.1.14 | fundsUnpaidFee | 未付金额 | string | ¥23525.50 | Required | 未付金额 |
| 6.1.15 | fundsApplyFee | 申请中 | string | ¥0.00 | Required | 申请中 |
| 6.1.16 | fundsUnapplyFee | 未申请 | string | ¥23525.50 | Required | 未申请 |
| 7 | total | 总数 | integer | 1 | Required | 总数 |
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.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.