Lingxing
切换旧版

头程对账列表

POST/basicOpen/logistics/headLogisticsReconciliation/list

查询头程物流对账列表，对应系统【供应链】>【头程物流对账】数据

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/logistics/headLogisticsReconciliation/listHTTPSPOST1

请求参数

offsetinteger必填
分页偏移量，默认0
lengthinteger必填
每页条数，默认20，最大200
searchFieldTimestring
搜索时间类型
shipment_time：发货时间
gmt_create：发货单创建时间
delivery_date：实际妥投时间
transportation_start_time：运输开始时间
searchFieldstring
搜索字段名称
shipment_sn：关联单号
tracking_number：物流商单号
replace_tracking_number：查询单号
order_no：头程物流单单号
shipment_id：货件单号
searchValuestring
搜索字段值
shippingMethodIdsarray<any>
运输方式
businessCodeArrarray<any>
单据类型
1：发货单
2：备货单
logisticsProviderIdarray<any>
物流商
logisticsChannelIdarray<any>
物流渠道
payStatusarray<any>
付款状态
0：未申请
1：已申请
2：部分付款
3：已付清
4：无
sidsArrarray<any>
店铺
coeffVariationstring
差异系数
startDatestring
开始日期
endDatestring
结束日期
seniorSearchListarray<object>
批量搜索
隐藏子属性
searchFieldstring
批量搜索字段
searchValuearray<any>
批量搜索值

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/logistics/headLogisticsReconciliation/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "offset": 0,
    "length": 20,
    "searchFieldTime": "shipment_time",
    "searchField": "shipment_sn",
    "searchValue": "SP230706004",
    "shippingMethodIds": [],
    "businessCodeArr": [],
    "logisticsProviderId": [],
    "logisticsChannelId": [],
    "payStatus": [],
    "sidsArr": [],
    "coeffVariation": "",
    "startDate": "2024-01-01",
    "endDate": "2024-12-31",
    "seniorSearchList": []
}'

返回结果

Json Object

codeinteger必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-05-19 12:00:00
dataobject必填
响应数据
隐藏子属性
listobject
隐藏子属性
refOrderNostring必填
关联单号
示例 SP230706004
orderNostring必填
头程物流单单号
示例 FL230724001
logisticsProviderNamestring必填
物流商
示例 忠迅
logisticsChannelNamestring必填
物流渠道
示例 测材积
isNewVersioninteger必填
是否新版费用，0：否，1：是
示例 1
businessCodeinteger必填
单据类型，1：发货单，2：备货单
示例 1
shipmentsarray<any>必填
货件号
示例 ["FBA16STCT522"]
feesarray<object>必填
费用列表
隐藏子属性
logisticsFeeIconstring必填
物流费用币种
示例 ￥
taxFeeIconstring必填
税费币种
示例 ￥
feeTypeinteger必填
费用类型，1：预估，2：实际，3：差异
示例 1
logisticsFeestring必填
物流费用
示例 4704.20
taxFeestring必填
税费
示例 0.00
pricestring必填
单价
示例 4704.10
priceCurrencystring必填
单价币种
示例 CNY
chargeableWeightstring必填
计费重
示例 10.00
billingWaystring必填
计费方式
示例 cbm
remarkstring必填
备注
示例 4815
priceIconstring必填
单价币种
示例 ￥
otherFeeValuestring必填
总其他费用
示例 141132.00
totalFeeValuestring必填
总物流费用
示例 145836.20
logisticsTrackingNumberListarray<any>必填
物流商单号列表（旧版物流可能多个物流商单号）
示例 ["4827"]
trackingNoListarray<any>必填
查询单号列表
示例 ["123","A111115815"]
fundsDiscountstring必填
折扣金额
示例 ￥0.00
fundsPayableAmountstring必填
应付金额
示例 ￥23525.50
fundsPaidFeestring必填
已付金额
示例 ￥0.00
fundsUnpaidFeestring必填
未付金额
示例 ￥23525.50
fundsApplyFeestring必填
申请中
示例 ￥0.00
fundsUnapplyFeestring必填
未申请
示例 ￥23525.50
totalinteger必填
总数
示例 1

返回成功示例

{
    "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
}