轻易云
注册体验

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

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

更新发货单物流信息

POST/erp/sc/routing/storage/shipment/updateListLogistics
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/erp/sc/routing/storage/shipment/updateListLogistics"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 2,
    "text": ""
  },
  "requestExample": {
    "data": [
      {
        "order_sn": "SP220120057",
        "expected_arrival_date": "2022-05-06",
        "etd_date": "2022-05-06",
        "eta_date": "2022-05-06",
        "delivery_date": "2022-05-06",
        "actual_shipment_time": "2022-05-06",
        "tax_fee_type": "0",
        "logistics_list": [
          {
            "tracking_number": "22",
            "replace_tracking_number": "20215486",
            "transportation_cost": 0,
            "transportation_currency": "CNY",
            "other_cost": 0,
            "other_currency": "CNY",
            "other_cost_remark": "其他费用备注",
            "predicted_transportation_cost": 44,
            "predicted_transportation_currency": "CNY",
            "predicted_other_cost": 12,
            "predicted_other_currency": "CNY"
          }
        ],
        "logistics_list_type": 0,
        "head_logistics_list": {
          "tracking_list": [
            {
              "tracking_no": "cxdhxxxxxx123",
              "transport_type": "1",
              "order_type_code": "5",
              "shippers": "coscoxxx",
              "remark": "备注"
            }
          ],
          "estimate_expenses_list": {
            "price": "1.00",
            "price_currency": "CNY",
            "logistics_fee": "1.00",
            "logistics_fee_currency": "CNY",
            "remark": "预估费用备注",
            "other_fee_arr": [
              {
                "fee_type_id": "241192037543649792",
                "other_amount": "1.00",
                "other_currency": "CNY"
              }
            ]
          },
          "actual_expenses_list": {
            "tax_fee": "1",
            "tax_fee_currency": "CNY",
            "weight": "111.00",
            "volume": "111.00",
            "price": "111.00",
            "price_currency": "CNY",
            "logistics_fee": "111.00",
            "logistics_fee_currency": "CNY",
            "remark": "实际费用备注",
            "other_fee_arr": [
              {
                "fee_type_id": "241192037543649792",
                "other_amount": "111.00",
                "other_currency": "CNY"
              }
            ]
          }
        }
      }
    ]
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1data参数数组array<object>—必填参数数组
1.1order_sn发货单号string—必填发货单号
1.2expected_arrival_date到货时间string—可选到货时间,格式:Y-m-d
1.3etd_date开船时间string—可选开船时间,格式:Y-m-d
1.4eta_date预计到港时间string—可选预计到港时间,格式:Y-m-d
1.5delivery_date实际妥投时间string—可选实际妥投时间,格式:Y-m-d
1.6actual_shipment_time实际发货时间string—可选实际发货时间,格式:Y-m-d
1.7tax_fee_type实际税费分配方式integer—可选实际税费分配方式:【默认0】 0 产品-计费重 1 产品-实重 2 产品-体积重 3 产品-数量 4 自定义 5 箱子-体积/体积重 6 箱子-计费重 7 箱子-实重 8 产品-根据清关单价*税率占比
1.8logistics_channel_id物流渠道idinteger—可选物流渠道id:按计费重分摊时必填,以获取材积参数用于计算 查询头程物流渠道列表接口对应字段【id】
1.9logistics_list_type物流信息版本integer—可选物流信息版本: 1 新版
1.10head_logistics_list新版头程物流信息object—可选新版头程物流信息 【对应 logistics_list_type = 1】 【注意:新版头程物流数据为覆盖式更新,包括tracking_list、estimate_expenses_list、actual_expenses_list,不传或者传空也会置空】
1.10.1logistics_tracking_number物流商单号string—可选物流商单号
1.10.2tracking_list轨迹信息数组array<object>—必填轨迹信息数组
1.10.2.1tracking_no查询单号string—可选查询单号
1.10.2.2transport_type运输类型integer—必填运输类型: 1 快递 2 海运 3 空运 4 其他
1.10.2.3order_type_code单号类型integer—必填单号类型:【注意:与运输类型联动关系】 1 订舱号 2 提单号 3 箱号 4 其他 5 跟踪单号 6航班号 当transport_type=1时只能传5 当transport_type=2时只能传1、2、3、4 当transport_type=3时只能传2、6 当transport_type=4只能传空
1.10.2.4shippers承运商string—可选承运商,运输类型为海运时才有意义: 获取发货单头程物流-承运商信息接口获取
1.10.2.5remark备注string—可选备注
1.10.3estimate_expenses_list费用明细-预估费用object—必填费用明细-预估费用
1.10.3.1chargeable_weight计费重(单位KG)【废弃字段】string—可选计费重(单位KG)【废弃字段】
1.10.3.2price单价string—必填单价
1.10.3.3price_currency单价币种string—必填单价币种
1.10.3.4logistics_fee物流费用string—必填物流费用
1.10.3.5logistics_fee_currency物流费用币种string—必填物流费用币种
1.10.3.6remark备注string—可选备注
1.10.3.7other_fee_arr预估费用-其他费array<object>—必填预估费用-其他费: 获取发货单头程物流-其他费类型接口获取
1.10.3.7.1fee_type_id其他费id(20位)string—必填其他费id(20位)
1.10.3.7.2other_amount其他费金额string—必填其他费金额
1.10.3.7.3other_currency其他费币种string—必填其他费币种
1.10.4actual_expenses_list费用明细-实际费用object—必填费用明细-实际费用
1.10.4.1tax_fee税费string—必填税费
1.10.4.2tax_fee_currency税费币种string—必填税费币种
1.10.4.3price单价string—必填单价
1.10.4.4price_currency单价币种string—必填单价币种
1.10.4.5logistics_fee物流费用string—必填物流费用
1.10.4.6logistics_fee_currency物流费用币种string—必填物流费用币种
1.10.4.7remark备注string—可选备注
1.10.4.8other_fee_arr实际费用-其他费array<object>—必填实际费用-其他费: 获取发货单头程物流-其他费类型接口获取
1.10.4.8.1fee_type_id其他费idstring—必填其他费id
1.10.4.8.2other_amount其他费金额string—必填其他费金额
1.10.4.8.3other_currency其他费币种string—必填其他费币种
1.11logistics_list旧版物流信息array<object>—必填旧版物流信息,即将下线
1.11.1tracking_number物流商单号string—必填物流商单号
1.11.2replace_tracking_number跟踪号string—必填跟踪号
1.11.3transportation_cost实际物流费用number—可选实际物流费用,精度是小数点后2位
1.11.4transportation_currency实际物流费用币种string—可选实际物流费用币种,费用填写时必填
1.11.5other_cost实际其他费用number—可选实际其他费用,精度是小数点后2位
1.11.6other_currency实际其他费用币种string—可选实际其他费用币种,费用填写时必填
1.11.7other_cost_remark其他费用备注string—可选其他费用备注
1.11.8predicted_transportation_cost预估物流费用number—可选预估物流费用,精度是小数点后2位
1.11.9predicted_transportation_currency预估物流费用币种string—可选预估物流费用币种,费用填写时必填
1.11.10predicted_other_cost预估其他费用number—可选预估其他费用,精度是小数点后2位
1.11.11predicted_other_currency预估其他费用币种string—可选预估其他费用币种,费用填写时必填
2head_logistics_listhead_logistics_listobject—可选
2.1actual_expenses_listactual_expenses_listobject—可选
2.1.1chargeable_weight计费重【废弃字段】string—必填计费重【废弃字段】
2.1.2weight实重(单位string—必填实重(单位:KG)
2.1.3volume体积(单位string—必填体积(单位:m³)

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message消息提示stringsuccess必填消息提示
3error_details错误信息array<any>—必填错误信息
4request_id请求链路idstring426951E6-1B62-1B12-90AF-07648AACC512必填请求链路id
5response_time响应时间string2022-02-24 20:04:36必填响应时间
6total总数integer0必填总数
7data响应数据array<any>&nbsp;必填响应数据

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

需要对接这个接口?

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