更新多平台发货单物流信息

用于更新平台仓发货单内的【物流信息】，包括物流商/物流渠道/物流单号/跟踪号/各项时间/运费/其他费用等。支持按发货单号批量更新，每个发货单可携带多条物流信息明细。

物流信息为覆盖式更新：logisticsInfo 数组传入后会替换该发货单原有物流信息，未传或传空数组会清空原有物流明细。请按需传入完整物流信息。

接口信息

请求参数

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/shippingList/updateLogistics?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "data": [
        {
            "shippingListCode": "SP202608050000000",
            "logisticsInfo": [
                {
                    "logisticsNumber": "LOG20260810001",
                    "trackingNumber": "TRK20260810001"
                }
            ]
        }
    ]
}'

请求示例

1. 基础场景：单发货单更新物流单号与跟踪号

{
    "data": [
        {
            "shippingListCode": "SP202608050000000",
            "logisticsInfo": [
                {
                    "logisticsNumber": "LOG20260810001",
                    "trackingNumber": "TRK20260810001"
                }
            ]
        }
    ]
}

1. 完整场景：批量更新物流商、渠道、各项时间与费用

{
    "data": [
        {
            "shippingListCode": "SP202608050000000",
            "logisticsProviderId": 10086,
            "logisticsChannelId": 20011,
            "headFeeType": 1,
            "sailTime": "2026-08-10",
            "arrivalTime": "2026-08-25",
            "expectedArrivalTime": "2026-09-05",
            "actualDeliveryTime": "2026-08-12",
            "actualDueTime": "2026-09-10",
            "logisticsInfo": [
                {
                    "logisticsNumber": "LOG20260810000",
                    "trackingNumber": "TRK20260810000",
                    "transportationCost": "1500.00",
                    "transportationCurrency": "CNY",
                    "otherCost": "100.00",
                    "otherCurrency": "CNY",
                    "otherCostRemark": "报关代办费",
                    "expectedTransportationCost": "1400.00",
                    "expectedTransportationCurrency": "CNY",
                    "expectedOtherCost": "80.00",
                    "expectedOtherCurrency": "CNY",
                    "expectedOtherCostRemark": "预估报关费"
                }
            ]
        },
        {
            "shippingListCode": "SP202608050000001",
            "logisticsInfo": [
                {
                    "logisticsNumber": "LOG20260800000",
                    "trackingNumber": "TRK20260810000"
                }
            ]
        }
    ]
}

1. 清空物流明细场景

{
    "data": [
        {
            "shippingListCode": "SP202608050000000",
            "logisticsInfo": []
        }
    ]
}

返回结果

Json Object

返回成功示例

1. 全部成功

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "426951E6-1B62-1B12-90AF-07648AACC512",
    "response_time": "2026-08-26 14:30:00",
    "total": 2,
    "data": []
}

1. 部分成功

{
    "code": 0,
    "message": "success",
    "error_details": [
        {
            "shippingListCode": "SP202608000000000",
            "fail_reason": "发货单状态为已取消，不允许更新物流信息"
        }
    ],
    "request_id": "426951E6-1B62-1B12-90AF-07648AACC512",
    "response_time": "2026-08-26 14:30:00",
    "total": 2,
    "data": []
}