日付別の在庫状況

「日付別の在庫状況」機能は、期間ごとに分離された在庫状況数量を提供します。各期間は、予約、需要、および供給の時間枠を含む、異なる考慮事項の副産物です。

ノードの可用性 (日付別)

在庫がノードで更新されると、 Inventory Visibility は常に在庫状況ピクチャーを公開します。日付別の在庫状況では、在庫タイム・スタンプを使用して日付範囲が計算されます。在庫のタイムスタンプには、新しい在庫が利用可能になった日時 (supplies.eta) や、在庫の有効期限が切れた日時 (supplies.shipByDate) が含まれます。詳細については、「日付によるノードの可用性の取得」 V2 を参照してください。

例えば、現在日付が 2022 年 10 月 1 日で、2022 年 10 月 10 日に 10 個の ONHAND と 20 個の PO が予約なしで到着しているとします。次に、ノード可用性は以下の情報を返します。出力はと futureAvailability で currentAvailability 区切られ、 fromTs それぞれに対応するタイムスタンプ（開始タイムスタンプを含む）および toTs （終了タイムスタンプを含まない）が付与されます。要求内で requestedEndTs を渡すと、この日付の fromTs 以前の日付によるノードの可用性が返され、応答内の日付によるそのような最後のノードの可用性の toTs は、 requestedEndTs以下になります。要求で requestedEndTs を渡さない場合、デフォルトでは、 dateBreakups.defaultLimitInDays テナント・ルールに設定された値として requestedEndTs が考慮されます。 requestedEndTs の初期値は、 to15 日に設定されます。つまり、 requestedEndTs のデフォルト値は、応答 toTs: 2022-10-15T16:42:06.942Zに示されているように current date + 15 days です。要求入力で requestedEndTs 値を明示的に渡すことにより、デフォルト値を一時的にオーバーライドできます。

注: 可能な場合は、 requestedEndTs の値を 30 日未満にしてください。業務上の要件が許すのであれば、API Availability によって算出される在庫数はリクエストの終了時刻に比例することを考慮してください。 requestedEndTsの期間を長く設定すると、応答時間に影響が出る可能性があります。

同様に、要求で requestedQuantity を渡して、数量に基づいて応答を制限することができます。

{
    "availabilityType": "SELL",
    "considerFulfillmentOptions": false, 
    "considerSafetyStock": true,
    "lines": [
        {
            "itemId": "PLATE",
            "unitOfMeasure": "EACH",
            "productClass": "NEW",
            "deliveryMethod": "SHP",
            "segment": "ONLINE",
            "segmentType": "Channel",
            "shipNodes": [
                "Matrix-Store-001"
            ],
            "lineId": "1",
            "shipNodeAvailabilities": [
                {
                    "shipNode": "Matrix-Store-001",
                    "currentAvailability": {
                        "toTs": "2022-10-10T00:00:00.000Z",
                        "availableQuantity": 10.0,
                        "shortageQuantity": 0.0,
                        "thresholdLevel": 0,
                        "thresholdType": "ONHAND"
                    },
                    "futureAvailability": [
                        {
                            "toTs": "2022-10-15T16:42:06.942Z",
                            "availableQuantity": 30.0,
                            "shortageQuantity": 0.0,
                            "fromTs": "2022-10-10T00:00:00.000Z"
                        }
                    ]
                }
            ]
        }
    ]
}

ここで、以下の予約が成功したとします。

表 1. すべての予約が成功した場合の予約名、数量、時刻、および有効期限
予約	予約数量	予約時間 (rsrv_ts)	有効期限 (exp_ts)
A	1	`2022-10-01T13:10:00Z`	`2020-10-01T13:26:00Z`
B	2	`2022-10-01T13:10:00Z`	`2020-10-01T13:26:00Z`
C	3	`2022-10-01T13:10:00Z`	`2020-10-01T13:26:00Z`
D	4	`2022-10-12T13:10:00Z`	`2020-10-12T13:26:00Z`

予約名、数量、時刻、および有効期限が正常に完了すると、ノードの可用性は以下の情報を返します。

{
    "availabilityType": "SELL",
    "considerSafetyStock": true,
    "lines": [
        {
            "itemId": "PLATE",
            "unitOfMeasure": "EACH",
            "productClass": "NEW",
            "deliveryMethod": "SHP",
            "segment": "ONLINE",
            "segmentType": "Channel",
            "shipNodes": [
                "Matrix-Store-001"
            ],
            "lineId": "1",
            "shipNodeAvailabilities": [
                {
                    "shipNode": "Matrix-Store-001",
                    "currentAvailability": {
                        "toTs": "2022-10-10T00:00:00.000Z",
                        "availableQuantity": 4.0,
                        "shortageQuantity": 0.0,
                        "thresholdLevel": 0,
                        "thresholdType": "ONHAND"
                    },
                    "futureAvailability": [
                        {
                            "toTs": "2022-10-15T17:48:39.490Z",
                            "availableQuantity": 20.0,
                            "shortageQuantity": 0.0,
                            "fromTs": "2022-10-10T00:00:00.000Z"
                        }
                    ]
                }
            ]
        }
    ]
}

