日付による予約 (V2)

日付による V2 予約では、ノード・レベルおよびネットワーク・レベルでの予約がサポートされ、将来の在庫に対する予約を行うことができます。ネットワーク・レベルの V2 予約では、ノードに対して予約が確実に予約されるようにするノード優先順位の計算が使用されます。この順序で、ノード優先順位は分配グループ定義で定義されます。

日付によるノードの予約

将来の予約を作成するために、属性 requestedReservationTs を使用して将来の開始日を定義できます。インバウンド PO または preOrder シナリオなど、将来の在庫を保護するためのユース・ケースがある場合、 requestEndTs 属性を予約要求で使用して、在庫状況の検索範囲を制限することができます。 requestEndTs は、予約数量が不十分であると見なされるまでの予約の遅延時間を示すタイム・スタンプです。

注: デフォルトの requestedEndTs は、 requestedReservationTsから 30 日間です。

例: `requestEndTs` を使用した予約

今日の日付を 2022 年 10 月 1 日と見なし、 Node1 の PLATE-EACH-NEW の在庫ピクチャーを以下のようにします。

手持ち数量: 5 qty
2022 年 10 月 5 日に到着する PO-10 数量
2022 年 11 月 10 日から 15 qty に到着する PO

まず、予約要求を満たすために、 requestedReservationTs で有効なサプライが使用されます。これらの供給が全数量に対して十分でない場合は、 requestedEndTs 以前に出荷される供給も考慮されます。この例では、現在日付は 2022 年 10 月 1 日で、 PLATE-EACH-NEW アイテムのノード数量は以下のとおりです。

V2 予約 POST API が、 requestedReservationTs および requestedEndTsをパスせずに、2022 年 10 月 1 日に 12 数量の node1-PLATE-EACH-NEW に対して呼び出された場合、予約は正常に完了しています。 reservationTS は、要求されたすべての数量を満たすことができる最終利用可能日に基づいて決定されます。

