住所変更で税額が自動再計算｜orderUpdate変更点

7月 31, 2026

API CHANGE

住所変更で税額が自動再計算
orderUpdate ミューテーション仕様変更

2026年8月31日〜全Admin GraphQL APIバージョン対象・コード修正不要

2026年8月31日以降、orderUpdate GraphQL ミューテーションで未フルフィルメント注文の配送先住所を変更すると、新しい配送先に基づいて注文の税額が自動的に再計算されます。これまでは住所だけ更新されて税額は元のまま残っていたため、合計金額と実際の配送先が食い違う状態が生じていました。この変更はすべての Admin GraphQL API バージョンに適用され、開発者側のコード変更は不要です。

BACKGROUND

01これまでの課題と変更の概要

従来の orderUpdate では、配送先住所を書き換えてもオーダーの taxLines は変更前の住所に紐づいたまま保持されていました。結果として注文合計額が実際の配送先の税率と乖離し、経理・税務上のリスクを生む可能性がありました。今回の変更でこの不整合が解消されます。

HOW IT WORKS

02仕組みと再計算が行われる条件

住所の保存は常に成功します。税額の再計算は「安全に適用できる場合のみ」条件付きで実行されます。再計算がスキップされるのは以下の2ケースです。

条件	住所保存	税額再計算	理由
完全未フルフィルメント	✅ 実行	✅ 実行	全数量が新住所に届くため安全
部分フルフィルメント済	✅ 実行	⛔ スキップ	出荷済み分に新税率を遡及適用すると実態と乖離するため
注文編集不可の状態	✅ 実行	⛔ スキップ	再計算は注文編集の仕組みを通じて動作するため同条件が適用される

USE CASES

03業務に活かせる具体ユースケース

課題: 顧客が注文後すぐに配送先を変更したとき、変更前の都道府県の税率で請求書が発行されてしまい、税務申告と実態が合わなかった。
打ち手
打ち手: orderUpdate で住所を変更するだけで税額も自動修正されるため、追加の税額計算ロジックや手動修正が不要になる。
効果: 請求書・税務レポートの正確性が向上し、経理工数を削減できる。
技術メモ: 変更後に taxLines・totalTaxSet・totalPriceSet をクエリして最新値を取得すること。

課題: CSチームがカスタマーポータルや管理画面から住所訂正を行った後、バックオフィスシステムとの税額同期に手間がかかっていた。
打ち手: orders/edited Webhook を購読し、税額再計算が発生した注文だけを検知して ERP・会計システムへの差分連携をトリガーする。
効果: 不要なポーリングや全件同期をなくし、バックオフィス連携の効率を改善できる。
技術メモ: Webhook は税額再計算が実際に行われた場合のみ発火する。住所が保存されても再計算がスキップされた場合は orders/edited は発火しない点に注意。

課題: 越境ECで配送先国が変わる住所変更（例：国内→海外）の際、免税・課税の切り替えが反映されず、誤った税額が表示されていた。
打ち手: 未フルフィルメント注文であれば、今回の変更により新しい配送先の税規則が自動適用される。部分フルフィルメント済の場合は再計算されないため、注文をキャンセル・再作成するフローも検討する。
効果: 越境対応の税額誤りをシステム側で防止でき、顧客への誤請求リスクを低減できる。
技術メモ: 部分フルフィルメント済注文は今回の自動再計算対象外。フルフィルメント状態は事前に確認すること。

DEVELOPER NOTES