/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
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | offset | 分页偏移量 | integer | — | 必填 | 分页偏移量,默认0 |
| 2 | length | 每页条数 | integer | — | 必填 | 每页条数,默认20,最大200 |
| 3 | searchFieldTime | 搜索时间类型 | string | — | 可选 | 搜索时间类型 shipment_time:发货时间 gmt_create:发货单创建时间 delivery_date:实际妥投时间 transportation_start_time:运输开始时间 |
| 4 | searchField | 搜索字段名称 | string | — | 可选 | 搜索字段名称 shipment_sn:关联单号 tracking_number:物流商单号 replace_tracking_number:查询单号 order_no:头程物流单单号 shipment_id:货件单号 |
| 5 | searchValue | 搜索字段值 | string | — | 可选 | 搜索字段值 |
| 6 | shippingMethodIds | 运输方式 | array<any> | — | 可选 | 运输方式 |
| 7 | businessCodeArr | 单据类型 | array<any> | — | 可选 | 单据类型 1:发货单 2:备货单 |
| 8 | logisticsProviderId | 物流商 | array<any> | — | 可选 | 物流商 |
| 9 | logisticsChannelId | 物流渠道 | array<any> | — | 可选 | 物流渠道 |
| 10 | payStatus | 付款状态 | array<any> | — | 可选 | 付款状态 0:未申请 1:已申请 2:部分付款 3:已付清 4:无 |
| 11 | sidsArr | 店铺 | array<any> | — | 可选 | 店铺 |
| 12 | coeffVariation | 差异系数 | string | — | 可选 | 差异系数 |
| 13 | startDate | 开始日期 | string | — | 可选 | 开始日期 |
| 14 | endDate | 结束日期 | string | — | 可选 | 结束日期 |
| 15 | seniorSearchList | 批量搜索 | array<object> | — | 可选 | 批量搜索 |
| 15.1 | searchField | 批量搜索字段 | string | — | 可选 | 批量搜索字段 |
| 15.2 | searchValue | 批量搜索值 | array<any> | — | 可选 | 批量搜索值 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 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-05-19 12:00:00 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 6.1 | list | list | object | — | 可选 | |
| 6.1.1 | refOrderNo | 关联单号 | string | SP230706004 | 必填 | 关联单号 |
| 6.1.2 | orderNo | 头程物流单单号 | string | FL230724001 | 必填 | 头程物流单单号 |
| 6.1.3 | logisticsProviderName | 物流商 | string | 忠迅 | 必填 | 物流商 |
| 6.1.4 | logisticsChannelName | 物流渠道 | string | 测材积 | 必填 | 物流渠道 |
| 6.1.5 | isNewVersion | 是否新版费用 | integer | 1 | 必填 | 是否新版费用,0:否,1:是 |
| 6.1.6 | businessCode | 单据类型 | integer | 1 | 必填 | 单据类型,1:发货单,2:备货单 |
| 6.1.7 | shipments | 货件号 | array<any> | ["FBA16STCT522"] | 必填 | 货件号 |
| 6.1.8 | fees | 费用列表 | array<object> | — | 必填 | 费用列表 |
| 6.1.8.1 | logisticsFeeIcon | 物流费用币种 | string | ¥ | 必填 | 物流费用币种 |
| 6.1.8.2 | taxFeeIcon | 税费币种 | string | ¥ | 必填 | 税费币种 |
| 6.1.8.3 | feeType | 费用类型 | integer | 1 | 必填 | 费用类型,1:预估,2:实际,3:差异 |
| 6.1.8.4 | logisticsFee | 物流费用 | string | 4704.20 | 必填 | 物流费用 |
| 6.1.8.5 | taxFee | 税费 | string | 0.00 | 必填 | 税费 |
| 6.1.8.6 | price | 单价 | string | 4704.10 | 必填 | 单价 |
| 6.1.8.7 | priceCurrency | 单价币种 | string | CNY | 必填 | 单价币种 |
| 6.1.8.8 | chargeableWeight | 计费重 | string | 10.00 | 必填 | 计费重 |
| 6.1.8.9 | billingWay | 计费方式 | string | cbm | 必填 | 计费方式 |
| 6.1.8.10 | remark | 备注 | string | 4815 | 必填 | 备注 |
| 6.1.8.11 | priceIcon | 单价币种 | string | ¥ | 必填 | 单价币种 |
| 6.1.8.12 | otherFeeValue | 总其他费用 | string | 141132.00 | 必填 | 总其他费用 |
| 6.1.8.13 | totalFeeValue | 总物流费用 | string | 145836.20 | 必填 | 总物流费用 |
| 6.1.9 | logisticsTrackingNumberList | 物流商单号列表(旧版物流可能多个物流商单号) | array<any> | ["4827"] | 必填 | 物流商单号列表(旧版物流可能多个物流商单号) |
| 6.1.10 | trackingNoList | 查询单号列表 | array<any> | ["123","A111115815"] | 必填 | 查询单号列表 |
| 6.1.11 | fundsDiscount | 折扣金额 | string | ¥0.00 | 必填 | 折扣金额 |
| 6.1.12 | fundsPayableAmount | 应付金额 | string | ¥23525.50 | 必填 | 应付金额 |
| 6.1.13 | fundsPaidFee | 已付金额 | string | ¥0.00 | 必填 | 已付金额 |
| 6.1.14 | fundsUnpaidFee | 未付金额 | string | ¥23525.50 | 必填 | 未付金额 |
| 6.1.15 | fundsApplyFee | 申请中 | string | ¥0.00 | 必填 | 申请中 |
| 6.1.16 | fundsUnapplyFee | 未申请 | string | ¥23525.50 | 必填 | 未申请 |
| 7 | total | 总数 | integer | 1 | 必填 | 总数 |
领星ERP的接口:头程对账列表(/basicOpen/logistics/headLogisticsReconciliation/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。