ステータス一覧リファレンス

ガラスバリで商品に付与されるすべてのステータスを一覧で説明します。

ステータスの全体構造

ガラスバリでは、商品の状態を 3つの層 で管理しています。

名称決定方法説明
1 item_status(商品ステータス) 自動判定 + ユーザーアクション 商品の「今の状態」を表す。Amazonのデータから自動判定されるか、ユーザーが手動でアクションを設定する
2 finalized_status(完了ステータス) item_statusから自動計算 商品が「まだ管理が必要か」「もう完了か」を判定する
3 資金マップ分類 item_status + finalized_statusから自動計算 ダッシュボードの資金マップに表示するカテゴリ
ステータスの関係図
┌──────────────────────────────────────────────────────┐
│  Amazonデータ                                        │
│  (在庫・注文・返品・返金・返送・Listing)            │
└──────────────────┬───────────────────────────────────┘
                   │ 自動判定
                   ▼
┌──────────────────────────────────────────────────────┐
│  item_status(商品ステータス)                        │
│  ┌────────────────────────────────────────────┐      │
│  │ 自動判定ステータス(約25種)               │      │
│  │ 出品中、在庫切れ、売り切れ、返品、返金…    │      │
│  └────────────────────────────────────────────┘      │
│  ┌────────────────────────────────────────────┐      │
│  │ ユーザーアクション(10種)  ← 手動設定    │      │
│  │ 検品、再出品、販売:他ch、終了…             │      │
│  └────────────────────────────────────────────┘      │
│  ┌────────────────────────────────────────────┐      │
│  │ ワークフローステータス(4種)  ← 自動     │      │
│  │ 入荷済み、写真撮影済み、FNSKU取得済み…     │      │
│  └────────────────────────────────────────────┘      │
└──────────────────┬───────────────────────────────────┘
                   │ 自動計算
                   ▼
┌──────────────────────────────────────────────────────┐
│  finalized_status(完了ステータス)                   │
│  PENDING / FINALIZED / CANCEL_PURCHASE / …           │
└──────────────────┬───────────────────────────────────┘
                   │ 自動分類
                   ▼
┌──────────────────────────────────────────────────────┐
│  資金マップ分類                                      │
│  仕入合計 / FBA販売中 / 未処理 / 処理済 / …         │
└──────────────────────────────────────────────────────┘

item_status(商品ステータス)

商品の「今の状態」を表すステータスです。Amazonから取得したデータ(SP-API)で自動的に判定・更新されます。一部のステータスはユーザーが手動で設定できますが、その後もSP-APIの情報が来れば自動更新の対象になります。

在庫・出品系

ステータス意味finalized_status資金マップ
出品中FBA倉庫で販売可能な状態PENDINGFBA販売中
出品_自己発自己発送で販売可能な状態PENDINGFBA販売中
出品停止中Amazonで出品が停止されているPENDING未処理
リスト停止中リスティングが停止中PENDING未処理
在庫切れFBA倉庫に在庫がない(注文なし)PENDING未処理
売り切れ注文が入って在庫がなくなったFINALIZED処理済
販売不可販売不可在庫として保管中PENDING未処理
予約中予約注文または出荷準備中PENDINGFBA販売中
登録なしAmazonにデータがないPENDING未処理
その他上記に該当しない状態PENDING未処理

注文系

ステータス意味finalized_status資金マップ
注文購入者の注文が入ったPENDINGFBA販売中
出荷準備中出荷準備が進行中PENDINGFBA販売中

返品・返金系

ステータス意味finalized_status資金マップ
返品購入者から返品されたPENDING未処理
返品:品無返品されたが商品が見つからないPENDING未処理
返金Amazonから全額返金(補填)が行われたREFUND_ALL処理済
部分返金部分的に返金された(在庫あり)PENDING未処理

返送系

ステータス意味finalized_status資金マップ
返送:依頼FBA倉庫から返送を依頼したPENDING未処理
返送:注文返送注文が確定したPENDING未処理
返送:発送FBA倉庫から発送されたPENDING未処理
返送:完了返送が完了し手元に届いたPENDING未処理

納品ワークフロー系

仕入れからFBA納品までの工程を追跡するステータスです。

ステータス意味判定基準finalized_status資金マップ
登録SKUが登録された初期状態SKU登録時PENDING未処理
入荷済み商品が手元に届いたreceived_at が設定PENDING未処理
写真撮影済み商品写真を撮影完了photo_url / product_image が存在PENDING未処理
FNSKU取得済みFNSKUを取得済みfba_fnsku が設定PENDING未処理
FBA納品完了FBAへの納品処理が完了選んだやつリストで納品実行PENDINGFBA納品中
納品:検品中FBA倉庫で検品中FBA在庫データPENDINGFBA納品中
納品:輸送中FBA倉庫へ輸送中FBA在庫データPENDINGFBA納品中
納品:受領中FBA倉庫で受領処理中FBA在庫データPENDINGFBA納品中
納品:発送FBA向けに発送した発送処理実行時PENDINGFBA納品中

その他

ステータス意味finalized_status資金マップ
調査中Amazon側で調査が進行中PENDING未処理
処分中FBA倉庫で処分手続き中PENDING未処理
再出品中再出品処理の途中PENDING未処理
在庫なし:PENDING在庫がなくPENDING状態PENDING未処理
その他:PENDING分類不能なPENDING状態PENDING未処理

ユーザーアクション