2022 年 10 月 1 日の予約 A、B、および C は、現在の可用性と将来の可用性の両方に影響します。 2022 年 10 月 12 日の予約 D は、将来の可用性にのみ影響します。

currentAvailability = 4 (手持ち 10-予約 A から 1-2-予約 B から 3-予約 C から 3)
futureAvailability = 20 (現在使用可能な 4 + 購入オーダーから 20 + 予約 D から 4)

ここで、10 個の ONHAND と 20 個の PO が予約なしで 10 月 10 日に到着したが、10 月 8 日まではノードでフルフィルメントがオフになっているという同じ例を考えてみましょう。有効期限が設定されているノード・フルフィルメント・オーバーライドも、日付によるノードの可用性に影響を与えます。この例では、フルフィルメント・オーバーライドの有効期限が 10 月 8 日に切れると、ノードの在庫状況は将来の在庫状況のみを返します。可用性 API は、可用性がない将来のノードの可用性を日付別に返しません。

"shipNodeAvailabilities": [ {
   "shipNode": "Matrix-Store-001",
   "currentAvailability": {
   "toTs": "2022-10-08T00:00:00.000Z",
   "availableQuantity": 0.0,
   "shortageQuantity": 0.0,
   "thresholdLevel": 0,
   "thresholdType": "FUTURE"
   },
   "futureAvailability": [ {
      "toTs": "2022-10-10T00:00:00.000Z",
      "availableQuantity": 10.0,
      "shortageQuantity": 0.0,
      "fromTs": "2022-10-08T00:00:01.000Z"
      },
      {
          "toTs": "2022-10-15T20:07:45.812Z",
          "availableQuantity": 30.0,
          "shortageQuantity": 0.0,
          "fromTs": "2022-10-10T00:00:00.000Z"
      }
    ]
  }
]

注:

APIコールでconsiderSafetyStockを指定すると、設定された安全在庫がavailableQuantityから差し引かれる。例えば、安全在庫が1の場合、出力はavailableQuantity=29に変わる。
APIコールでconsiderFulfillmentOptionsを trueとして指定した場合、指定されたフルフィルメントオプションはノードとアイテムコールでオーバーライドされる。 considerFulfillmentOptions False の場合、フルフィルメント・オーバーライドは考慮されずに可用性が計算されます。
For more information, see Get Node Availability by Date V2 API.
By default, the value of considerFulfillmentOptions as 真の.

V2 ノードおよびネットワーク可用性 API には、 isAggregationNeeded と呼ばれる要求ヘッダー・レベルの属性があり、デフォルト値は false です。 true に設定すると、この API は、明細レベルに応じて onhandAvailableQuantity、 futureAvailableQuantity、 futureLatestShipTs、および futureEarliestShipTs の各フィールドを返します (これは V1 可用性 API に似ています)。ただし、 isAggregationNeeded API 応答には futureAvailability 配列情報がありません。

パラメータ出力の例を以下に示すisAggregationNeeded

"shipNodeAvailabilities" : [ {
   "currentAvailability" : {
      "availableQuantity" : 20.0,
      "shortageQuantity" : 0.0,
      "thresholdLevel" : 0,
      "thresholdType" : "ONHAND",
      "toTs" : "2021-06-10T00:00:00.182Z"
      },
   "futureAvailableQuantity" : 0.0,
   "futureEarliestShipTs" : "2500-01-01T00:00:00.000Z",
   "futureLatestShipTs" : "2500-01-01T00:00:00.000Z",
   "onhandAvailableQuantity" : 20.0,
   "shipNode" : "store-BostonMA"
   }
]

在庫要求のスループットを最大化するには、アイテム・ノード明細の在庫状況要求が、API 呼び出しごとに最大 100 行に制限されていることを確認します。

重要: 行制限は 2024 年 7 月末に適用されます。

ノードの使用可能なサプライ用品

APIは利用可能な供給状況を提供し、期限切れでない予約も含まれるavailableSupplies availability API と availableSupplies API の唯一の違いは、 availableSupplies が、重複する日付を使用して日付別に可用性を集約しないことです。例えば、現在の日付が 2022 年 12 月 1 日で、PO が 10 の場合、ETA は 2023 年 1 月 1 日、 shipByDate は 2023 年 4 月 1 日です。別の PO が 10 の場合、ETA は 2023 年 2 月 1 日で、 shipByDate は 2023 年 4 月 1 日です。

