在庫APIエラーコード廃止：ITEM_NOT_STOCKED_AT_LOCATION削除

8月 04, 2026

API CHANGE

在庫APIエラーコード廃止
ITEM_NOT_STOCKED_AT_LOCATION

2026-10以降、4つの在庫ミューテーションからこのエラーは完全消滅

Shopify Admin APIの2026-10バージョンから、在庫操作ミューテーション4種におけるITEM_NOT_STOCKED_AT_LOCATIONエラーコードが廃止されます。以前の仕様変更によりどのロケーションでも在庫数量を調整できるようになり、このエラーが発生する条件そのものがなくなったためです。該当エラーをハンドリングしているコードは安全に削除できます。

BACKGROUND

01廃止の背景と対象スコープ

もともとITEM_NOT_STOCKED_AT_LOCATIONは、特定ロケーションで取り扱いのない商品に対して在庫調整を行おうとした際に返されるエラーでした。しかし、Shopifyの以前のアップデートにより任意のロケーションで在庫数量を調整できるようになったため、このエラーが発生するシナリオ自体が存在しなくなりました。結果として、エラーコードは「発生しないが定義だけ残っている廃止済みコード」となり、2026-10での正式削除が決定されました。

USE CASES

02業務・開発への影響と活用シーン

課題: 倉庫を複数持つEC事業者が、新規ロケーションに商品を割り当てる前に在庫を先行セットしようとするとエラーが返っていた
打ち手: 2026-10以降はロケーション未登録状態でも在庫調整ミューテーションが通るため、事前のロケーション紐付け手順が不要になる
効果: 倉庫開設・移転時の在庫データ移行フローをシンプル化でき、オペレーションミスを削減
技術メモ: InventoryAdjustQuantitiesで対象locationIdを直接指定するだけでOK。事前チェック処理の削除を検討

課題: 在庫同期アプリがITEM_NOT_STOCKED_AT_LOCATIONを受け取った際に同期をスキップする分岐ロジックを持っており、保守コストが発生していた
打ち手: 該当エラーコードをキャッチするtry/catchやswitch文の分岐を削除し、コードベースをスリム化する
効果: エラーハンドリングのテストケースも削減でき、QAコストの低下と可読性向上を同時に実現
技術メモ: 2026-10未満のAPIバージョンを並行サポートする場合は後方互換のため当面ロジックを残すこと

課題: POSや店舗在庫管理システム連携時に、特定店舗への在庫反映が弾かれるケースがあり、手動リカバリが必要だった
打ち手: エラー発生を前提とした再試行ループや管理者通知処理を廃止し、シンプルな一発投入フローに変更する
効果: POS連携の信頼性向上と、障害対応工数の削減。自動化率を高められる
技術メモ: InventorySetOnHandQuantitiesを使う店舗在庫セット処理が主な対象。移行後は他のエラーコードのハンドリングは引き続き必要

DEVELOPER NOTES