--- title: "利用可能なプロモーションの取得" slug: "retrieving-available-promotions" abstract: "利用可能なプロモーション取得時に影響を受けるエリアの概要。" --- # 利用可能なプロモーションの取得 販売可能な商品をショッピングカートに追加する前に取得すると、対象となるプロモーションを返品でき、ストアフロント上で買い物客が追加の購入を促すことがあります。Searchの仕組みを使って、カートの表示テキストや特典などのプロモーション情報を返品します。利用可能なプロモーションを取得する際には、割引価格の計算は行いません。 > !注デフォルトでは、SXAストアフロントには利用可能なプロモーションの取得サポートが含まれていません。 利用可能なプロモーションを取得する際、コマースエンジンでは以下の項目が影響を受けます: - 昇進指数は、 items および categoryqualifications 分野を含みます。 - [GlobalCatalogPolicy](https://doc.sitecore.com/xp/ja/developers/100/sitecore-experience-commerce/catalog-and-relationship-policies.html "Catalog and Relationship policies") ( AllowPromotionsToBeReturnedWithSellableItem オプションを含む)。デフォルトではこのオプションはfalseに設定されています。 - [Commerce Engine APIヘッダーのプロモーションポリシーキーを無視](https://doc.sitecore.com/xp/ja/developers/100/sitecore-experience-commerce/policy-keys.html "Policy keys")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:00Z", "AvailabilityExpires": "2020-04-02T14:\`42:35\`.7805389Z", "Policies": }, { "@odata.type": "#Sitecore.Commerce.Plugin.Inventory.ConnectItemAvailability", "Name": "", "ItemId": "Habitat\_Master|6042567|56042568", "Count": 10000, "IsAvailable": true, "IsAlwaysAvailable": false, "AvailableDate": "0001-01-01T00:00:00Z", "AvailabilityExpires": "2020-04-02T14:\`42:35\`.7834423Z", "Policies": }, { "@odata.type": "#Sitecore.Commerce.Plugin.Inventory.ConnectItemAvailability", "Name": "", "ItemId": "Habitat\_Master|6042567|56042569", "Count": 10000, "IsAvailable": true, "IsAlwaysAvailable": false, "AvailableDate": "0001-01-01T00:00:00Z", "AvailabilityExpires": "2020-04-02T14:\`42:35\`.7875943Z", "Policies": }, { "@odata.type": "#Sitecore.Commerce.Plugin.Catalog.SellableItemPricing", "Name": "Habitat Viva 4-Door 22.0 Cubic Foot Refrigerator with Ice Maker", "ItemId": "6042567", "Policies": , "ListPrice": { "CurrencyCode": "USD", "Amount": 1919.6900 }, "SellPrice": { "CurrencyCode": "USD", "Amount": 1919.6900 }, "Variations": { "Name": "Habitat Viva 4-Door 22.0 Cubic Foot Refrigerator w/ Ice Maker (Stainless)", "ItemId": "56042567", "Policies": , "ListPrice": { "CurrencyCode": "USD", "Amount": 2429.9900 }, "SellPrice": { "CurrencyCode": "USD", "Amount": 2429.9900 } }, { "Name": "Habitat Viva 4-Door 22.0 Cubic Foot Refrigerator w/ Ice Maker (Black)", "ItemId": "56042568", "Policies": , "ListPrice": { "CurrencyCode": "USD", "Amount": 2029.9900 }, "SellPrice": { "CurrencyCode": "USD", "Amount": 2029.9900 } }, { "Name": "Habitat Viva 4-Door 22.0 Cubic Foot Refrigerator w/ Ice Maker (White)", "ItemId": "56042569", "Policies": , "ListPrice": { "CurrencyCode": "USD", "Amount": 2029.9900 }, "SellPrice": { "CurrencyCode": "USD", "Amount": 2029.9900 } } , "Promotions": { "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": } } },