CartWarningに購入者ロケーション制限の警告コードが追加
地域販売制限のある商品をカートに入れた瞬間、APIレベルで検知できるようになりました
Storefront APIのCartWarningオブジェクトに新しい警告コード PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION が追加されました。購入者の地理的な位置（居住国・地域）において販売が制限されている商品がカートに含まれている場合、このコードを通じてAPIレベルで検知できます。2026年5月12日より利用可能です。
1変更内容：Before / After
2業務に活かせる具体ユースケース
- 課題
- 越境ECで日本限定商品を海外バイヤーがカートに入れた際、決済直前までエラーが分からず離脱率が高い
- 打ち手
-
CartWarning.codeがPRODUCT_UNAVAILABLE_IN_BUYER_LOCATIONを返した時点でカートページに警告UIを表示し、代替商品を提案する - 効果
- チェックアウト到達前に問題を可視化でき、購入者の混乱と離脱を防止できる
- 技術メモ
- 記載なし（詳細な実装APIバージョン等は公式ドキュメントを要確認）
- 課題
- マーケットごとに異なる販売可否ルールを持つマルチリージョン運営で、在庫管理システムとの不整合を検知できていない
- 打ち手
- カート更新のたびにCartWarningを監視し、
PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION検出時にバックエンドへ通知して在庫・販売設定を自動レビューするフローを構築する - 効果
- 地域設定ミスを早期発見でき、誤注文受付によるカスタマーサポートコストを削減できる
- 技術メモ
- 記載なし
- 課題
- ヘッドレスコマース構成で独自カートUIを実装しており、Shopifyのネイティブ警告が届かない
- 打ち手
- Storefront APIのcart系ミューテーション（例:
cartLinesAdd）のレスポンスに含まれるcart.warningsフィールドを必ずパースし、コードに応じたメッセージを出し分けるロジックを実装する - 効果
- ヘッドレス環境でもShopifyのビジネスルールと同期した購入者体験を維持できる
- 技術メモ
- 記載なし
3技術者目線のポイント
| 観点 | 内容 |
|---|---|
| 対象オブジェクト |
CartWarning の code フィールドに新しいenum値 PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION が追加された |
| API | Storefront API。具体的な対応バージョンは元記事に記載なし。公式ドキュメントで要確認 |
| 取得場所 | カート操作ミューテーションのレスポンス内 cart.warnings 配列。既存の警告処理フローに追記する形で対応可能 |
| 既存コードへの影響 | 新規追加のみで既存警告コードは変更なし。ただし warnings をswitch/matchで処理している場合はunhandledケースとして落ちないか確認が必要 |
| Liquid / テーマへの影響 | 記載なし。Storefront API（ヘッドレス・カスタムフロント）向けの変更とみられる |
| 移行・対応の優先度 | 既存動作は破壊されないが、地域販売制限を設定しているストアは早期に warnings のハンドリングを実装することを推奨 |
実装チェックリスト（技術者向け）
- cart系ミューテーションのレスポンスで
cart.warnings { code message }をクエリに含めているか確認 -
PRODUCT_UNAVAILABLE_IN_BUYER_LOCATIONを処理するcase分岐を追加 - 購入者向けUIメッセージ（多言語対応を含む）を用意
- 既存のswitch文に
defaultまたはelseブランチが存在するか確認し、想定外コードで例外が発生しないようにする
※ 元記事はタイトルとRSS要約のみの提供のため、詳細な実装例・対応APIバージョン・料金プラン条件等は「記載なし」としています。必ず公式ドキュメントで最新情報を確認してください。
購入者の居住地域で販売できない商品をカートが検知した瞬間にAPIで識別できる新警告コードにより、越境ECおよびマルチリージョン運営でのチェックアウト前離脱防止とサポートコスト削減が期待できます。
Source: https://shopify.dev/changelog/new-productunavailableinbuyerlocation-warning-code-in-the-storefront-api-cart | 公開日: 2026年5月12日
Share:
Shopify App Pricing完全解説：従量課金・定期課金に対応
OrderオブジェクトにcartTokenフィールド追加