発注書読み取りAPIが正式公開
GraphQL 2026-10 対応ガイド
プレビュー不要・新スコープで発注書データへアクセス可能に
GraphQL Admin API バージョン 2026-10 以降、発注書(Purchase Order)の読み取りが正式公開されました。対象はアプリ開発者で、フィジカルインベントリのプレビュー機能登録なしで利用できます。ただし新スコープ read_inventory_purchase_orders の取得が必須です。
1Before / After — 何が変わったか
2新規公開されたクエリとフィールド
| クエリ / フィールド | 概要 | 追加スコープ |
|---|---|---|
inventoryPurchaseOrder |
IDで発注書1件を取得 | read_inventory_purchase_orders |
inventoryPurchaseOrders |
発注書一覧をページネーションで取得 | read_inventory_purchase_orders |
origin.supplierName |
発注時点のサプライヤー名スナップショット | — |
transfers connection |
紐づく InventoryTransfer オブジェクト一覧 | read_inventory_transfers |
InventoryPurchaseOrder.referenceName |
⚠️ 2026-10 公開APIには含まれない | — |
※ mutations(書き込み)は今回の公開対象外。既存ユーザー権限もそのまま適用されます。
3業務に活かせるユースケース
- 課題
- ERP・在庫管理システムから発注書の進捗をShopify側で確認できず、手動照合が発生している
- 打ち手
-
inventoryPurchaseOrdersクエリで発注書ステータスと明細をポーリング取得し、外部システムへ自動連携するアプリを構築 - 効果
- 手動照合を廃止し、発注から入庫までの進捗をリアルタイムで可視化できる
- 技術メモ
- スコープ
read_inventory_purchase_ordersのみ必要。transfersは不要ならスコープ追加不要
- 課題
- サプライヤーが変更になった過去の発注書でも、発注時の取引先名を正確に記録・表示したい
- 打ち手
-
origin.supplierNameフィールドを取得することで、現在の取引先マスターに依存しない発注時スナップショットを参照 - 効果
- 取引先変更後も過去発注の監査証跡を正確に保持できる
- 技術メモ
- supplierNameはorigin オブジェクト配下。取引先マスターIDとは独立したスナップショット値
- 課題
- 発注書と入庫(Inventory Transfer)の紐づきを確認するために、2つの画面を行き来して管理している
- 打ち手
-
transfersconnection を使い、1クエリで発注書と紐づく InventoryTransfer を同時取得して管理画面に表示 - 効果
- 発注〜入庫のステータスを一画面で確認でき、オペレーション工数を削減
- 技術メモ
- transfersを取得するには
read_inventory_transfersスコープが追加で必要
4技術者向けポイント
① shopify.app.toml に read_inventory_purchase_orders(+必要なら read_inventory_transfers)を追加
② デプロイ後、既存インストール分はスコープ承認フローを完了させる
③ currentAppInstallation.accessScopes で付与済みスコープを確認
read_inventory 単独では 2026-10以降(unstableを含む)発注書読み取りが不可に。read_inventory_purchase_orders を追加取得すること。他の在庫リソース用に read_inventory が必要な場合は残すこと。
InventoryPurchaseOrder.referenceName は 2026-10 公開APIに含まれない。プレビュークエリで選択していた場合は、2026-10 移行前にそのフィールドを削除すること。
2026年10月1日より前に利用する場合、2026-10 は RC(リリース候補)扱い。テスト用途に留め、本番での採用は正式リリース後を推奨。
2026-07 以前のバージョンには今回のパブリッククエリは追加されない。write スコープ(write_inventory_purchase_orders)保有アプリは read も含まれるため、readスコープの重複申請は不要。
① 発注書と紐づくtransferが存在するdevelopment storeを用意
② エンドポイント /admin/api/2026-10/graphql.json に切り替え
③ スキーマ検証エラー・ACCESS_DENIED が出ないことを確認
④ アクセス拒否時はスコープとユーザー権限の両方を確認
5サンプルクエリ
query PurchaseOrders {
inventoryPurchaseOrders(first: 5) {
nodes {
id
name
status
origin {
supplierName
}
lineItems(first: 5) {
nodes {
id
title
}
}
transfers(first: 5) {
nodes {
id
name
}
}
}
}
}
transfersが不要な場合はそのブロックを削除し、read_inventory_transfers スコープも省略可能。各connectionは追加レコード取得のためページネーション対応が必要。
GraphQL Admin API 2026-10 で発注書読み取りが正式公開され、read_inventory_purchase_orders スコープを取得するだけでプレビュー登録なしに発注書・明細・入庫トランスファーへアクセス可能になります。
Source: https://shopify.dev/changelog/purchase-order-read-api | 公開日: 2026年9月17日






Share:
POS UI Extensions セッションAPIの破壊的変更 2026-10