Qeasy Cloud
Get Started

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

Platform
领星ERP
Type
WebAPI
Effect
EXECUTE
API Version
1.0
Adapter
\Adapter\LingXing\LXExecuteAdapter
Auth Mode
OTHER
Description
FBA / 发货单 · POST · 请求参数 58 个(必填 31) · 响应参数 7 个 · 限流令牌桶容量 2
Updated At
2026-11-21

更新发货单物流信息

POST/erp/sc/routing/storage/shipment/updateListLogistics
Factory
{
  "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"
              }
            ]
          }
        }
      }
    ]
  }
}

Request Parameters

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

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0 成功
2message消息提示stringsuccessRequired消息提示
3error_details错误信息array<any>—Required错误信息
4request_id请求链路idstring426951E6-1B62-1B12-90AF-07648AACC512Required请求链路id
5response_time响应时间string2022-02-24 20:04:36Required响应时间
6total总数integer0Required总数
7data响应数据array<any>&nbsp;Required响应数据

The 更新发货单物流信息 API (/erp/sc/routing/storage/shipment/updateListLogistics) 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.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.