開発者向けの変更です。
Customer Account API で、B2B の購入者が読めるのは、自分が属する会社のデータと注文だけになりました。
購入者が読めるのは自分の会社のデータと注文だけになりました
変更は、Customer Account API の全てのバージョンにかかります。
発表は2026年11月17日の developer changelog です。
出典: Shopify developer changelog「Updated B2B location access in the Customer Account API」2026年11月17日
https://shopify.dev/changelog/posts/updated-b2b-location-access-in-the-customer-account-api
We’ve changed what B2B customers can read on all versions of the Customer Account API. Customers now read only the company data and the orders for companies that they belong to.
(Customer Account API の全てのバージョンで、B2B の購入者が読めるものを変えました。購入者が読めるのは、自分が属する会社の会社データと注文だけになります)
フラグは「Update」。
タグは「Security」と「Customer Account API」です。
スキーマは変わらず返る値が減ります
型やフィールドの形は、今までのままです。
The schema doesn’t change. Some fields now return null, an empty list, or fewer results.
(スキーマは変わりません。一部のフィールドが null、空の一覧、または少ない結果を返すようになります)
変わるのは、返ってくる中身。
null か空の一覧、または今より少ない結果になる場合があります。
他の担当者の拠点の一覧は空になります
CompanyContact.locations は、その担当者が今の購入者本人でない限り、空の一覧を返します。
CompanyContact.locations returns an empty list unless the contact belongs to the current customer. The current customer reads the locations that they have a role in from their contact’s locations field, from Company.locations, and from companyLocation(id:).
(CompanyContact.locations は、その担当者が今の購入者のものでない限り、空の一覧を返します。今の購入者は、自分が役割を持つ拠点を、自分の担当者の locations、Company.locations、companyLocation(id:) から読みます)
今の購入者は、自分に役割のある拠点を、次の3か所から読みます。
- 自分の担当者の
locations Company.locationscompanyLocation(id:)
役割の無い拠点では税番号と連絡先が返りません
今の購入者に役割の無い拠点では、2種類のフィールドが null か空の一覧になります。
On a CompanyLocation where the current customer has no role, the following fields return null or an empty list:
Tax field: taxIdentifier.
Contact fields: contacts and roleAssignments.
(今の購入者が役割を持たない CompanyLocation では、次のフィールドが null か空の一覧を返します。税のフィールド:taxIdentifier。連絡先のフィールド:contacts と roleAssignments)
1つ目は、税のフィールドの taxIdentifier。
2つ目は、連絡先のフィールドの contacts と roleAssignments です。
会社から外れた購入者には、その会社の注文が API で読めません
店が購入者を会社から外すと、Customer Account API では、その会社の注文と下書き注文が、その購入者から読めなくなります。
When a merchant removes a customer from a company, order(id:) and draftOrder(id:) refuse that company’s orders and draft orders. customer.orders and customer.draftOrders exclude the orders and draft orders for that company. The customer’s personal orders are still listed.
(店が購入者を会社から外すと、order(id:) と draftOrder(id:) はその会社の注文と下書き注文を拒みます。customer.orders と customer.draftOrders は、その会社の注文と下書き注文を含めません。購入者の個人の注文は、引き続き一覧に出ます)
order(id:)とdraftOrder(id:)は、その会社の注文と下書き注文を拒みますcustomer.ordersとcustomer.draftOrdersの一覧からも、その会社の分が外れます- 個人として買った注文は、今までどおり一覧に残ります
クエリの変更は要りません
公式は、アプリのクエリを変える必要はないと書いています。
If your app reads a location’s tax or contact data through another contact’s locations or through an order’s purchasingEntity, then expect null or an empty list for locations where the customer has no role. If your app shows a customer’s order history, then the history omits the orders that the customer placed for a company that they no longer belong to. You don’t need to change your queries.
(アプリが、他の担当者の locations や注文の purchasingEntity を通じて拠点の税や連絡先のデータを読んでいるなら、購入者に役割の無い拠点では null か空の一覧になると見込んでください。アプリが購入者の注文履歴を出しているなら、その履歴から、もう属していない会社のために購入者が出した注文が抜けます。クエリを変える必要はありません)
影響があるのは、2つの読み方。
- 他の担当者の
locationsや注文のpurchasingEntityを通じて、拠点の税や連絡先を読むアプリ - 購入者の注文履歴を出すアプリ
🔴 公式に書かれていないこと
次の点は、一次ソースにありません。
- 変更がいつから効いているかの日時は書かれていません。原文は「We’ve changed」と過去の形で書きます
- 店の管理画面や B2B の購入者の画面の見え方が変わるかは書かれていません。対象として書かれているのは API です
- 会社から外したあとに戻した購入者の注文の扱いは書かれていません
- Admin API や Storefront API に同じ変更があるかは書かれていません。この発表は Customer Account API だけの話です
- 🔴 本記事は API を呼んで試していません。記載が無いことをもって「できる」とも「できない」とも書きません
開発者と店がやることを整理します
開発者がやることは次の3つです。
- 他の担当者の
locationsやpurchasingEntityから拠点の税や連絡先を読む処理で、null と空の一覧を受け止められるかを見る - 注文履歴を出す画面で、会社から外れた購入者の会社の注文が抜ける前提にそろえる
- クエリ自体は変えずに、返る値の変化だけを見る
店がやることは次の1つです。
- B2B で購入者を会社から外したら、Customer Account API では、その購入者からその会社の注文と下書き注文が読めなくなると知っておく
🔵 上の手順はキクシル編集部の整理で、公式の記載ではありません。
出典
- Shopify developer changelog「Updated B2B location access in the Customer Account API」2026年11月17日
https://shopify.dev/changelog/posts/updated-b2b-location-access-in-the-customer-account-api
上記の Shopify 公式の情報だけを一次情報として使っています。

