B2B / Customer Account API

B2B顧客のロケーションアクセス権が変更
所属ロケーションのみ参照可能に

Customer Account API 全バージョン対象。クエリ変更は不要だが、返却データの範囲が縮小される。

B2B顧客CompanyContact注文履歴個人注文所属ロケーションroles あり → 参照可contacts / taxIdentifier非所属ロケーションroles なし → null / []contacts / taxIdentifier退社後の注文会社注文 → 非表示個人注文 → 表示継続

このアップデートはB2Bアプリ・ストアフロントを開発しているすべての開発者が対象です。2026年11月17日以降、Customer Account APIの全バージョンで、B2B顧客が参照できる会社データと注文の範囲が「自分が所属するもの」のみに絞られます。スキーマ変更はなく、クエリ修正も不要ですが、返却される値がnull・空リスト・件数減少になるケースがあるため、フロントエンドの挙動を事前に確認してください。

1変更内容の図解:Before / After

BEFORE(変更前)AFTER(変更後)CompanyContact.locations他のコンタクト経由でも全ロケーション取得可CompanyContact.locations自分(current customer)のコンタクトのみ返却ロールなしのロケーションtaxIdentifier, contacts,roleAssignments → 値ありロールなしのロケーションtaxIdentifier → nullcontacts / roleAssignments → []退社後の注文アクセスorder(id:) / draftOrder(id:) で元所属会社の注文も取得可退社後の注文アクセス会社注文は拒否(null返却)個人注文は引き続き取得可

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

課題
B2Bストアフロントで、あるコンタクト経由で別コンタクトのロケーション情報(税務IDなど)が参照できてしまうセキュリティ上の懸念があった。
打ち手
今回の変更により、CompanyContact.locations は自分自身のコンタクトのみを返すよう制限された。アプリ側でのフィルタ実装は不要になる。
効果
不要なデータ漏えいリスクを排除しつつ、スキーマ変更なしで既存クエリをそのまま利用できる。セキュリティ要件の説明コストが削減できる。
技術メモ
返却が空リストになる場合に UI 上でエラーとならないよう、フロントエンドで「0件時の表示」を設計しておくことを推奨。
課題
従業員が退職・異動などで会社のコンタクトから削除された後も、その会社向けの注文履歴をAPIから取得できてしまうという業務上のリスクがあった。
打ち手
マーチャントが顧客を会社から削除すると、order(id:)/draftOrder(id:) はその会社の注文を返却拒否し、customer.orders/customer.draftOrders からも会社注文が除外される。
効果
退社済み従業員による注文データへの不正アクセスを防止。個人注文は引き続き表示されるため、顧客体験を損なわずにアクセス制御を実現できる。
技術メモ
注文履歴ページで会社注文のカウントを表示している場合、件数が変動する可能性がある。表示ロジックの確認を推奨。
課題
複数ロケーションを持つ法人顧客が自分にロールのないロケーションのコンタクト一覧や税務情報を誤って参照・編集しようとする操作が発生していた。
打ち手
ロールのないロケーション上の taxIdentifier・contacts・roleAssignments フィールドは null または空リストを返すようになり、表示・操作の対象外となる。
効果
UI側で「表示するデータがない」状態を正しく扱うだけで、過剰な権限表示を防止できる。アプリに追加の権限チェックロジックを実装する必要がなくなる。
技術メモ
Company.locations と companyLocation(id:) は現在の顧客がロールを持つロケーションのみ返す点も合わせて確認すること。

3技術者目線のチェックポイント

確認項目 詳細 対応要否
スキーマ変更 フィールドの追加・削除・型変更はなし。返却値の内容のみ変化する。 対応不要
クエリ変更 既存のGraphQLクエリをそのまま使用可能。書き換えは不要。 対応不要
null / 空リスト対応 ロールなしロケーションの taxIdentifier, contacts, roleAssignments が null または [] になる。フロントエンドの null ガード・空配列ハンドリングを確認する。 要確認
注文履歴の件数変動 退社済みの会社注文が customer.orders / customer.draftOrders から除外される。件数表示やページネーションロジックへの影響を確認する。 要確認
対象APIバージョン Customer Account API の全バージョンが対象。特定バージョンへのピン留めでは回避できない。 注意
purchasingEntity 経由のアクセス 注文の purchasingEntity からロケーションの税・コンタクトデータを読み取っている場合は null が返る可能性あり。該当ロジックを洗い出すこと。 要確認
影響を受けるフィールド一覧
  • CompanyContact.locations → 自分のコンタクトのみ
  • Company.locations → 自分がロールを持つもののみ
  • companyLocation(id:) → 自分がロールを持つもののみ
  • taxIdentifier → null(ロールなし時)
  • contacts → [](ロールなし時)
  • roleAssignments → [](ロールなし時)
  • order(id:) / draftOrder(id:) → 退社後の会社注文は拒否
  • customer.orders / customer.draftOrders → 会社注文を除外
影響を受けないケース
  • 自分がロールを持つロケーションのデータ取得
  • 個人注文(personal orders)の取得
  • 自分自身のコンタクト情報の取得
  • スキーマ定義・クエリ構文
  • 会社データへのアクセス(所属会社のみ)

※ B2Bアプリに関係しないストアフロント実装はこの変更の影響を受けません。

Customer Account APIのB2B顧客データアクセスが「自分が所属・ロールを持つ範囲のみ」に制限されるため、スキーマ・クエリの変更は不要ですが、null/空リスト返却への対応と注文件数変動の影響確認をお早めに行いましょう。

Source: https://shopify.dev/changelog/updated-b2b-location-access-in-the-customer-account-api | 公開日: 2026年11月17日