アイテムの設定方法

場合によっては、アイテムによっては特別な取り扱いや配送指示が必要になることがあります。アイテムの説明とアイテムの指示が混在しないようにするために、カタログ・サービスにはアイテムの指示宣言機能が用意されています。

カタログ・マネージャーは、1 つ以上の指示をアイテムに関連付けることができ、各指示は以下のパラメーターによって分類されます。以下のフィールドは必須ではありません。

命令コード-内部命令のセットを表すためにカタログ・マネージャーによって定義されたコード。
命令テキスト-スタッフが特定の命令に従うことを可能にするために、カタログ・マネージャーによって公開される可能性のあるテキスト。
指示タイプ-指示には、「梱包用 (For Packing)」、「出荷用 (For Shipping)」、「ピックアップ用 (For Pickup)」などのさまざまなタイプがあります。
シーケンス番号-複数の命令セットがサポートされています。カタログ・マネージャーは、シーケンス番号を命令に割り当てて、順序どおりに完了できるようにすることができます。

命令セットを設定するには、 Upsert Instructions API を使用します。

PATCH https://api.watsoncommerce.ibm.com/catalog/{tenantid}/v1/itemInstructions
{
  "itemId": "WINE_CHEESE_GIFTSET",
  "unitOfMeasure": "EACH",
  "itemInstructions": [
    {
      "instructionCode": "FSWC001",
      "instructionText": "Fragile, use bubble wrap",
      "instructionType": "For Shipping",
      "sequenceNo": 1
    },
    {
      "instructionCode": "FPWC001",
      "instructionText": "Fragile, inform customer to handle with care",
      "instructionType": "For Pickup",
      "sequenceNo": 1
    }
  ]
}

命令が正しく割り当てられているかどうかを確認するには、'Get InstructionsAPIまたは'Get Item DetailsAPIを使用することができる。

Get Item DetailsAPIのレスポンス・サンプルは以下のように確認できる：

GET https://api.watsoncommerce.ibm.com/catalog/{tenantid}/v1/itemDetails?itemId=WINE_CHEESE_GIFTSET&unitOfMeasure=EACH
{
    "itemId": "WINE_CHEESE_GIFTSET",
    "unitOfMeasure": "EACH",
    "itemGroupCode": "PROD",
    "primaryInformation": {"kitCode": "BUNDLE"},
    "components": […],
    "itemInstructions": [
        {
            "instructionCode": "FSWC001",
            "instructionText": "Fragile, use bubble wrap",
            "instructionType": "For Shipping",
            "sequenceNo": 1
        },
        {
            "instructionCode": "FPWC001",
            "instructionText": "Fragile, inform customer to handle with care",
            "instructionType": "For Pickup",
            "sequenceNo": 1
        }
    ]
}