availableSupplies API エントリーは、以下のとおりです (数量の集約なし)。

"availableSupplies": [ {
   "toTs": "2023-04-01T00:00:01.000Z",
   "availableQuantity": 10.0,
   "shortageQuantity": 0.0,
   "fromTs": "2023-01-01T00:00:00.000Z"
   },
   {
   "toTs": "2023-04-01T00:00:01.000Z",
   "availableQuantity": 10.0,
   "shortageQuantity": 0.0,
   "fromTs": "2023-02-01T00:00:00.000Z"
   }
]

Availability API の出力は以下のとおりです (重複する可用性が追加されています)。

"futureAvailability": [
   {
   "toTs": "2023-02-01T00:00:00.000Z",
   "availableQuantity": 10.0,
   "shortageQuantity": 0.0,
   "fromTs": "2023-01-01T00:00:00.000Z"
   },
   {
   "toTs": "2023-04-01T00:00:00.000Z",
   "availableQuantity": 20.0,
   "shortageQuantity": 0.0,
   "fromTs": "2023-02-01T00:00:00.000Z
   }
]

日付別の分配グループの可用性

ノードの可用性と同様に、分配グループの可用性は、日付範囲による分配グループの可用性も提供します。分配グループの在庫状況ピクチャーは、販売可能な在庫の日付別のすべての関連ノードの在庫状況の集約ビューです。

日付別の分配グループの可用性は、現在および将来のネットワーク・レベルの可用性ピクチャー (アクティブな予約を含む) を提供します。入力された商品またはアイテムの在庫状況が返されます。要求が親製品である場合、その子の可用性も、ネットワーク可用性製品によって日付 API によって返されます。

在庫タイム・スタンプの変更が、日付別の既存の在庫状況以外の日付で新規の供給または需要によって発生すると、日付別の在庫状況が計算され、公開されます。タイム・スタンプ範囲の変更は、新しい供給日または出荷日が決定されたときに発生する可能性があります。分配グループの在庫状況は、オープン・オーダー予約についてのみ計算されます。

例えば、2 つの出荷ノード Matrix-Store-001 と Matrix-Store-002、およびアイテム ID PROD1を持つ分配グループ US_Group があるとします。この例では、1 つの項目を ONHAND として使用できます。また、2 つのアイテムが 2020 年 2 月 7 日に到着し、3 つのアイテムが個々の出荷ノードごとに 2020 年 2 月 14 日 (予約なし) に到着します。したがって、分配グループには、その時刻範囲の各出荷ノードの 2 倍の可用性があります。分配グループの可用性は、以下の情報を返します。出力は、 currentAvailability および futureAvailability と、関連するタイム・スタンプ、 fromTs (開始タイム・スタンプを含む)、および toTs (終了タイム・スタンプを含まない) で区切られていることに注意してください。

{
   "considerSafetyStock": true,
   "considerFulfillmentOptions": false, 
   lines: [ {
      itemId: "PROD1",
      lineId: "0",
      productClass: "NEW",
      unitOfMeasure: "EACH",
      deliveryMethod: "SHP",
      networkAvailabilities: [
      {
         distributionGroupId: "US_Group",
         currentAvailability: {
         availableQuantity: 2.0,
         shortageQuantity: 0.0,
         toTs:"2020-02-07T05:00:00Z”,
         thresholdLevel: 3,
         thresholdType: "ONHAND",
         thresholdQuantity: 5.5,
      },
      futureAvailability: [ {
         fromTs: "2020-02-07T05:00:00Z",
         toTs:"2020-02-14T05:00:00Z",
         availableQuantity: 6.0,
         shortageQuantity: 0.0
      },
      {
         fromTs: "2020-02-14T05:00:00Z",
         toTs:"2500-01-01T00:00:00Z",
         availableQuantity: 12.0,
         shortageQuantity: 0.0
      }
      ]
      }
      ]
    }
  ]
}

次の例のように、2つのノードと1つのアイテムを持つ配布グループの別の例を考えてみましょう：

ノードA - 供給10、需要1、利用可能9、不足0
ノードB - 供給5、需要7、空き0、不足2

この配布グループのネットワーク可用性コールでは、利用可能数量が9、不足数量が2と表示されます。これはノード全体での利用可能数量と不足数量の合計値であるためです。

以下のJSONスニペットを参照してください：

currentAvailability: {
  availableQuantity: 9.0,
  shortageQuantity: 2.0,
  toTs:"2025-12-30T05:00:00Z",
  thresholdLevel: 3,
  thresholdType: "ONHAND",
  thresholdQuantity: 5.5,
}

詳細については、 Network Availability Product by Date REST API ドキュメントを参照してください。