主な違いV1そしてV2 APIとイベントInventory service

主な違いを学ぶV1そしてV2 APIとイベントInventory service。

注意:

V1のアベイラビリティと予約APIは2025年2月末にサポート終了予定。可用性と予約APIのV11からV2への移行を完了し、最新の機能を継続的に使用、活用する。詳細については、「Inventory serviceV2APIおよびイベントへのアップグレード」を参照してください。

API

V1 可用性 API では、 supplyTypeに基づいて、使用可能な数量が onhand または将来のフィールドに配置されます。 V2では、これは完全に供給の ETA に基づいています。供給の ETA が将来のものである場合は、将来の利用可能性が考慮されます。それ以外の場合は、応答の現在の可用性ウィンドウが考慮されます。
V2 可用性要求は、 V1にない新規フィールド requestedEndTs および requestedQuantity をサポートします。詳しくは、ノード可用性要求を参照してください。
V1 ネットワーク API を使用すると、ユーザーは行レベルで distributionGroupId 属性をオーバーライドできます。これにより、単一の呼び出しで複数の分配グループの可用性を取り出すことができます。 V2 ネットワーク API では、これは許可されません。複数の配布グループで可用性を得る必要がある場合は、一度に 1 つの配布グループを渡すことによって別個の API 呼び出しを行うことをお勧めします。詳しくは、ネットワーク要求を参照してください。
V2 日付要求による予約では、 V1でサポートされていない requestedReservationTs フィールドおよび requestedEndTs フィールドがサポートされています。詳しくは、日付による予約の要求を参照してください。
V2 可用性モードを使用している場合、 V2 分配グループ予約は常に、ノード優先順位機能を使用してノードに配置されます。 V1 可用性モードでは、ノード優先順位の有無にかかわらず、分配グループ・レベルの予約を選択できます。ノード優先順位について詳しくは、予約を参照してください。

V2APIの詳細については、V2availability APIsを参照。

イベント

V1からV2への移行中、可用性がゼロのインベントリは移植されないため、スナップショット・イベントに表示されません。もし、あなたのシステムが継続的にこれらの項目の可用性ゼロを公表する必要がある場合、移行後に供給を同期させる必要があります。
V1イベントでは、ブランク属性の値は空文字列としてパブリッシュされます。 V2では、それらはnullとして公表される。
注： V2 のイベントは、 V2 のAPIと同様のフォーマットで利用可能状況を表示します。

V2 イベントの詳細については、「新しいイベント形式」をご覧ください。

ノード可用性要求

V1 ノード可用性要求

https://api.watsoncommerce.ibm.com/inventory/{tenantId}/v1/availability/node
{
    "demandType": "OPEN_ORDER",
    "lines": [
        {
            "lineId": "1",
            "itemId": "PLATE",
            "unitOfMeasure": "EACH",
            "productClass": "NEW",
            "deliveryMethod": "PICK",
            "segment": "ONLINE",
            "segmentType": "Channel",
            "shipNodes": [
                "Matrix-Store-001"
            ]
        }
    ]
}

V2 ノード可用性要求

https://api.watsoncommerce.ibm.com/inventory/{tenantId}/v2/availability/node?bundleAggregatesAcrossNodes={bundleAggregatesAcrossNodes}
{
    "availabilityType": "SELL",
    "lines": [
        {
            "lineId": "1",
            "itemId": "ITEM",
            "unitOfMeasure": "EACH",
            "productClass": "NEW",
            "deliveryMethod": "PICK",
            "segment": "ONLINE",
            "segmentType": "Channel",
            "requestedEndTs": "2020-03-02T00:00:00Z",
            "requestedQuantity": "10",
            "shipNodes": [
                "Matrix-Store-001"
            ]
        }
    ]
}

ノード可用性応答

V1 応答には、 onhandAvailableQuantity と futureAvailableQuantity で示される可用性があります。これらは、 supplyTypesに基づいて集約された数量です。 V2 応答は、任意の時点での正しい可用性を知るために、時間ウィンドウとともに可用性を示します。 currentAvailbility は、現在または過去の ETA の供給から派生します。 futureAvailability は、将来の ETA を備えた供給から派生し、日付の内訳とともに表示されます。供給が複数の時間枠内で有効である場合は、それらすべての可用性時間枠で考慮されます。