{
 "availabilityType" : "SELL",
 "considerSafetyStock" : true,
 "lines" : [ {
          "deliveryMethod" : "SHP",
          "itemId" : "PLATE",
          "lineId" : "1",
          "productClass" : "NEW",
          "quantity" : 12.0,
          "requestedReservationTs" : "2022-10-01T00:00:00.000Z",
          "reservations" : [ {
               "expirationTs" : "2022-10-01T00:15:00.000Z",
               "id" : "4a61f54d-6134-4c1e-bedc-11ac0a19e4c5",
               "quantity" : 12.0,
               "reservationTs" : "2022-10-05T00:00:00.000Z",
               "shipNode" : "node1"
               "totalReservedQuantity" : 12.0,
               "unitOfMeasure" : "EACH"
          } ]
     }
}

同じ供給ピクチャーで、予約 API が呼び出され、2022 年 10 月 2 日が requestedReservationTs 、2022 年 11 月 11 日が requestedEndTs (17 数量) である場合、予約は node1 (17 数量) で行われます。この場合、すべての供給が考慮されます。予約 API の出力は以下のとおりです。

{
 "availabilityType" : "SELL",
 "considerSafetyStock" : true,
 "lines" : [ {
         "deliveryMethod" : "SHP",
         "itemId" : "PLATE",
         "lineId" : "1",
         "productClass" : "NEW",
         "quantity" : 17.0,
         "requestedReservationTs" : "2022-10-02T00:00:00.000Z",
         "reservations" : [ {
               "expirationTs" : "2022-10-02T00:15:00.000Z",
               "id" : "4a61f54d-6134-4c1e-bedc-11ac0a19e4c5",
               "quantity" : 17.0,
               "reservationTs" : "2022-11-10T00:00:00.000Z",
               "shipNode" : "node1"
               } ],
       "shipNode" : "node1"
       "totalReservedQuantity" : 17.0,
       "unitOfMeasure" : "EACH"
       } ]
}

予約明細の制限

項目ノードまたは分配グループの明細要求の数が、API 呼び出しごとに最大 500 行に制限されていることを確認してください。

重要：回線制限は2024年8月から実施される。予約APIを呼び出す際には、回線リクエスト数に注意すること。

日付別分配グループ予約

分配グループ・レベルの予約は、常にノード優先順位機能を使用して行われます。詳しくは、「予約」トピックを参照してください。さらに、分配グループの予約では、ノード予約セクションで説明されているように、 requestedReservationTs フィールドと requestedEndTs フィールドも使用されます。

ネットワーク内の単一ノードに対して配置された分配グループ予約応答:

{
 "availabilityType" : "SELL",
 "considerSafetyStock" : true,
 "lines" : [ {
       "deliveryMethod" : "SHP",
       "distributionGroup" : "DG1",
       "itemId" : "PLATE",
       "lineId" : "1",
       "productClass" : "CLASS_1",
       "quantity" : 5.0,
       "requestedReservationTs" : "2021-07-07T00:00:00.495Z",
       "reservations" : [ {
            "expirationTs" : "IGNORE_VALUE",
            "id" : "IGNORE_VALUE",
            "reservedQuantity" : 5.0,
            "reservationTs" : "2021-07-07T00:00:00.000Z",
            "shipNode" : "store-BostonMA"
            } ],
        "segment" : " ",
        "segmentType" : " ",
        "totalReservedQuantity" : 5.0,
        "unitOfMeasure" : "EACH"
        } ]
}

複数のノードでの予約の予約に対する分配グループの予約応答:

{
  "availabilityType" : "SELL",
  "considerSafetyStock" : true,
  "lines" : [ {
       "deliveryMethod" : "SHP",
       "distributionGroup" : "DG1",
       "itemId" : "PLATE",
       "lineId" : "1",
       "productClass" : "CLASS_1",
       "quantity" : 25.0,
       "requestedReservationTs" : "2021-07-07T00:00:00.864Z",
       "reservations" : [ {
             "expirationTs" : "2021-07-07T00:16:00.000Z",
             "id" : "IGNORE_VALUE",
             "reservedQuantity" : 10.0,
             "reservationTs" : "2021-07-07T00:00:00.000Z",
             "shipNode" : "store-BostonMA"
             }, {
             "expirationTs" : "2021-07-07T00:16:00.000Z",
             "id" : "IGNORE_VALUE",
             "reservedQuantity" : 10.0,
             "reservationTs" : "2021-07-07T00:00:00.000Z",
             "shipNode" : "store-SacramentoCA"
             }, {
             "expirationTs" : "2021-07-07T00:16:00.000Z",
             "id" : "IGNORE_VALUE",
             "reservedQuantity" : 5.0,
             "reservationTs" : "2021-07-07T00:00:00.000Z",
             "shipNode" : "store-SpringfieldIL"
              } ],
       "segment" : " ",
       "segmentType" : " ",
       "totalReservedQuantity" : 25.0,
       "unitOfMeasure" : "EACH"
       } ]
}

ネットワーク可用性とノード可用性が異なる場合の分配グループの予約

安全在庫ルールの設定の違いが原因で、ネットワークの可用性とノードの可用性の収集が一致しない場合があります。ネットワーク・レベルの安全在庫が 2 qty であると想定します。

以下のセットアップがあるとします。

Node1 -3 数量
Node2 -2 数量
DG1 = [Node1, Node2] = 3 + 2 = 5 数量が合計使用可能

DG1 の安全在庫が 2 の場合、 DG1 の合計可用性は 5-2 = 3 数量です。

DG1 に対して 5 数量の予約が行われると、予約は 3 数量の部分予約になります。これは、ノード・レベルでの可用性に関係なく、2 つの数量がネットワーク・レベルで保留されるためです。代わりに安全在庫が Node2 に設定されている場合、合計予約数量は 3 のままになりますが、ネットワークではなくノードによって考慮事項が制限されている点が異なります。