自 API 版本 2026-10 起，通过 orderUpdate GraphQL 变更 或 REST Admin API 订单更新端点 更改未履行订单的配送地址时，系统会根据新目的地重新计算订单税费。此前，orderUpdate 仅保存新地址而保持原始税目不变，导致订单总额与配送目的地不匹配。
为何重要
作为更新的一部分，订单的财务数据现已更正，确保总额准确反映配送目的地。更新配送地址后，您可像处理其他任何订单编辑一样查询订单以读取更新的 taxLines、totalTaxSet 及总额。您无需进行任何更改即可采用此功能。
工作原理
此变更适用于 2026-10 及更高版本的 API，包括 GraphQL Admin API 和 REST Admin API。
在以下情况下不会重新计算税费：
- 请求使用的 API 版本早于 2026-10：地址会被保存且税目保持不变，这与当前这些版本的行为一致。
- 订单部分履行或完全履行：地址会更新但税费保持不变，因为部分或全部商品已发往原始目的地，若根据新地址重新计算整个订单，会将新目的地的税费应用于未发往该目的地的商品，从而导致总额与实际履行情况不匹配。
- 订单无法编辑：重新计算通过订单编辑流程运行，因此适用相同的 订单编辑注意事项。当订单不符合编辑条件时，地址会被保存但不会重新计算税费。
orders/edited Webhook 订阅者在地址变更导致税费重新计算时会收到通知。
由于重新计算可能改变订单总额，已付款的订单可能会留下待退或待付的余额。更新后，请将订单余额与其更新前的值进行比较：如果余额在您的应用容忍范围内增加，则将订单标记为已付款（orderMarkAsPaid）；如果增加幅度较大，商家可以发送发票（orderInvoiceSend）；如果余额减少，则退还差额（refundCreate）。
欲了解更多信息，请参阅 orderUpdate 变更 以及 开发者社区讨论。