記事のサマリー（TL;DR）
- Storefront API 2026-07版から新警告コード
PRODUCT_UNAVAILABLE_IN_BUYER_LOCATIONが追加 - 購入者の所在地（Buyer Location）で販売不可の商品を含むカート行ごとに個別の警告が発行される
- 警告の
targetにはカート行ID（Cart Line ID）がセットされ、UI上での該当行の特定が可能
国内 Shopify Plus・越境EC 事業者が対応すべき実装ポイント
Shopify の販売地域制限（マーケット別の商品公開設定）を活用している越境EC・B2B ストアでは、購入者の配送先や請求先が制限地域に合致した場合にこの警告が発生します。2026-07 バージョンへの移行後、カートの warnings フィールドを適切にハンドリングしていないと、購入不可の商品をユーザーがそのままチェックアウトに進めてしまうリスクがあります。日本市場では酒類・医薬品・特定の食品など法規制で販売地域が限定される商品カテゴリも多く、地域制限の実装精度が購入体験と法令遵守の両面で重要です。カスタムストアフロント（Headless Commerce）や Checkout Editor を使った独自フロントエンドを持つ事業者は、警告コードの受け取りと UI へのフィードバック実装を2026-07リリース前に優先度高く確認しておく必要があります。
詳細
新しい警告コード：PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION
Storefront API バージョン 2026-07 以降、カート（Cart）オブジェクトが新しい警告コード PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION を返すようになりました。
この警告は、カート内の商品ラインに 購入者の所在地（Buyer Location）では購入できない商品 が含まれている場合に発行されます。
動作の仕様
- カート行単位での警告：影響を受けるカート行（Cart Line）それぞれに対して、個別の警告が生成されます
- ターゲット指定：各警告の
targetプロパティには該当する Cart Line ID がセットされるため、フロントエンド UI で問題のある行を正確に特定・表示できます
ハンドリング方法
カート警告（Cart Warnings）の一般的な仕組みや実装例については、Shopify 公式ドキュメントの「Cart warnings」を参照してください。既存の警告ハンドリング処理に、新しいコードを追加する形で対応できます。