詳しくは、ノードの可用性 (日付別)を参照してください。

V1 ノード可用性応答

{
    "lines": [
        {
            "lineId": "1",
            "shipNodeAvailability": [
                {
                    "deliveryMethod": "PICK",
                    "onhandAvailableQuantity": 10.0,
                    "futureAvailableQuantity": 20.0,
                    "onhandEarliestShipTs": "2022-10-11T21:28:03.226Z",
                    "onhandLatestShipTs": "2022-10-11T21:28:03.226Z",
                    "futureEarliestShipTs": "2022-10-11T21:28:03.226Z",
                    "futureLatestShipTs": "2022-10-11T21:28:03.226Z",
                    "earliestShipTs": "2022-10-11T21:28:03.226Z",
                    "latestShipTs": "2022-10-11T21:28:03.226Z",
                    "thresholdLevel": "0",
                    "thresholdType": "ONHAND",
                    "shipNode": "Matrix-Store-001",
                    "totalAvailableQuantity": 30.0
                }
            ]
        }
    ]
}

V2 ノード可用性応答

{
    "availabilityType": "SELL",
    "considerSafetyStock": true,
    "lines": [
        {
     "deliveryMethod": "PICK",
            "itemId": "ITEM",
            "unitOfMeasure": "EACH",
            "productClass": "NEW",
            "segment": "ONLINE",
            "segmentType": "Channel",
            "shipNodes": [
                "Matrix-Store-001"
            ],
            "lineId": "1",
            "shipNodeAvailabilities": [
                {
                    "shipNode": "Matrix-Store-001",
                    "currentAvailability": {
                        "toTs": "2022-10-20T00:00:00.000Z",
                        "availableQuantity": 10.0,
                        "shortageQuantity": 0.0,
                        "thresholdLevel": 0,
                        "thresholdType": "ONHAND"
                    },
                    "futureAvailability": [
                        {
                            "toTs": "2022-10-26T21:53:41.967Z",
                            "availableQuantity": 30.0,
                            "shortageQuantity": 0.0,
                            "fromTs": "2022-10-20T00:00:00.000Z"
                        }
                    ]
                }
            ]
        }
    ]
}

ネットワーク要求

V1 ネットワーク要求

{
    "distributionGroupId": "DG-1",
    "segment": "ONLINE",
    "segmentType": "Channel",
    "considerSafetyStock": false
    "lines": [
        {
            "lineId": "1",
            "itemId": "PLATE",
            "unitOfMeasure": "EACH",
            "productClass": "NEW",
            "deliveryMethod": "SHP",
            "segment": "ONLINE",
            "segmentType": "Channel”,
	    "distributionGroupId": "DG-1",
        }
    ]
}

V2 ネットワーク要求

{
    "distributionGroupId": "DG-1",
    "segment": "ONLINE",
    "segmentType": "Channel",
     "considerSafetyStock": false,
    "lines": [
        {
            "lineId": "1",
            "itemId": "ITEM",
            "unitOfMeasure": "EACH",
            "productClass": "NEW",
            "requestedEndTs": "2020-03-02T00:00:00Z",
            "requestedQuantity": "10",
            "deliveryMethod": "SHP",
            "segment": "ONLINE",
            "segmentType": "Channel”
        }
    ]
}

ネットワーク応答

ノード応答と同様です。

詳しくは、「Distribution group availability by date」を参照してください。

V1 ネットワーク応答

{
    "lines": [
        {
            "lineId": "1",
            "networkAvailabilities": [
                {
                    "deliveryMethod": "SHP",
                    "onhandAvailableQuantity": 10.0,
                    "futureAvailableQuantity": 20.0,
                    "onhandEarliestShipTs": "2022-10-11T21:42:50.198Z",
                    "onhandLatestShipTs": "2022-10-11T21:42:50.198Z",
                    "futureEarliestShipTs": "2022-10-11T21:42:50.198Z",
                    "futureLatestShipTs": "2022-10-11T21:42:50.198Z",
                    "earliestShipTs": "2022-10-11T21:42:50.198Z",
                    "latestShipTs": "2022-10-11T21:42:50.198Z",
                    "thresholdLevel": "0",
                    "thresholdType": "ONHAND",
                    "alertLevel": "0",
                    "alertQuantity": 922337203685477,
                    "distributionGroupId": "DG-1",
                    "thresholdQuantity": 922337203685477,
                    "totalAvailableQuantity": 30.0
                }
            ]
        }
    ]
}

