Purchase Order Read API
発注書が「プレビューなし」でアプリから読めるようになった

従来 ： プレビュー限定

unstable のプレビュー経由でしか読めず、ショップを physical inventory のフィーチャープレビューに登録する必要があった。権限は read_inventory で扱っていた。

2026-10 ： 正式公開

API ベータ申請もショップのプレビュー登録も不要。read_inventory_purchase_orders スコープで発注書を読める。読み取り専用。

発注書のミューテーション

今回は読み取り専用のリリース。作成・更新などのミューテーションは含まれない。

referenceName フィールド

InventoryPurchaseOrder.referenceName は公開 2026-10 API に存在しない。プレビューのクエリで選択しているなら、移行前に外す。

2026-07 以前のバージョン

2026-07 以前の API バージョンには、これらの公開クエリは追加されない。

発注書と紐づく在庫移動の両方が必要な Shopify CLI アプリの例。

[access_scopes]
scopes = "read_inventory_purchase_orders,read_inventory_transfers"

先頭 5 件の発注書を、明細と紐づく移動を最大 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 が不要なら、その選択と追加スコープは省く。

1. read_inventory だけでは読めなくなった

プレビュー連携は unstable も含め、read_inventory だけでは発注書を読めない。既存連携を放置すると ACCESS_DENIED になりうるので、read_inventory_purchase_orders を先に取得する。

2. referenceName を消してから移行

InventoryPurchaseOrder.referenceName は公開 API に無い。プレビューのクエリに残っているとスキーマ検証で落ちるので、2026-10 へ切り替える前に外す。

3. transfers は別スコープ

発注書から辿れる InventoryTransfer を読むには read_inventory_transfers も必要。不要なら選択ごと省いて、スコープを最小に保てる。

4. スコープを「リクエスト」しても「付与」されない

設定をデプロイした後、既存インストールでスコープ承認フローを完了させて初めて付与される。currentAppInstallation.accessScopes で付与状況を必ず確認する。

5. バージョンと読み取り専用の前提

使えるのは 2026-10 以降だけ（2026-07 以前には追加されない）。2026年10月1日より前は 2026-10 がリリース候補なので本番では使わない。今回のリリースは読み取り専用でミューテーションは含まれないため、発注書の作成・更新を伴う設計はこの API だけでは組めない。