ADMIN API
Admin APIで顧客の税務IDを取得可能に
Customer.taxSettings が 2026-07 より公開APIへ昇格
2026-07 APIバージョンから、Admin GraphQL APIのCustomerオブジェクトにtaxSettingsフィールドが公開されます。read_customersまたはread_taxesスコープを持つアプリは、チェックアウト時に収集・検証された顧客のVAT番号などの税務IDを取得できるようになります。
1変更内容の図解：Before / After
2業務に活かせるユースケース
- 課題
- 越境ECで海外顧客からVAT番号を収集しているが、受注管理システムへの連携が手作業になっており、請求書発行ミスが起きやすい
- 打ち手
-
Customer.taxSettings.taxIdをAPIで取得し、受注データと合わせてERP・会計システムへ自動連携するフローを構築する - 効果
- VATインボイス発行の自動化により、手作業ミスを削減。EU圏顧客への適切な請求書を即時生成できる
- 技術メモ
- 必要スコープは
read_customersまたはread_taxes。APIバージョン 2026-07 以降で利用可能
- 課題
- BtoBとBtoCが混在するストアで、税務IDを持つ法人顧客を識別して税率や請求フローを切り替えたい
- 打ち手
- 顧客一覧を定期的にクエリし、
taxIdが非nullの顧客に「法人タグ」を付与。セグメント別の価格ルールや免税設定を自動適用する - 効果
- 法人顧客の識別精度が向上し、免税処理の漏れや二重課税リスクを低減できる
- 技術メモ
-
taxIdはread-onlyのため書き込みは不可。更新は依然としてチェックアウトフロー経由となる
- 課題
- 税務コンプライアンス監査のため、顧客ごとの税務ID登録状況をレポートしたいが、管理画面からの一括エクスポートが煩雑
- 打ち手
- Admin GraphQL APIのページネーションを使って全顧客の
taxIdを定期バッチ取得し、コンプライアンス用スプレッドシートやDWHへ自動投入する - 効果
- 監査準備工数を削減。税務ID未登録顧客の可視化により、収集率改善施策にも活用できる
- 技術メモ
- 大量取得時はBulk Operations APIの併用を検討。
taxIdValidation（検証ステータス）は公開APIには含まれず、保護顧客データアクセスの承認が別途必要
3技術者向けポイント
| 項目 | 詳細 |
|---|---|
| 利用可能バージョン | Admin GraphQL API 2026-07 以降 |
| 必要スコープ |
read_customers または read_taxes
|
| クエリ例 | { customer(id: "gid://shopify/Customer/xxx") { taxSettings { taxId } } } |
| 戻り値 | 税務IDの文字列、または未入力の場合は null
|
| 読み書き | 読み取り専用（read-only）。書き込みAPIは提供されない |
| 非公開フィールド |
taxIdValidation（検証ステータス）は公開APIに含まれず。利用には保護顧客データアクセスの承認申請が必要 |
| B2B既存APIとの関係 |
CompanyLocation.taxSettings.taxRegistrationId は 2025-01 より引き続き利用可能。今回の変更はB2C顧客への拡張 |
⚠ 注意点
- 2026-07未満のAPIバージョンでは
taxSettingsフィールドはアクセス不可 - 税務IDの書き込み・更新はチェックアウトフロー経由のみ（API経由の更新は記載なし）
-
taxIdValidationが必要なユースケースでは、Shopifyの保護顧客データアクセス審査への申請が別途必要 - 本情報はchangelogに基づく解説です。最新仕様は公式Admin GraphQL APIリファレンスでご確認ください
VAT番号など顧客の税務IDをAdmin APIで直接取得できるようになり、越境EC・B2B対応アプリにおける税務処理の自動化・精度向上が実現します。
Source: https://shopify.dev/changelog/customer-tax-settings-now-available-in-admin-api | 公開日: 2026年4月24日
Share:
totalUnsettledSet の二重計算バグ修正
CSSサブセット化でStorefront高速化