在庫の不整合に関する報告および是正手順

「在庫整合性ダッシュボード」がネットワークの状態をマクロ的な視点で把握できる一方で、「レポート生成ツール」は、フルフィルメント担当者が対象を絞った整理作業を実行するために必要な、正確かつ実用的なデータセットを提供します。 不一致の原因となっている商品を正確に特定することで、運用チームはマーチャンダイジング計画と照らし合わせて異常を検証し、システムから無効なレコードを自動的に削除することができます。

レポート生成エンジン

このレポートエンジンにより、ユーザーはAPI GET Supply のスキーマに準拠した包括的な CSV データセットを抽出することができます。 これらのレポートには、是正措置に必要な正確な供給識別子が含まれているため、特定と修正の間のギャップをシームレスに埋めることができます。

システムのパフォーマンスを最大限に引き出し、データの最新性を確保するため、レポートアーキテクチャは厳格な技術的要件に基づいて運用されています：
  • ターゲットを絞ったフィルタリング
    ユーザーは、特定のSKUやノードでレポートを絞り込むことができ、カンマ区切りによる一括入力も利用可能です。 運用上のボトルネックを回避するため、完全な同期やレポートの実行は、戦略的に選定したノードのバッチ単位、または特定のSKUカテゴリ単位で行うことを推奨します。
  • ルックバックパラメータ
    レポートの種類に応じて、ユーザーは過去7日、14日、30日、60日、または90日の期間を選択したり、特定の過去の月を指定したりすることができます。
  • 割当とガバナンス
    システムパフォーマンスとレポート作成のバランスを考慮し、テナント環境におけるレポート生成は1日あたり最大25件までと厳格に制限されています。 利用枠のカウントは毎日リセットされます。
  • 鮮度と保存性
    生成されたレポートは、ジョブステータスモニターを通じて追跡されます。 完了後、「 CSV 」アーティファクトはダウンロード可能となりますが、7日間の厳格な保存期間（Time-to-Live）が適用されます。 7日経過すると、ファイルは有効期限が切れ、システムから削除されます。これにより、ユーザーは古いデータによる誤った是正措置を防ぐため、新しいレポートを作成する必要があります。

コア異常報告書

フルフィルメントマネージャーは、特定の在庫管理上の問題を特定するために、以下の対象を絞ったレポートをリクエストできます：
  • 在庫滞留SKUレポート
    選択した遡及期間内に活動がゼロの供給レコードのリストを生成します。 これは、ファントムアイテムと休眠アイテムの両方を特定するためのマスターリストとして機能します。
  • ファントムSKUレポート
    直近の在庫同期リクエストや棚卸し作業で見落とされた、取引履歴のない在庫品を抽出します。 これらは、倉庫に物理的に保管されていない「ゴースト在庫」であり、システムから直ちに削除すべき対象となります。
  • 休眠SKUレポート
    直近の棚卸調査に含まれていたものの、売上や調整の記録がない品目を特定します。 これらは、実在する有効な在庫でありながら売れ行きが鈍いため、販促キャンペーンや値下げ販売が必要であることを示しています。
  • ゾンビSKUレポート
    ルックバック期間内に、数量が正の値となり復活した、以前に削除または利用不可としてマークされていたレコードを表示します。 これは、上流システム（ERPやWMSなど）に重大な障害が発生し、誤った再同期情報が送信されていることを示しています。 問題を解決するには、ループを止めるためにソースの統合状況を調査する必要があります。
  • デッドストックSKUレポート
    365日以上全く動きのない過剰在庫を一覧表示します。 これらの資産は、減損処理や資産の転用が検討される主な対象となります。

ポストシンク検証 - 検証ループ

ポストシンク検証レポートは、一括循環棚卸しまたは全在庫の同期処理の直後に実行される、専門的で時間的制約のあるワークフローです。 その目的は、同期処理の過程で見落とされていたSKUを確実に特定することです。
  • 基準パラメータ
    このレポートを作成する際、管理者は一括同期の正確な日付を入力する必要があります。 たとえば、あるノードが2026年5月10日に完全なサイクルカウントを完了した場合、その日付がベースラインとして設定されます。
  • 実行ウィンドウ
    このシステムでは、リクエストの日付から最大14日間の過去データを確認することができます。 ただし、データのずれを防ぐため、実地棚卸から1～2日以内にこのレポートを実行することを強くお勧めします。
  • 停滞フィルター
    デフォルトでは、このレポートでは「滞留在庫のみに限定する」フラグが有効になっており、問題のある非アクティブなSKUを特定できるようにしています。 ユーザーはこのチェックを外すことで、アクティビティの状態に関係なく、同期されていないすべての項目のリストをそのまま取得できます。
この検証プロセスによって検出された余分なレコードは、現在の販売計画と照らし合わせて確認し、無効と判断された場合は速やかに削除する必要があります。

プログラムによる修復：パージ・ワークフロー

CSV のレポートを通じて、ファントムSKUなどの無効な供給レコードが特定された場合、それらをフルフィルメントネットワークから完全に削除する必要があります。 単に数量をゼロに更新するだけでは不十分です。レコード自体がデータベースに残ったままになるため、将来的に無効な売上が記録されるリスクがあり、顧客体験を損なうだけでなく、フルフィルメントの処理コストも増加する恐れがあります。

PUT https://api.watsoncommerce.ibm.com/inventory/){tenantId}/v1/supplies修正はAPIを PUT Supply Sync 介して実行されます。異常を完全に解消するには、ペイロードに数量「0」と厳格 purgeSupply なディレクティブを組み合わせる必要があります。
必須のペイロードフラグ
  • "quantity": 0
  • "purgeSupply": true
例 - 修復用ペイロード
{
  "supplies": [
  {
     "itemId": "SKU1024",
     "unitOfMeasure": "EACH",
     "productClass": "NEW",
     "type": "ONHAND",
     "shipNode": "Matrix-Store-001",
     "segment": "ONLINE",
     "segmentType": "Channel",
     "inventoryTag": {
        "batchNo": "B1",
        "lotNumber": "L1",
        "revisionNo": "R1"
     },
     "quantity": 0,
     "purgeSupply": true
     }
  ]
}

このペイロードを正確に実行することで、在庫システムから供給記録が削除されます。 この重要な手順により、ファントムSKUが商品詳細ページ（PDP）に表示されることがなく、下流のすべてのイベント配信が倉庫の実際の在庫状況と一致するようになります。