Qeasy Cloud
Get Started

领星ERP 编辑订单 API

Platform
领星ERP
Type
WebAPI
Effect
EXECUTE
API Version
1.0
Adapter
\Adapter\LingXing\LXExecuteAdapter
Auth Mode
OTHER
Description
多平台 · POST · 请求参数 24 个(必填 9) · 响应参数 8 个 · 限流令牌桶容量 10
Updated At
2026-11-21

编辑订单

POST/pb/mp/order/editOrder
Factory
{
  "operation": {
    "method": "POST",
    "path": "/pb/mp/order/editOrder"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 10,
    "text": ""
  },
  "requestExample": {
    "order_list": [
      {
        "global_order_no": "103741652556357632",
        "logistics": {
          "sys_wid": 1300,
          "logistics_type_id": 4406
        }
      }
    ]
  },
  "responseExample": {
    "code": 0,
    "message": "订单更新成功",
    "data": {
      "error_details": []
    },
    "request_id": "ad9c1a8625c74f3ea0525e216374e31a1676514819613",
    "response_time": "2026-09-08 10:00:00"
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1order_list待编辑订单列表array<object>—Required待编辑订单列表,单次支持 1~50 个订单
1.1global_order_no系统订单号integer—Required系统订单号
1.2logistics物流信息object—Optional物流信息。编辑仓库、物流方式或包裹规格时传入;仅编辑报关时可不传或传空对象
1.2.1logistics_type_id物流方式 IDinteger—Optional物流方式 ID。编辑仓库或物流方式时必填,必须为有效且已启用的正数 ID;仅编辑包裹规格时无需传入。可通过查询已启用的自发货物流方式接口获取
1.2.2sys_wid发货仓库 WIDinteger—Optional发货仓库 WID。修改仓库时传入有效正数 ID,且必须同时传入 logistics_type_id;仅编辑物流方式时可不传,保留原仓库。可通过查询仓库列表接口获取
1.2.3pre_pkg_length订单包裹预估长number—Optional订单包裹预估长,单位 cm,非负数;四项规格需同时传入
1.2.4pre_pkg_width订单包裹预估宽number—Optional订单包裹预估宽,单位 cm,非负数;四项规格需同时传入
1.2.5pre_pkg_height订单包裹预估高number—Optional订单包裹预估高,单位 cm,非负数;四项规格需同时传入
1.2.6pre_weight订单包裹预估总重量number—Optional订单包裹预估总重量,单位 g,非负数;不是报关重量或 SKU 单品重量,四项规格需同时传入
1.3modify_declared是否编辑报关integer—Optional是否编辑报关:1 编辑;未传、null 或 0 不编辑;其他值返回该订单参数错误
1.4declared_info报关明细array<object>—Optional报关明细。modify_declared=1 时必须传非空列表;未开启报关编辑时忽略该字段
1.4.1sku商品本地 SKUstring—Required商品本地 SKU,不能为 null、空串或纯空白
1.4.2id原有报关明细主键 IDinteger—Optional原有报关明细主键 ID,不是订单商品 ID。编辑原有明细时应保留;新增行可不传或传 0
1.4.3cn_name中文报关名string—Required中文报关名,不能为纯空白
1.4.4en_name英文报关名string—Required英文报关名,不能为纯空白
1.4.5unit_price目的国申报单价string—Required目的国申报单价,数字字符串且必须大于 0;币种由 currency_code 指定
1.4.6currency_code申报币种代码string—Required申报币种代码,例如 USD;必填校验由 OMS 执行
1.4.7weight申报重量string—Required申报重量,单位 g,数字字符串且必须大于 0
1.4.8quantity申报数量integer—Required申报数量,必须为大于 0 的整数
1.4.9hs_code海关编码string—Optional海关编码,按实际商品填写;下游业务要求沿用 OMS
1.4.10special_attr商品特殊属性编码列表array<any>—Optional商品特殊属性编码列表;无特殊属性可传空数组
1.4.11merge_ids合并报关行对应的底层报关明细 ID 列表array<any>—Optional合并报关行对应的底层报关明细 ID 列表。OMS 详情回显字段,当前报关保存逻辑不消费,普通请求无需传入
1.4.12merge_pidsmerge_pidsarray<any>—Optional合并报关场景下新增订单商品对应的本地产品 ID 列表。内部辅助字段,普通请求无需传入
1.4.13order_item_id关联的 OMS 订单商品明细主键 ID 列表array<any>—Optional关联的 OMS 订单商品明细主键 ID 列表,不是平台商品行号;普通按 SKU 编辑时由 OMS 自动匹配

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码 0:订单更新成功 10000:订单更新失败 10001:订单更新部分成功
2message消息提示string订单更新成功Required消息提示。JSON 字段为 message,不是 Java 属性名 msg
3data订单编辑结果object—Required订单编辑结果
3.1error_details逐单错误列表array<object>—Required逐单错误列表;全部成功时为空数组
3.1.1global_order_no失败订单的系统单号integer103741652556357630Required失败订单的系统单号
3.1.2error_message该订单的失败原因string报关明细【LOCAL-SKU-002】:英文报关名en_name不能为空Required该订单的失败原因
4request_id请求链路 IDstringad9c1a8625c74f3ea0525e216374e31a1676514819613Required请求链路 ID
5response_time响应时间string2026-09-08 10:00:00Required响应时间,格式 yyyy-MM-dd HH:mm:ss

The 编辑订单 API (/pb/mp/order/editOrder) 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.