利用可能なプロモーションの取得
Version:
日本語翻訳に関する免責事項
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
ショッピングカートに追加される前に販売可能な商品を取得すると、対象となるプロモーションを返品することができ、ストアフロントで買い物客が追加購入を促す可能性があります。検索メカニズムを使用して、プロモーション情報 (カートの表示テキストや特典など) を返します。利用可能なプロモーションを取得する場合、割引価格を決定するための計算は行われません。
メモ
デフォルトでは、SXA Storefrontには利用可能なプロモーションを取得するためのサポートが含まれていません。
利用可能なプロモーションを取得すると、Commerce Engineで次の影響を受けます。
-
プロモーション インデックス: itemsフィールドとcategoryqualificationsフィールドが含まれます。
-
GlobalCatalogPolicyポリシーには、AllowPromotionsToBeReturnedWithSellableItemオプションが含まれます。デフォルトでは、このオプションはfalseに設定されています。
-
Commerce Engine APIヘッダーのIgnorePromotionsGetSellableItemsSummaryGetBulkPricesSellableItems.ByKey
また、Commerce Engine (CE) Connectでは、次の影響を受けます。
-
IncludePromotions PriceTypeはCE Connectで使用でき、GetProductPricesWithPromotionsResult APIとGetProductBulkPricesAndPromotionsResult APIで使用されます。
-
PricingServiceProviderこれには、プロモーションが必要なときに呼び出す2つのメソッド ( GetProductPricesWithPromotionsResultとGetProductBulkPricesAndPromotionsResultが含まれています。
GetSellableItemsSummaryなど、Sellable商品を返すAPIの場合、プロモーションは次のJSONに示すようにAssociatedPromotionsComponentコンポーネントで返されます。
"@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": [] } ] } ] } ],
GetSellableItemsSummary()などの料金情報を返すAPIの場合、プロモーションは次のJSONに示すようにSellableItemPricingモデルで返されます。
{ "@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": [] } ] } ] },