未発送の注文で変わること
APIバージョン 2026-10 から、まだ発送していない注文の配送先を変更すると、その注文の税額が新しい届け先を基準に計算し直されるようになります。ここでいうAPIバージョン(Shopify が外部のアプリに提供する窓口の版)は、四半期ごとに新しいものが出る仕組みになっています。
Shopify は2026年7月30日に、開発者向けの Changelog へこの変更を掲載しました。
出典: Shopify developer changelog「Updating an order’s shipping address recalculates taxes as of API version 2026-10」2026年7月30日
https://shopify.dev/changelog/updating-an-orders-shipping-address-returns-accurate-financial-data
公式は、変更の範囲を次のように書いています。
As of API version 2026-10, changing the shipping address on an unfulfilled order through the
orderUpdateGraphQL mutation or the REST Admin API order update endpoint recalculates the order’s taxes against the new destination.
(APIバージョン 2026-10 から、未発送の注文の配送先をorderUpdateGraphQL ミューテーション、または REST Admin API の注文更新エンドポイント経由で変更すると、注文の税額が新しい届け先に対して計算し直されます)
本記事が扱うのは、この Changelog に書かれている範囲だけであり、実際の店舗で何がどう見えるようになるかは本記事では確かめていません。
これまでの挙動との違い
公式は、これまで何が起きていたかについても、同じ Changelog のなかではっきり書いています。
Previously,
orderUpdatesaved the new address but left the original tax lines unchanged, so the order’s totals no longer matched the destination it was shipping to.
(これまではorderUpdateは新しい住所を保存する一方で、元の税明細はそのままにしていました。そのため注文の合計金額が、実際の配送先と合わない状態になっていました)
つまり、これまでは配送先だけが新しい住所に置き換わり、税明細(注文に紐づく税額の内訳)は古い住所で計算されたまま残っていたということになりますが、これはあくまで公式が自社の挙動として書いている説明であって、個々の店の帳簿で実際にどれだけのずれが出ていたかは書かれていません。
Shopify はこの変更によって注文の金額が届け先に対して正しい状態に保たれるようになる、という趣旨の説明を添えていますが、正しい状態という語が具体的にどの税制を指すのかについての記載はありません。これは Shopify が自社の仕様として発表した内容であって、個々の店の税務処理がこれで足りるかどうかは別の話です。
支払い済みの注文に残る過不足
店の手元にいちばん直接くるのは、住所を直しただけのつもりで注文の合計金額が動き、すでに支払いが済んだ注文に差額が残るという場面です。
Because recalculation can change the order’s total, an already-paid order can be left with an outstanding refundable or payable balance.
(計算し直しによって注文の合計が変わりうるため、すでに支払い済みの注文に、返金すべき残高または請求すべき残高が残ることがあります)
合計が増えれば足りない分が残り、合計が減れば返すべき分が残るという形になりますが、どちらに動くかは届け先と税制の組み合わせで決まるため、公式もどちらに転ぶかまでは書かれていません。どれくらいの頻度でこうした差額が生じるのかについても、記載はありません。
公式はその後の扱いとして、増えた額が許容範囲に収まるなら支払い済みとして処理し、大きく増えたのであれば請求書を送り、減っていれば差額を返金する、という三通りを並べています。
ただし、この三通りのどれを選ぶかが自動で決まるとは書かれておらず、注文を更新した側が更新前の残高と比べて判断するという形で書かれています。
税額が計算し直されない3つの場合
公式は、税額が計算し直されない条件を三つ挙げており、この三つに当たる注文では住所だけが保存されて税明細は動きません。
一つ目は 2026-10 より前のAPIバージョンを使っている場合で、このときは住所が保存されて税明細はそのまま残るという、現在までと同じ動きになります。
二つ目は注文が一部でも発送済みになっている場合で、すでに出荷された分に新しい届け先の税を当てると実際に発送された内容と合わない合計になってしまうから、というのが公式の挙げている理由です。
三つ目はその注文が編集できない場合で、計算し直しは注文編集の仕組みを通して走るため、注文編集ができない条件に当たるときは住所だけが保存されます。
裏返すと、この変更が効くのはまだ一つも発送していない注文に限られるということになりますが、個々の注文が編集可能かどうかを店の画面上でどう見分けるかについては書かれていません。
2026年10月1日という日付の読み方
APIバージョン 2026-10 のリリース日は、Shopify が公開しているリリース一覧に、現在の状態がリリース候補(正式版の前に公開される版)であることと合わせて載っています。
2026-10 / October 1, 2026 / October 16, 2027 15:00 UTC / Release candidate
(2026-10 / 2026年10月1日リリース / 2027年10月16日 15:00 UTC まで利用可能 / 現在はリリース候補)出典: Shopify「API versioning」Shopify API release schedule
https://shopify.dev/docs/api/usage/versioning
ここで読み違えやすいのは、10月1日に出るのがAPIバージョンそのものであって、その日に全店の画面がいっせいに切り替わるとは公式が書いていないという点です。
この変更が実際に効きはじめるのは、注文を更新しているアプリが 2026-10 以降のバージョンを使うようになったときであり、どのアプリがいつバージョンを上げるかについての記載はありません。
したがって、10月1日を過ぎても使っているアプリによって挙動が違うという状態が続くことになりますが、その期間がどれくらい続くのかも書かれていません。
公式はこの変更について、取り入れるために何かを変更する必要はないという趣旨も添えています。
You don’t need to make any changes to adopt this.
(これを取り入れるために変更を加える必要はありません)
これは設定作業が要らないという意味であって、何も起こらないという意味だとは本記事では読みません。
影響を受ける店の範囲
本記事の内容が直接かかわるのは、注文の配送先をアプリや外部システム経由で変更している店です。
公式が名指ししているのは orderUpdate GraphQL ミューテーションと REST Admin API の注文更新エンドポイント(外部のアプリが注文を書き換えるときに呼び出す窓口)の二つであり、受注管理システムやカスタマーサポートのツールから注文を直している場合、あるいは自社で作った連携を使っている場合が、この二つを通っている可能性の高い経路にあたります。
一方で、Shopify管理画面から人の手で住所を直した場合にどう振る舞うのかは、この Changelog には書かれていないため、本記事では管理画面経由なら影響を受けないとは書きません。
なお公式は、住所の変更によって税額の計算し直しが起きたとき orders/edited webhook(出来事が起きたことを外部のシステムへ自動で知らせる仕組み)の購読者へ通知が届くという記載も添えていますが、これは連携側に届く通知の話であって、店主が管理画面上で気づけるかどうかとは別の話です。
🔴 公式に書かれていないこと
Changelog に書かれていない事項を、書かれていないまま並べます。
Shopify管理画面から人の手で住所を変更した場合にどう振る舞うのかは書かれていませんし、この変更の対象となる国と地域についての記載もなく、日本の店でどうなるかを読み取れる記述は見当たりません。
日本の消費税の扱いについては何も書かれておらず、税額の計算し直しが管理画面上で店主に見える形で通知されるのかどうかについても記載がありません。
どのアプリがいつ 2026-10 を使い始めるのかは書かれておらず、公式が支払い済みとして処理する目安として挙げた許容範囲が、金額としていくらを指すのかも書かれていません。
🔴 当編集部は実際の店舗で挙動を確認していません。これらの記載が無いことをもって、日本では変わらないとも、変わるとも書きません。
店が取れる確認の手順
店の側で取れる確認は、大きく三つの段階に分かれます。
はじめに、注文の配送先をアプリや外部システムから変更しているかどうかを確かめる段階があり、人の手で管理画面から直しているだけであれば、この変更が名指ししている二つの経路には当たりません。
次に、アプリや連携を使っている場合には、その提供元に対して現在どのAPIバージョンを使っているのか、そして 2026-10 へいつ上げる予定なのかを問い合わせる段階があり、上げる時期を決めているのはアプリ側なので、ここは店の側では分かりません。
最後に、発送前の注文で住所を変更したあと、その注文の合計金額と支払い済みの額を突き合わせ、不足額や返金すべき額が残っていないかを見る段階があります。
この三段階は本記事が実務の順に並べたものであり、公式がこの手順を示しているわけではありませんので、これを踏めば差額が出ないと言い切れません。
出典
- Shopify developer changelog「Updating an order’s shipping address recalculates taxes as of API version 2026-10」2026年7月30日
https://shopify.dev/changelog/updating-an-orders-shipping-address-returns-accurate-financial-data - Shopify「API versioning」Shopify API release schedule(2026-10 のリリース日)
https://shopify.dev/docs/api/usage/versioning
本記事は上記の公式ドキュメントを一次情報として作成しています。
管理画面から手で住所を変更した場合の挙動、対象の国と地域、日本の消費税の扱い、管理画面上の通知の有無、各アプリが 2026-10 を使い始める時期、そして許容範囲の具体的な金額については、いずれも一次情報に記載がありませんので、未確認として扱い、補っていません。
🔵 提供元にAPIバージョンを問い合わせる進め方と、住所変更後に合計金額を突き合わせる進め方は、キクシル編集部が実務の順に並べたものであって、公式の記載ではありません。

