INVENTORY API

発注書読み取りAPIが正式公開
GraphQL 2026-10 対応ガイド

プレビュー不要・新スコープで発注書データへアクセス可能に

Your Appread_inventory_purchase_ordersGraphQL Admin API2026-10 / stablePurchase OrdersinventoryPurchaseOrders

GraphQL Admin API バージョン 2026-10 以降、発注書(Purchase Order)の読み取りが正式公開されました。対象はアプリ開発者で、フィジカルインベントリのプレビュー機能登録なしで利用できます。ただし新スコープ read_inventory_purchase_orders の取得が必須です。

1Before / After — 何が変わったか

BEFORE(〜2026-07)unstable プレビューのみアクセス可フィジカルインベントリ feature preview 要登録read_inventory スコープで代替AFTER(2026-10〜)stable 版で正式公開プレビュー登録・ベータアクセス不要read_inventory_purchase_orders スコープ必須

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つの画面を行き来して管理している
打ち手
transfers connection を使い、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 が必要な場合は残すこと。

🚫 referenceName を使っている場合

InventoryPurchaseOrder.referenceName は 2026-10 公開APIに含まれない。プレビュークエリで選択していた場合は、2026-10 移行前にそのフィールドを削除すること。

📅 リリース候補(RC)期間

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日