/basicOpen/multiplatform/shippingList/updateLogistics{
"operation": {
"method": "POST",
"path": "/basicOpen/multiplatform/shippingList/updateLogistics"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": {
"data": [
{
"shippingListCode": "SP202608050000000",
"logisticsInfo": [
{
"logisticsNumber": "LOG20260810001",
"trackingNumber": "TRK20260810001"
}
]
}
]
},
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "426951E6-1B62-1B12-90AF-07648AACC512",
"response_time": "2026-08-26 14:30:00",
"total": 2,
"data": []
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | data | 参数数组 | array<object> | — | Required | 参数数组 |
| 1.1 | shippingListCode | 发货单号 | string | — | Required | 发货单号 |
| 1.2 | logisticsProviderId | 物流商id | integer | — | Optional | 物流商id 查询头程物流商接口对应字段【providerId】 |
| 1.3 | logisticsChannelId | 物流渠道id | integer | — | Optional | 物流渠道id:按计费重分摊时必填,以获取材积参数用于计算 查询头程物流渠道列表接口对应字段【id】 |
| 1.4 | headFeeType | 头程费分配方式 | integer | — | Optional | 头程费分配方式: 1-按计费重 2-按实重 3-按体积重 4-按SKU数量 5-按箱子体积 6-自定义 |
| 1.5 | arrivalTime | 到货时间 | string | — | Optional | 到货时间,格式:Y-m-d |
| 1.6 | sailTime | 开船时间 | string | — | Optional | 开船时间,格式:Y-m-d |
| 1.7 | expectedArrivalTime | 预计到港时间 | string | — | Optional | 预计到港时间,格式:Y-m-d |
| 1.8 | actualDeliveryTime | 实际发货时间 | string | — | Optional | 实际发货时间,格式:Y-m-d |
| 1.9 | actualDueTime | 实际妥投时间 | string | — | Optional | 实际妥投时间,格式:Y-m-d |
| 1.10 | shippingListRemark | 发货单备注 | string | — | Optional | 发货单备注 |
| 1.11 | logisticsInfo | 物流信息明细数组 | array<object> | — | Optional | 物流信息明细数组。覆盖式更新:未传或传空数组会清空原有物流明细 |
| 1.11.1 | logisticsNumber | 物流商单号 | string | — | Optional | 物流商单号 |
| 1.11.2 | trackingNumber | 跟踪号 | string | — | Optional | 跟踪号 |
| 1.11.3 | transportationCost | 实际物流费用 | string | — | Optional | 实际物流费用,精度小数点后 2 位。费用填写时 transportationCurrency 必填 |
| 1.11.4 | transportationCurrency | 实际物流费用币种 | string | — | Optional | 实际物流费用币种,字母代码(如 CNY/USD) |
| 1.11.5 | otherCost | 实际其他费用 | string | — | Optional | 实际其他费用,精度小数点后 2 位。费用填写时 otherCurrency 必填 |
| 1.11.6 | otherCurrency | 实际其他费用币种 | string | — | Optional | 实际其他费用币种 |
| 1.11.7 | otherCostRemark | 实际其他费用备注 | string | — | Optional | 实际其他费用备注 |
| 1.11.8 | expectedTransportationCost | 预估物流费用 | string | — | Optional | 预估物流费用,精度小数点后 2 位。费用填写时 expectedTransportationCurrency 必填 |
| 1.11.9 | expectedTransportationCurrency | 预估物流费用币种 | string | — | Optional | 预估物流费用币种 |
| 1.11.10 | expectedOtherCost | 预估其他费用 | string | — | Optional | 预估其他费用,精度小数点后 2 位。费用填写时 expectedOtherCurrency 必填 |
| 1.11.11 | expectedOtherCurrency | 预估其他费用币种 | string | — | Optional | 预估其他费用币种 |
| 1.11.12 | expectedOtherCostRemark | 预估其他费用备注 | string | — | Optional | 预估其他费用备注 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 接口处理结果码 | integer | 0 | Required | 接口处理结果码;逐单失败原因见error_details |
| 2 | message | 接口处理结果消息 | string | success | Required | 接口处理结果消息 |
| 3 | error_details | 逐单失败明细 | array<object> | — | Required | 逐单失败明细;全部成功时为空数组 |
| 3.1 | shippingListCode | 更新失败的发货单号 | string | SP202608000000000 | Optional | 更新失败的发货单号 |
| 3.2 | fail_reason | 失败原因 | string | 已请款,不支持覆盖更新物流信息 | Optional | 失败原因 |
| 4 | request_id | 请求追踪ID | string | 426951E6-1B62-1B12-90AF-07648AACC512 | Required | 请求追踪ID |
| 5 | response_time | 响应时间 | string | 2026-08-26 14:30:00 | Required | 响应时间,格式:yyyy-MM-dd HH:mm:ss |
| 6 | total | 本次请求的发货单数量 | integer | 2 | Required | 本次请求的发货单数量 |
| 7 | data | 返回数据 | array<any> | — | Required | 返回数据;当前为空数组 |
The 更新多平台发货单物流信息 API (/basicOpen/multiplatform/shippingList/updateLogistics) 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.