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