/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"
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | order_list | 待编辑订单列表 | array<object> | — | 必填 | 待编辑订单列表,单次支持 1~50 个订单 |
| 1.1 | global_order_no | 系统订单号 | integer | — | 必填 | 系统订单号 |
| 1.2 | logistics | 物流信息 | object | — | 可选 | 物流信息。编辑仓库、物流方式或包裹规格时传入;仅编辑报关时可不传或传空对象 |
| 1.2.1 | logistics_type_id | 物流方式 ID | integer | — | 可选 | 物流方式 ID。编辑仓库或物流方式时必填,必须为有效且已启用的正数 ID;仅编辑包裹规格时无需传入。可通过查询已启用的自发货物流方式接口获取 |
| 1.2.2 | sys_wid | 发货仓库 WID | integer | — | 可选 | 发货仓库 WID。修改仓库时传入有效正数 ID,且必须同时传入 logistics_type_id;仅编辑物流方式时可不传,保留原仓库。可通过查询仓库列表接口获取 |
| 1.2.3 | pre_pkg_length | 订单包裹预估长 | number | — | 可选 | 订单包裹预估长,单位 cm,非负数;四项规格需同时传入 |
| 1.2.4 | pre_pkg_width | 订单包裹预估宽 | number | — | 可选 | 订单包裹预估宽,单位 cm,非负数;四项规格需同时传入 |
| 1.2.5 | pre_pkg_height | 订单包裹预估高 | number | — | 可选 | 订单包裹预估高,单位 cm,非负数;四项规格需同时传入 |
| 1.2.6 | pre_weight | 订单包裹预估总重量 | number | — | 可选 | 订单包裹预估总重量,单位 g,非负数;不是报关重量或 SKU 单品重量,四项规格需同时传入 |
| 1.3 | modify_declared | 是否编辑报关 | integer | — | 可选 | 是否编辑报关:1 编辑;未传、null 或 0 不编辑;其他值返回该订单参数错误 |
| 1.4 | declared_info | 报关明细 | array<object> | — | 可选 | 报关明细。modify_declared=1 时必须传非空列表;未开启报关编辑时忽略该字段 |
| 1.4.1 | sku | 商品本地 SKU | string | — | 必填 | 商品本地 SKU,不能为 null、空串或纯空白 |
| 1.4.2 | id | 原有报关明细主键 ID | integer | — | 可选 | 原有报关明细主键 ID,不是订单商品 ID。编辑原有明细时应保留;新增行可不传或传 0 |
| 1.4.3 | cn_name | 中文报关名 | string | — | 必填 | 中文报关名,不能为纯空白 |
| 1.4.4 | en_name | 英文报关名 | string | — | 必填 | 英文报关名,不能为纯空白 |
| 1.4.5 | unit_price | 目的国申报单价 | string | — | 必填 | 目的国申报单价,数字字符串且必须大于 0;币种由 currency_code 指定 |
| 1.4.6 | currency_code | 申报币种代码 | string | — | 必填 | 申报币种代码,例如 USD;必填校验由 OMS 执行 |
| 1.4.7 | weight | 申报重量 | string | — | 必填 | 申报重量,单位 g,数字字符串且必须大于 0 |
| 1.4.8 | quantity | 申报数量 | integer | — | 必填 | 申报数量,必须为大于 0 的整数 |
| 1.4.9 | hs_code | 海关编码 | string | — | 可选 | 海关编码,按实际商品填写;下游业务要求沿用 OMS |
| 1.4.10 | special_attr | 商品特殊属性编码列表 | array<any> | — | 可选 | 商品特殊属性编码列表;无特殊属性可传空数组 |
| 1.4.11 | merge_ids | 合并报关行对应的底层报关明细 ID 列表 | array<any> | — | 可选 | 合并报关行对应的底层报关明细 ID 列表。OMS 详情回显字段,当前报关保存逻辑不消费,普通请求无需传入 |
| 1.4.12 | merge_pids | merge_pids | array<any> | — | 可选 | 合并报关场景下新增订单商品对应的本地产品 ID 列表。内部辅助字段,普通请求无需传入 |
| 1.4.13 | order_item_id | 关联的 OMS 订单商品明细主键 ID 列表 | array<any> | — | 可选 | 关联的 OMS 订单商品明细主键 ID 列表,不是平台商品行号;普通按 SKU 编辑时由 OMS 自动匹配 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码 0:订单更新成功 10000:订单更新失败 10001:订单更新部分成功 |
| 2 | message | 消息提示 | string | 订单更新成功 | 必填 | 消息提示。JSON 字段为 message,不是 Java 属性名 msg |
| 3 | data | 订单编辑结果 | object | — | 必填 | 订单编辑结果 |
| 3.1 | error_details | 逐单错误列表 | array<object> | — | 必填 | 逐单错误列表;全部成功时为空数组 |
| 3.1.1 | global_order_no | 失败订单的系统单号 | integer | 103741652556357630 | 必填 | 失败订单的系统单号 |
| 3.1.2 | error_message | 该订单的失败原因 | string | 报关明细【LOCAL-SKU-002】:英文报关名en_name不能为空 | 必填 | 该订单的失败原因 |
| 4 | request_id | 请求链路 ID | string | ad9c1a8625c74f3ea0525e216374e31a1676514819613 | 必填 | 请求链路 ID |
| 5 | response_time | 响应时间 | string | 2026-09-08 10:00:00 | 必填 | 响应时间,格式 yyyy-MM-dd HH:mm:ss |
领星ERP的接口:编辑订单(/pb/mp/order/editOrder),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。