轻易云
注册体验

领星ERP编辑订单接口

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

编辑订单

POST/pb/mp/order/editOrder
加工厂
{
  "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"
  }
}

接口请求参数

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

接口响应参数

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

领星ERP的接口:编辑订单(/pb/mp/order/editOrder),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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