V2 ネットワーク応答

{
    "considerSafetyStock": true,
    "lines": [
        {
            "itemId": "ITEM",
            "unitOfMeasure": "EACH",
            "productClass": "NEW",
            "deliveryMethod": "SHP",
            "segment": "ONLINE",
            "segmentType": "Channel",
            "lineId": "1",
            "networkAvailabilities": [
                {
                    "distributionGroupId": "DG-1",
                    "currentAvailability": {
                        "toTs": "2022-10-20T00:00:00.000Z",
                        "availableQuantity": 10.0,
                        "shortageQuantity": 0.0,
                        "thresholdLevel": 0,
                        "thresholdType": "ONHAND",
                        "thresholdQuantity": 922337203685477
                    },
                    "futureAvailability": [
                        {
                            "toTs": "2022-10-27T16:38:46.347Z",
                            "availableQuantity": 30.0,
                            "shortageQuantity": 0.0,
                            "fromTs": "2022-10-20T00:00:00.000Z"
                        }
                    ]
                }
            ]
        }
    ]
}

日付による予約の要求

日付要求による V1 の予約

https://api.watsoncommerce.ibm.com/inventory/{tenantId}/v1/reservations

{
    "demandType": "OPEN_ORDER",
    "lines": [
        {
            "itemId": "PLATE",
            "lineId": "1",
            "quantity": 1.0,
            "shipNode": "Matrix-Store-001",
            "unitOfMeasure": "EACH",
            "productClass": "NEW",
            "deliveryMethod": "PICK",
            "segment": "ONLINE",
            "segmentType": "Channel"
        }
    ],
    "reference": "REF5",
    "timeToExpire": 10
}

日付要求による V2 予約

https://api.watsoncommerce.ibm.com/inventory/{tenantId}/v2/reservations

{
    "availabilityType": "SELL",
    "lines": [
        {
            "itemId": "ITEM",
            "lineId": "1",
            "quantity": 1.0,
            "shipNode": "Matrix-Store-001",
            "unitOfMeasure": "EACH",
            "requestedReservationTs": "2020-01-01T00:00:00Z",
            "requestedEndTs": "2020-01-31T00:00:00Z",
            "productClass": "NEW",
            "deliveryMethod": "PICK",
            "segment": "ONLINE",
            "segmentType": "Channel"
        }
    ],
    "reference": "REF5",
    "timeToExpire": 10
}

日付による予約の回答

V1 予約は、現時点でのみ配置できます。 V2 予約は、最大数量を予約できるように、フィールド requestedReservationTs および requestedEndTs を使用する将来の時点で行うことができます。 reservationTs は、予約が行われた時刻を示します。

詳細は、日付による予約（ V2 ）をご覧ください。

日付応答による V1 の予約

{
    "lines": [
        {
            "lineId": "1",
            "reservedQuantity": 1.0,
            "id": "891ffab9-ada7-471a-98a2-76214ebbdda1",
            "reservationId": "891ffab9-ada7-471a-98a2-76214ebbdda1",
            "expirationTs": "2022-10-11T21:43:00.000Z"
        }
    ]
}

日付別 V2 予約応答

{
    "lines": [
        {
            "itemId": "ITEM",
            "unitOfMeasure": "EACH",
            "productClass": "NEW",
            "shipNode": "Matrix-Store-001",
            "deliveryMethod": "PICK",
            "segment": "ONLINE",
            "segmentType": "Channel",
            "lineId": "1",
            "requestedReservationTs": "2022-10-12T17:56:00.000Z",
            "quantity": 1.0,
            "totalReservedQuantity": 1.0,
            "reservations": [
                {
                    "id": "32e7aebc-9c33-414e-84a9-cff875028bca",
                    "reservationTs": "2022-10-12T17:56:00.000Z",
                    "expirationTs": "2022-10-12T18:07:00.000Z",
                    "reservedQuantity": 1.0,
                    "shipNode": "Matrix-Store-001"
                }
            ]
        }
    ],
    "availabilityType": "SELL",
    "considerSafetyStock": true
}