轻易云
注册体验

领星ERP更新多平台发货单物流信息接口

所属平台
领星ERP
类型
WebAPI
作用
EXECUTE
接口版本
1.0
适配器
\Adapter\LingXing\LXExecuteAdapter
授权方式
OTHER
描述
多平台 · POST · 请求参数 24 个(必填 2) · 响应参数 9 个 · 限流令牌桶容量 1
更新日期
2026-11-21

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

POST/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": []
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1data参数数组array<object>—必填参数数组
1.1shippingListCode发货单号string—必填发货单号
1.2logisticsProviderId物流商idinteger—可选物流商id 查询头程物流商接口对应字段【providerId】
1.3logisticsChannelId物流渠道idinteger—可选物流渠道id:按计费重分摊时必填,以获取材积参数用于计算 查询头程物流渠道列表接口对应字段【id】
1.4headFeeType头程费分配方式integer—可选头程费分配方式: 1-按计费重 2-按实重 3-按体积重 4-按SKU数量 5-按箱子体积 6-自定义
1.5arrivalTime到货时间string—可选到货时间,格式:Y-m-d
1.6sailTime开船时间string—可选开船时间,格式:Y-m-d
1.7expectedArrivalTime预计到港时间string—可选预计到港时间,格式:Y-m-d
1.8actualDeliveryTime实际发货时间string—可选实际发货时间,格式:Y-m-d
1.9actualDueTime实际妥投时间string—可选实际妥投时间,格式:Y-m-d
1.10shippingListRemark发货单备注string—可选发货单备注
1.11logisticsInfo物流信息明细数组array<object>—可选物流信息明细数组。覆盖式更新:未传或传空数组会清空原有物流明细
1.11.1logisticsNumber物流商单号string—可选物流商单号
1.11.2trackingNumber跟踪号string—可选跟踪号
1.11.3transportationCost实际物流费用string—可选实际物流费用,精度小数点后 2 位。费用填写时 transportationCurrency 必填
1.11.4transportationCurrency实际物流费用币种string—可选实际物流费用币种,字母代码(如 CNY/USD)
1.11.5otherCost实际其他费用string—可选实际其他费用,精度小数点后 2 位。费用填写时 otherCurrency 必填
1.11.6otherCurrency实际其他费用币种string—可选实际其他费用币种
1.11.7otherCostRemark实际其他费用备注string—可选实际其他费用备注
1.11.8expectedTransportationCost预估物流费用string—可选预估物流费用,精度小数点后 2 位。费用填写时 expectedTransportationCurrency 必填
1.11.9expectedTransportationCurrency预估物流费用币种string—可选预估物流费用币种
1.11.10expectedOtherCost预估其他费用string—可选预估其他费用,精度小数点后 2 位。费用填写时 expectedOtherCurrency 必填
1.11.11expectedOtherCurrency预估其他费用币种string—可选预估其他费用币种
1.11.12expectedOtherCostRemark预估其他费用备注string—可选预估其他费用备注

接口响应参数

序号字段名称类型默认值必填描述
1code接口处理结果码integer0必填接口处理结果码;逐单失败原因见error_details
2message接口处理结果消息stringsuccess必填接口处理结果消息
3error_details逐单失败明细array<object>—必填逐单失败明细;全部成功时为空数组
3.1shippingListCode更新失败的发货单号stringSP202608000000000可选更新失败的发货单号
3.2fail_reason失败原因string已请款,不支持覆盖更新物流信息可选失败原因
4request_id请求追踪IDstring426951E6-1B62-1B12-90AF-07648AACC512必填请求追踪ID
5response_time响应时间string2026-08-26 14:30:00必填响应时间,格式:yyyy-MM-dd HH:mm:ss
6total本次请求的发货单数量integer2必填本次请求的发货单数量
7data返回数据array<any>—必填返回数据;当前为空数组

领星ERP的接口:更新多平台发货单物流信息(/basicOpen/multiplatform/shippingList/updateLogistics),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。