ユーザーが 商品詳細画面 [PD]PD-B04「ユーザーアクション」 から手動で設定できるステータスです。設定後もSP-APIの情報更新で自動的に切り替わるものがあります(意図系)。

確定系(終了状態)

商品がもう手元にない、または管理を終了した状態です。FBA在庫やListing状態が変わっても 自動で上書きされません

ステータス用途finalized_status資金マップ
仕入:中止仕入れを取りやめた(重複SKU、仕入失敗など)CANCEL_PURCHASE仕入キャンセル
在庫切れ:他Amazon以外のチャネルで売れたMANUAL_SOLD処理済
売切:自己発自己発送で売れたMANUAL_SOLD処理済
補填完了Amazonからの補填返金が完了REFUND_ALL処理済
終了廃棄、その他理由で管理終了(コメントに詳細記載)DISCARDED処理済

意図系(予定・準備中)

作業予定や準備中の状態です。実際にFBA在庫になると 自動的に「出品中」に切り替わります(意図 → 実現)。

ステータス用途finalized_status資金マップ
検品返品後の修理中、動作確認中、自分使用含むPENDING未処理
再出品返品後の再出品、付属品状態をコメント記載PENDING再出品予定
販売:他chメルカリ・ヤフオクなど他チャネルに出品予定PENDING他チャネル予定
販売中:他ch他チャネルで出品中、価格調整が必要PENDING他チャネル販売中
販売中:自己発自己発送で販売中PENDINGFBA販売中

確定系と意図系の違い

確定系意図系
状態商品がもうない・終了した予定・準備中
FBA在庫による上書きされない(保護される)される(実現したら自動切替)
finalized_statusPENDING以外(完了扱い)PENDING(管理続行)
他chで売れた → 「在庫切れ:他」のまま維持「再出品」設定 → FBA在庫になったら「出品中」に自動変更

判定アルゴリズム

item_statusは以下の 8段階のアルゴリズム で決定されます。後の段階ほど優先度が高く、前の段階の結果を上書きする可能性があります。

判定の詳細(開発者向け)
段階処理説明
0初期値設定TimeBasedData(時系列イベント)から最新イベントのステータスを取得
1注文-返品ペアリング注文と返品/返金をamazon_order_idで突合。ペアにならない注文を「未完結注文」として特定
2REFUND判定注文IDのない返金(倉庫紛失等)を検出し、在庫量で全額/部分返金を判定
3OUT_OF_STOCK判定在庫切れが「注文による売り切れ(SOLD_OUT)」か「単なる在庫なし」かを区別
4RESERVED判定注文番号のパターンで「正式注文」か「返送注文」かを区別
5UNSELLABLE判定販売不可の詳細ステータス(返送依頼、返金、返品)を特定
6同一注文ID連動同一注文IDの複数イベントを最新に連動(例: 返送依頼→返送発送)
7FBA在庫優先FBA在庫が販売可能なら強制「出品中」(確定系UAは保護)
8ListingStatus優先Amazonで購入可能なら強制「出品中」(確定系UA・自己発送UAは保護)

ポイント: ユーザーアクションの確定系ステータス(仕入:中止、在庫切れ:他、売切:自己発、補填完了、終了)は段階7・8で上書きされません。意図系(検品、再出品など)はFBA在庫が確認されると自動的に「出品中」に切り替わります。

finalized_status(完了ステータス)

商品が「まだ管理が必要か」「もう完了か」を示すステータスです。item_statusから自動的に計算されます。

finalized_status意味管理状態対応するitem_status(代表例)
PENDING 処理中・管理が必要 アクティブ 出品中、在庫切れ、返品、検品、再出品 など(大多数のステータス)
FINALIZED FBAで売り切れ完了 完了 売り切れ
FINAL_CANDIDATE 完了候補(猶予期間中) ほぼ完了 売り切れ(直後の猶予期間)
CANCEL_PURCHASE 仕入キャンセル 完了(除外) 仕入:中止(UA)
REFUND_ALL 全額返金・補填完了 完了 返金、補填完了(UA)
MANUAL_SOLD FBA以外で販売済み 完了 在庫切れ:他(UA)、売切:自己発(UA)
DISCARDED 廃棄・終了 完了 終了(UA)

資金マップ分類

資金マップ [FM]ダッシュボード [DB] で使われる分類です。item_statusとfinalized_statusの組み合わせで自動的に分類されます。

分類意味条件
仕入合計 仕入キャンセルを除く全商品 finalized_status ≠ CANCEL_PURCHASE
FBA販売中 FBA/自己発送で販売可能な商品 PENDING かつ item_status = 出品中/出品_自己発/注文
他チャネル販売中 他チャネルで販売中の商品 PENDING かつ item_status = 販売中:他ch
FBA納品中 FBA倉庫への納品途中 PENDING かつ item_status = 予約中/納品:検品中/納品:輸送中/納品:受領中
再出品予定 再出品を予定している商品 item_status = 再出品
他チャネル予定 他チャネルへの出品を予定 item_status = 販売:他ch
未処理 上記以外でまだ完了していない商品 PENDING かつ販売中/納品中に該当しない
処理済 管理が完了した商品 finalized_status = FINALIZED/REFUND_ALL/MANUAL_SOLD/DISCARDED
FBA販売済 FBAで売れた商品 finalized_status = FINALIZED
仕入キャンセル 仕入を取りやめた商品 finalized_status = CANCEL_PURCHASE

関連ページ