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