利用可能なプロモーションの取得

販売可能な商品をショッピングカートに追加する前に取得すると、対象となるプロモーションを返品でき、ストアフロント上で買い物客が追加の購入を促すことがあります。Searchの仕組みを使って、カートの表示テキストや特典などのプロモーション情報を返品します。利用可能なプロモーションを取得する際には、割引価格の計算は行いません。

!注デフォルトでは、SXAストアフロントには利用可能なプロモーションの取得サポートが含まれていません。

利用可能なプロモーションを取得する際、コマースエンジンでは以下の項目が影響を受けます:

• 昇進指数は、 items および categoryqualifications 分野を含みます。
• GlobalCatalogPolicy ( AllowPromotionsToBeReturnedWithSellableItem オプションを含む)。デフォルトではこのオプションはfalseに設定されています。
• Commerce Engine APIヘッダーのプロモーションポリシーキーを無視GetSellableItemsSummaryGetBulkPricesSellableItems.ByKey

また、Commerce Engine (CE) Connectには以下の影響があります:

• IncludePromotions PriceTypeはCE Connectで利用可能で、 GetProductPricesWithPromotionsResult APIや GetProductBulkPricesAndPromotionsResult APIで使用されます。
• PricingServiceProvider プロダクションには、プロモーションが必要なときに電話をかけるための2つの方法があります: GetProductPricesWithPromotionsResult と GetProductBulkPricesAndPromotionsResult。

販売可能なアイテムを返すAPI GetSellableItemsSummaryでは、AssociatedPromotionsComponentコンポーネントでプロモーションが返されます。以下のようにJSONに示されています:

"@odata.type": "#Sitecore.Commerce.Plugin.Promotions.AssociatedPromotionsComponent", "Id": "8b1c298558cf448191af580b08fc2fa4", "Name": "", "Comments": "", "SellableItemId": "Entity-SellableItem-6042567", "Policies": , "Items": { "Name": "", "PromotionId": "Entity-Promotion-Habitat_PromotionBook-PromoCat1", "DisplayCartText": "PromoCat1 dct", "Policies": , "PromotionActions": { "Name": "CartFreeGiftAction", "Id": "e6f9e89caa5442e9b2bb2e4b47ac994d", "LibraryId": "CartFreeGiftAction", "Policies": , "Properties": { "Name": "MaximumQuantity", "DisplayType": "System.Int32", "Value": "0", "IsOperator": false, "Policies": }, { "Name": "AddToCartAutomatically", "DisplayType": "System.Boolean", "Value": "true", "IsOperator": false, "Policies": }

}

}, { "Name": "", "PromotionId": "Entity-Promotion-Habitat_PromotionBook-TestCategoryPromotionEnabled", "DisplayCartText": "Test category promotion II", "Policies": , "PromotionActions": { "Name": "CartFreeGiftAction", "Id": "2cc89dd3762d48f6be6282b9a5c8b95e", "LibraryId": "CartFreeGiftAction", "Policies": , "Properties": { "Name": "MaximumQuantity", "DisplayType": "System.Int32", "Value": "0", "IsOperator": false, "Policies": }, { "Name": "AddToCartAutomatically", "DisplayType": "System.Boolean", "Value": "true", "IsOperator": false, "Policies": }

}

} ,

価格情報を返すAPIでは、GetSellableItemsSummary()のようなものがSellableItemPricingモデルで返されます。以下のJSONに示されています:

{ "@odata.context": "https://localhost:5000/api/$metadata#Collection(Sitecore.Commerce.Plugin.Catalog.SellableItemSummary)", "value": { "Name": "", "ItemId": "Habitat_Master|6042567|", "Policies": , "Summaries": { "@odata.type": "#Sitecore.Commerce.Plugin.Inventory.ConnectItemAvailability", "Name": "", "ItemId": "Habitat_Master|6042567|56042567", "Count": 10000, "IsAvailable": true, "IsAlwaysAvailable": false, "AvailableDate": "0001-01-01T00:00

}

}, { "Name": "", "PromotionId": "Entity-Promotion-Habitat_PromotionBook-TestCategoryPromotionEnabled", "DisplayCartText": "Test category promotion II", "Policies": , "PromotionActions": { "Name": "CartFreeGiftAction", "Id": "2cc89dd3762d48f6be6282b9a5c8b95e", "LibraryId": "CartFreeGiftAction", "Policies": , "Properties": { "Name": "MaximumQuantity", "DisplayType": "System.Int32", "Value": "0", "IsOperator": false, "Policies": }, { "Name": "AddToCartAutomatically", "DisplayType": "System.Boolean", "Value": "true", "IsOperator": false, "Policies": }

}

},