Shopify API 2026-10が安定版に　顧客・在庫・割引で破壊的変更

何が発表されたか

Shopify の API バージョン 2026-10 が2026年10月2日に安定版（Stable）となった。リリース候補は10月1日まで開発用の検証に提供されていた。

コード修正が必要になりうる変更は次のとおり。

GraphQL Admin API

• 在庫系ミューテーションから ITEM_NOT_STOCKED_AT_LOCATION エラーが削除
• DraftOrderDiscountNotAppliedWarning から非推奨の priceRule フィールドが削除
• メタフィールドのフィルタクエリが、不正な定義を黙って無視するのではなくエラーを返すようになった
• ProductVariant.barcode が非推奨化。新しい barcodes コネクション（型付きバーコードを最大20件）に置き換え

Customer Account API

• 非推奨の Customer.lastIncompleteCheckout が削除。到達できなくなった Checkout 型の配下も削除
• territoryCode が非推奨化。新しい countryCode フィールドを使う

POS / Polaris

• POS UI 拡張から session.currentSession.staffMemberId が削除

注文・税の挙動

• orderUpdate で配送先住所が変わった際に、税が再計算されるようになった
• OrderCreateFulfillmentInput に trackingNumbers パラメータが追加され、複数梱包のフルフィルメントに対応
• OrderDisplayFulfillmentStatus が FULFILLMENT_NOT_REQUIRED を返しうるようになった

分析系

• アプリが Shopify Analytics のデータを、分析クエリ可能なメタフィールドと App Events API でモデル化し、ShopifyQL API で参照して分析用の Web コンポーネントを埋め込めるようになった

開発者への影響

• 在庫・下書き注文・顧客アカウントまわりを触っているアプリや連携は、フィールド削除の影響を受ける可能性がある。priceRule や lastIncompleteCheckout を参照しているコードは置き換えが必要
• メタフィールドのフィルタがエラーを返す仕様に変わった点は要注意。これまで定義ミスがあっても動いていたクエリが落ちるようになる
• territoryCode → countryCode、barcode → barcodes は非推奨化のため即時停止ではないが、移行計画に入れておきたい
• orderUpdate での税の再計算は、住所変更を伴う受注修正フローを組んでいる場合に金額の挙動が変わりうる。テストで確認したい
• POS 拡張で staffMemberId を使っていた機能は代替手段の検討が必要
• バージョンを上げる前に、Shopify が案内しているとおり既存連携の洗い出しを行うこと