Admin API 修改已下单订单的商品怎么做

现象#

需要给订单加一件商品或改数量，直接改 lineItems 报错，提示订单不可编辑。

原因#

• 订单已履约或已退款，处于不可编辑状态
• 必须走 orderEditBegin → orderEditAddVariant → orderEditCommit 流程
• 订单使用了手动付款方式或处于挂起状态

处理步骤#

1. 调用 orderEditBegin(id:) 拿到 calculatedOrder.id
2. 用 orderEditAddVariant / orderEditSetQuantity 修改
3. 需要改价时用 orderEditAddLineItemDiscount
4. 最后 orderEditCommit，可选 notifyCustomer 与 staffNote

验收标准#

订单商品与金额按预期更新，客户收到通知（如选择），后台订单历史有编辑记录。