共用方式為

Commerce 定價 API

  • 發行項

本文介紹 Microsoft Dynamics 365 Commerce 定價引擎提供的各種定價 API。

Dynamics 365 Commerce 定價引擎提供以下 Retail Server API，外部應用程式可以使用這些 API 來支援各種定價方案：

  • GetActivePrices –此 API 取得產品的計算價格，包括簡單的折扣。
  • CalculateSalesDocument –此 API 計算給定數量的產品（如果一起購買）的價格和折扣。
  • GetAvailablePromotions –此 API 取得購物車中產品的適用折扣。
  • AddCoupons –此 API 將優惠券加入購物車。
  • RemoveCoupons –此 API 從購物車中移除優惠券。

有關如何在外部應用程式中使用 Retail Server API 的詳細信息，請參閱 在外部應用程式中使用 Retail Server API。

獲取活躍價格

GetActivePrices API 是在 Commerce 版本 10.0.4 版本中引入的。 此 API 取得產品的計算價格，包括簡單的折扣。 它不計算多行折扣，並且假設 API 請求中的每個產品的數量為 1。 此 API 也可以將產品清單作為輸入，以大量查詢單一產品的價格。

GetActivePrices API 支援 員工、 顧客、 匿名和 應用程式 商務角色。

GetActivePrices API 的主要用例是產品詳細資訊頁面 (PDP)，零售商在其中顯示產品的最優惠價格，包括任何有效折扣。

附註

如果您發現通話回傳的產品較少 GetActivePrices ，您可以依照 通路推銷設定驗證程序 來驗證您的推銷配置。

下表顯示了 GetActivePrices API 的輸入參數。

姓名 子名 類型 必要/選擇性 描述
專案域 投影域 必要
ChannelId 長的 必要
目錄號 長的 必要
產品 ID IEnumerable<長> 必要 要計算價格的產品清單。
活動日期 日期時間偏移量 必要 計算價格的日期。
客戶 ID 字串 可選項目 客戶帳號。
隸屬關係忠誠度等級 IEnumerable<隸屬關係忠誠度等級> 可選項目 隸屬關係和忠誠度等級。
隸屬關係 ID 長的 必要 隸屬關係 ID。
忠誠度等級 ID 長的 可選項目 忠誠度等級 ID。
includeSimpleDiscountsInContextualPrice 布林 可選項目 將此參數設為 true 可在定價計算中包含簡單折扣。 預設值為 false。
包括變體價格範圍 布林 可選項目 將此參數設為 true 可取得主產品所有變體中的最低和最高價格。 預設值為 false。
包括可達到的價格和折扣 布林 可選項目 將此參數設為 true 以獲得可達到的價格和折扣。 預設值為 false。
請求正文範例 
{
    "projectDomain": 
    {
        "ChannelId": 5637144592,
        "CatalogId": 0
    },
    "productIds": 
    [
        68719489871
    ],
    "activeDate": "2022-06-20T14:40:05.873+08:00",
    "includeSimpleDiscountsInContextualPrice": true,
    "includeVariantPriceRange": false
}
回應正文範例 
{
    "value": 
    [
        {
            "ProductId": 68719489871,
            "ListingId": 68719489871,
            "BasePrice": 0,
            "TradeAgreementPrice": 0,
            "AdjustedPrice": 0,
            "MaxVariantPrice": 0,
            "MinVariantPrice": 0,
            "CustomerContextualPrice": 0,
            "DiscountAmount": 0,
            "CurrencyCode": "USD",
            "ItemId": "82000",
            "InventoryDimensionId": null,
            "UnitOfMeasure": "ea",
            "ValidFrom": "2022-06-20T01:40:05.873-05:00",
            "ProductLookupId": 0,
            "ChannelId": 5637144592,
            "CatalogId": 0,
            "SalesAgreementPrice": 0,
            "PriceSourceTypeValue": 1,
            "DiscountLines": [],
            "AttainablePriceLines": [],
        }
    ]
}

使用 PriceLookupContext

PriceLookupContext 類別是在 Commerce 版本 10.0.37 版本中引入的。 此類包含 GetActivePrices API 的所有查找條件，並取代了先前的 ProductIds、activeDate、customerId 和 affiliationLoyaltyTiers 參數。 該類別還具有其他屬性，開發人員可以使用這些屬性在折扣查找期間過濾折扣。

根據您組織的需要，GetActivePrices API 可以接受與 PriceLookupContext 類別關聯的先前參數或新參數。

輸入參數

姓名 子名 類型 必要/選擇性 描述
專案域 投影域 必要
ChannelId 長的 必要
目錄號 長的 必要
價格查找上下文 價格查找上下文 必要
標題上下文 PriceLookupHeaderContext 必要 內含 CustomerAccountNumber、AffiliationLoyaltyTierLines 和 SalesOrderProperties
線路情境 IEnumerable<PriceLookupLineContext> 必要 包含 ProductRecordId、UnitOfMeasureSymbol、InventorySiteId、InventoryLocationId、DeliveryMode、CatalogId 和 SalesLineProperties。
includeSimpleDiscountsInContextualPrice 布林 可選項目 將此參數設為 true 可在定價計算中包含簡單折扣。 預設值為 false。
包括變體價格範圍 布林 可選項目 將此參數設為 true 可取得主產品所有變體中的最低和最高價格。 預設值為 false。
包括可達到的價格和折扣 布林 可選項目 將此參數設為 true 以獲得可達到的價格和折扣。 預設值為 false。

有關更多信息，請參閱 PriceLookupContext。

計算銷售單據

CalculateSalesDocument API 是在 Commerce 版本 10.0.25 版本中引入的。 此 API 計算給定數量的產品（如果在訂單中一起購買）的價格和折扣。 CalculateSalesDocument API 背後的定價計算同時考慮單行折扣和多行折扣。

CalculateSalesDocument API 的主要用例是在完整購物車上下文不存在的場景（例如銷售報價）中進行定價計算。 銷售點 (POS) 和商務電子商務場景也可以從此用例中受益。 當購物車商品作為一組計算時（例如，對於離散捆綁包、連結或推薦的產品或已添加到購物車的產品），較低的總價格可能會說服客戶將產品添加到購物車。

CalculateSalesDocument API 的請求和回應的資料模型是 Cart。 但是，在此 API 的上下文中，資料模型被命名為 SalesDocument。 由於大多數屬性都是可選的，並且只有少數屬性會影響定價計算，因此下表中僅顯示與定價相關的欄位。 我們不建議 API 請求中涉及任何其他欄位。

CalculateSalesDocument API 的範圍只是計算價格和折扣。 不涉及稅費。

下表顯示了名為 salesDocument 的物件內的輸入參數。

姓名 子名 類型 必要/選擇性 描述
識別碼 字串 必要 銷售單據的識別碼。
購物車線 IList<CartLine> 可選項目 用於計算價格和折扣的行列表。
產品識別碼 長的 CartLine 範圍內必需 產品記錄 ID。
ItemId 字串 可選項目 項目標識符。 如果提供了值，則它必須與 ProductId 參數的值相符。
庫存維度 ID 字串 可選項目 庫存維度標識符。 如果提供了值，則 ItemId 和 InventoryDimensionId 值的組合必須與 的值相符ProductId 參數。
數量 小數 CartLine 範圍內必需 產品的數量。
計量單位符號 字串 可選項目 產品的單位。 預設情況下，如果未提供值，API 將使用產品的銷售單位。
CustomerId 字串 可選項目 客戶帳號。
會員卡 ID 字串 可選項目 會員卡識別碼。 與會員卡關聯的任何客戶帳戶都必須與 CustomerId 參數（如果提供）的值相符。 若未找到會員卡或其狀態為 已封鎖，則不會考慮該會員卡。
隸屬關係線 IList<隸屬關係忠誠度等級> 可選項目 隸屬關係忠誠度等級線。 如果提供了 CustomerId 和/或 LoyaltyCardId 值，則相應的從屬關係忠誠度等級行將與以下行合併：在 AffiliationLines 值中提供。
隸屬關係 ID 長的 AffiliationLoyaltyTier 範圍內必備 隸屬關係記錄 ID。
忠誠度等級 ID 長的 AffiliationLoyaltyTier 範圍內必備 忠誠度等級記錄 ID。
隸屬關係類型值 int AffiliationLoyaltyTier 範圍內必備 一個值，指示隸屬關係線是 常規 類型（0）還是 忠誠度 類型(1)。 如果參數設定為 0，API 將採用 AffiliationId 值作為識別碼並忽略 LoyaltyTierId 值。 如果參數設定為 1，API 將採用 LoyaltyTierId 值作為識別符並忽略 AffiliationId 值。
原因程式碼行 集合<ReasonCodeLine> AffiliationLoyaltyTier 範圍內必備 原因代碼行。 此參數對定價計算沒有影響，但作為 AffiliationLoyaltyTier 物件的一部分是必需的。
CustomerId 字串 AffiliationLoyaltyTier 範圍內必備 客戶帳號。
優惠券 IList<優惠券> 可選項目 定價計算中不考慮不適用的優惠券（無效、過期或未找到）。
代碼 字串 優惠券範圍內必填 優惠券代碼。
代碼編號 字串 可選項目 優惠券代碼識別碼。 如果提供了值，則它必須與 Code 參數的值相符。
折扣優惠 ID 字串 可選項目 折扣標識符。 如果提供了值，則它必須與 Code 參數的值相符。
請求正文範例 
{
    "salesDocument": 
    {
        "Id": "CalculateSalesDocument",
        "CartLines": 
        [
            {
                "ProductId": 68719491408,
                "ItemId": "91003",
                "InventoryDimensionId": "",
                "Quantity": 1,
                "UnitOfMeasureSymbol": "ea"
            },
            {
                "ProductId": 68719493014,
                "Quantity": 2,
                "UnitOfMeasureSymbol": "ea"
            }
        ],
        "CustomerId": "3003",
        "AffiliationLines": 
        [
            {
                "AffiliationId": 68719476742,
                "LoyaltyTierId": 0,
                "AffiliationTypeValue": 0,
                "ReasonCodeLines": [],
                "CustomerId": null
            }
        ],
        "LoyaltyCardId": "55103",
        "Coupons": 
        [
            {
                "CodeId": "CODE-0005",
                "Code": "CPN0004",
                "DiscountOfferId": "ST100077"
            }
        ]
    }
}

整個購物車物件作為回應正文傳回。 要檢查價格和折扣，您應該關注下表中的欄位。

姓名 子名 類型 描述
淨價 小數 在應用任何折扣之前整個銷售單據的淨價。
DiscountAmount 小數 整筆銷售單據的折扣總額。
總金額 小數 整筆銷售單據的總金額。
購物車線 IList<CartLine> 包含價格和折扣詳細資訊的計算行。
價格 小數 產品的單價。
淨價 小數 在應用任何折扣之前該行的淨價（= 價格 × 數量）。
DiscountAmount 小數 折扣金額。
總金額 小數 該線路的最終總定價結果。
價格線 IList<價格線> 價格詳情，包括價格來源（底價、價格調整或貿易協議）和金額。
折扣線 IList<折扣線> 折扣詳情。

獲取可用促銷

有兩個類似的 GetAvailablePromotions API：

  • Carts/GetAvailablePromotions 接受購物車行識別碼清單作為參數。
  • GetAvailablePromotions 接受 DiscountsSearchCriteria 物件作為參數。

購物車/取得可用促銷

如果購物車有多個購物車行， Carts/GetAvailablePromotions API 將返回購物車行的所有適用折扣。

Carts/GetAvailablePromotions API 的主要用例是購物車頁面，零售商在其中顯示目前購物車所應用的折扣或可用優惠券。

下表列出了 Carts/GetAvailablePromotions API 的輸入參數。

姓名 類型 必要/選擇性 描述
機碼 字串 必要 購物車 ID。
購物車線路 ID IEnumerable<字串> 可選項目 設定此參數以僅傳回選定購物車行的折扣。
回應正文範例 
{
    "value": 
    [
        {
            "LineId": "f495ffa507bc4f63a47a409cd8713dd7",
            "Promotion": {
                "OfferId": "ST100012",
                "OfferName": "Loyalty 5% off over $100",
                "PeriodicDiscountTypeValue": 4,
                "IsDiscountCodeRequired": false,
                "ValidationPeriodId": null,
                "AdditionalRestrictions": null,
                "Description": "All loyalty members get 5% with transaction total above $10 unless some exclusive or best price discounts are already applied on the transaction",
                "ValidFromDate": "2022-06-20T06:52:56.2460219Z",
                "ValidToDate": "2022-06-20T06:52:56.2460224Z",
                "CouponCodes": [],
                "ValidationPeriod": null
            }
        }
    ]
}

獲取可用促銷

GetAvailablePromotions API 傳回給定頻道的所有適用折扣。

GetAvailablePromotions API 的主要用例是「所有折扣」頁面，零售商在其中顯示當前管道的所有折扣。

下表列出了 GetAvailablePromotions API 的輸入參數。

姓名 子名 類型 必要/選擇性 描述
搜尋條件 折扣搜尋標準 必要
ChannelId 長的 必要
Keyword 字串 可選項目
是否需要折扣代碼 布林 可選項目 指示是否需要優惠券代碼。 如果傳遞 null，則檢索所有折扣，無論優惠券代碼要求如何。
開始日期 日期時間偏移量 必要 開始日期（含）。
結束日期 日期時間偏移量 必要 結束日期（含）。
請求正文範例 
{
    "searchCriteria": {
        "ChannelId": 5637144592,
        "StartDate": "1900-01-01T00:00:00Z",
        "EndDate": "2154-12-31T00:00:00Z"
    }
}
回應正文範例 
{
    "@odata.context": "https://usnconeboxax1ret.cloud.onebox.dynamics.com/Commerce/$metadata#Collection(Microsoft.Dynamics.Commerce.Runtime.DataModel.Promotion)",
    "value": [
        {
            "OfferId": "ST100024",
            "OfferName": "Weekly ad",
            "PeriodicDiscountTypeValue": 2,
            "IsDiscountCodeRequired": true,
            "ValidationPeriodId": "",
            "AdditionalRestrictions": "",
            "Description": "",
            "ValidFromDate": "1900-01-01T00:00:00Z",
            "ValidToDate": "2154-12-31T00:00:00Z",
            "CouponCodes": [],
            "ExtensionProperties": [
                {
                    "Key": "DATAAREAID",
                    "Value": {
                        "StringValue": "usrt"
                    }
                },
                {
                    "Key": "DATEVALIDATIONTYPE",
                    "Value": {
                        "IntegerValue": 1
                    }
                }
            ]
        },
        {
            "OfferId": "ST100019",
            "OfferName": "Take 20 off anything",
            "PeriodicDiscountTypeValue": 2,
            "IsDiscountCodeRequired": true,
            "ValidationPeriodId": "",
            "AdditionalRestrictions": "",
            "Description": "",
            "ValidFromDate": "1900-01-01T00:00:00Z",
            "ValidToDate": "2154-12-31T00:00:00Z",
            "CouponCodes": [],
            "ExtensionProperties": [
                {
                    "Key": "DATAAREAID",
                    "Value": {
                        "StringValue": "usrt"
                    }
                },
                {
                    "Key": "DATEVALIDATIONTYPE",
                    "Value": {
                        "IntegerValue": 1
                    }
                }
            ]
        },
        {
            "OfferId": "ST100015",
            "OfferName": "Watches",
            "PeriodicDiscountTypeValue": 2,
            "IsDiscountCodeRequired": false,
            "ValidationPeriodId": "",
            "AdditionalRestrictions": "",
            "Description": "",
            "ValidFromDate": "1900-01-01T00:00:00Z",
            "ValidToDate": "2154-12-31T00:00:00Z",
            "CouponCodes": [],
            "ExtensionProperties": [
                {
                    "Key": "DATAAREAID",
                    "Value": {
                        "StringValue": "usrt"
                    }
                },
                {
                    "Key": "DATEVALIDATIONTYPE",
                    "Value": {
                        "IntegerValue": 1
                    }
                }
            ]
        },
        {
            "OfferId": "ST100012",
            "OfferName": "Loyalty 5% off over $100",
            "PeriodicDiscountTypeValue": 4,
            "IsDiscountCodeRequired": false,
            "ValidationPeriodId": "",
            "AdditionalRestrictions": "",
            "Description": "All loyalty members get 5% with transaction total above $10 unless some exclusive or best price discounts are already applied on the transaction",
            "ValidFromDate": "1900-01-01T00:00:00Z",
            "ValidToDate": "2154-12-31T00:00:00Z",
            "CouponCodes": [],
            "ExtensionProperties": [
                {
                    "Key": "DATAAREAID",
                    "Value": {
                        "StringValue": "usrt"
                    }
                },
                {
                    "Key": "DATEVALIDATIONTYPE",
                    "Value": {
                        "IntegerValue": 1
                    }
                }
            ]
        },
        {
            "OfferId": "ST100011",
            "OfferName": "Loyalty 50% off sunglasses",
            "PeriodicDiscountTypeValue": 1,
            "IsDiscountCodeRequired": false,
            "ValidationPeriodId": "",
            "AdditionalRestrictions": "",
            "Description": "Gold tier Loyalty customers get 50% on Sunglasses when purchased with a Top, Scarf or Men's Casual shirts",
            "ValidFromDate": "1900-01-01T00:00:00Z",
            "ValidToDate": "2154-12-31T00:00:00Z",
            "CouponCodes": [],
            "ExtensionProperties": [
                {
                    "Key": "DATAAREAID",
                    "Value": {
                        "StringValue": "usrt"
                    }
                },
                {
                    "Key": "DATEVALIDATIONTYPE",
                    "Value": {
                        "IntegerValue": 1
                    }
                }
            ]
        },
        {
            "OfferId": "ST100009",
            "OfferName": "Student discount",
            "PeriodicDiscountTypeValue": 2,
            "IsDiscountCodeRequired": false,
            "ValidationPeriodId": "",
            "AdditionalRestrictions": "",
            "Description": "Students get 10% off for on Jeans and Backpacks",
            "ValidFromDate": "1900-01-01T00:00:00Z",
            "ValidToDate": "2154-12-31T00:00:00Z",
            "CouponCodes": [],
            "ExtensionProperties": [
                {
                    "Key": "DATAAREAID",
                    "Value": {
                        "StringValue": "usrt"
                    }
                },
                {
                    "Key": "DATEVALIDATIONTYPE",
                    "Value": {
                        "IntegerValue": 1
                    }
                }
            ]
        },
        {
            "OfferId": "ST100004",
            "OfferName": "Soccer sale",
            "PeriodicDiscountTypeValue": 3,
            "IsDiscountCodeRequired": false,
            "ValidationPeriodId": "",
            "AdditionalRestrictions": "",
            "Description": "Providing you great discounts ranging from 10% to 20% on all branded Soccer balls.  We carry a full line of soccer balls.  Buy one for yourself or gift it to someone.  We promise you that you won't be disappointed.  If you don't see something that you are looking for please call us.  This offer is only valid at our Retail Malls.",
            "ValidFromDate": "1900-01-01T00:00:00Z",
            "ValidToDate": "2154-12-31T00:00:00Z",
            "CouponCodes": [],
            "ExtensionProperties": [
                {
                    "Key": "DATAAREAID",
                    "Value": {
                        "StringValue": "usrt"
                    }
                },
                {
                    "Key": "DATEVALIDATIONTYPE",
                    "Value": {
                        "IntegerValue": 1
                    }
                }
            ]
        },
        {
            "OfferId": "ST100003",
            "OfferName": "BMX helmet sale",
            "PeriodicDiscountTypeValue": 0,
            "IsDiscountCodeRequired": false,
            "ValidationPeriodId": "",
            "AdditionalRestrictions": "",
            "Description": "Get 20% off on all branded youth BMX helmets when you buy two or more.  Choose from our great selection of BMX bike helmets from top brands, including ProTec, Giro, Bell and SixSixOne BMX helmets.  This offer is only available at our Retail Mall stores",
            "ValidFromDate": "1900-01-01T00:00:00Z",
            "ValidToDate": "2154-12-31T00:00:00Z",
            "CouponCodes": [],
            "ExtensionProperties": [
                {
                    "Key": "DATAAREAID",
                    "Value": {
                        "StringValue": "usrt"
                    }
                },
                {
                    "Key": "DATEVALIDATIONTYPE",
                    "Value": {
                        "IntegerValue": 1
                    }
                }
            ]
        }
    ]
}

新增優惠券

AddCoupons API 支援將優惠券清單加入購物車。 新增優惠券後，它會返回購物車物件。

下表顯示了 AddCoupons API 的輸入參數。

姓名 類型 必要/選擇性 描述
機碼 字串 必要 購物車 ID。
優惠券代碼 IEnumerable<字串> 必要 要加入購物車的優惠券代碼。
isLegacy 折扣代碼 布林 可選項目 將此參數設為 true 以指示優惠券是舊折扣代碼。 預設值為 false。

刪除優惠券

RemoveCoupons API 支援從購物車中刪除優惠券清單。 刪除優惠券後，它會返回購物車物件。

下表顯示了 RemoveCoupons API 的輸入參數。

姓名 類型 必要/選擇性 描述
機碼 字串 必要 購物車 ID。
優惠券代碼 IEnumerable<字串> 必要 要從購物車中刪除的優惠券代碼。

獲取產品促銷

GetProductPromotions API 是在 Commerce 版本 10.0.38 版本中引入的。 此 API 取得具有給定產品折扣的促銷產品列表，也可以將產品折扣 ID 和定價上下文列表作為輸入並查詢關聯的促銷產品。 GetProductPromotions API 的主要用例是在產品清單頁面上，零售商在其中展示折扣產品。 此 API 支援基於屬性的定價模型和舊定價模型。

下表顯示了 GetProductPromotions API 的輸入參數。

姓名 子名 類型 必要/選擇性 描述
產品折扣 ID IEnumerable<字串> 必要 用於尋找促銷產品的產品折扣 ID 清單。
價格查找上下文 價格查找上下文 必要 定價的背景。
活動日期 日期時間偏移量 可選項目 考慮晉升的日期。

限制和限制：

  • 最多只能輸入五個產品折扣 ID。
  • 僅支援簡單折扣。
請求正文範例 
{
    {
    "productDiscountIds": 
    [
        "ST100009",
        "ST100024"
    ],
    "priceLookupContext": 
    {
        "HeaderContext": 
        {
            "AffiliationLoyaltyTierLines": 
            [
                {
                    "AffiliationId": 5637144577,
                    "LoyaltyTierId": 0, 
                    "AffiliationTypeValue": 0,
                    "ReasonCodeLines": [],
                    "CustomerId": "2001"
                }
            ]
        },
        "LineContexts": []
    },
    "activeDate": "2023-08-20T14:40:05.873+08:00",
    },
}
回應正文範例 
{
    "value": 
    [
        {
            "ProductId": 68719489871,
            "ProductDiscounts":
            [
                {
                    "OfferId": "ST100009",
                    "OfferName": "Student discount",
                    "PeriodicDiscountTypeValue": 2,
                    "IsDiscountCodeRequired": false,
                    "ValidationPeriodId": null,
                    "AdditionalRestrictions": null,
                    "Description": "Students get 10% off on Jeans and Backpacks",
                    "ValidFromDate": "1900-01-01T00:00:00.0000000Z",
                    "ValidToDate": "2154-12-31T00:00:00.0000000Z",
                    "CouponCodes": [],
                    "DateValidationTypeValue": 1
                },
                {
                    "OfferId": "ST100024",
                    "OfferName": "Weekly ad",
                    "PeriodicDiscountTypeValue": 2,
                    "IsDiscountCodeRequired": false,
                    "ValidationPeriodId": null,
                    "AdditionalRestrictions": null,
                    "Description": "",
                    "ValidFromDate": "1900-01-01T00:00:00.0000000Z",
                    "ValidToDate": "2154-12-31T00:00:00.0000000Z",
                    "CouponCodes": [],
                    "DateValidationTypeValue": 1
                }
            ]   
        },
        {
            "ProductId": 68719489872,
            "ProductDiscounts":
            [
                {
                    "OfferId": "ST100009",
                    "OfferName": "Student discount",
                    "PeriodicDiscountTypeValue": 2,
                    "IsDiscountCodeRequired": false,
                    "ValidationPeriodId": null,
                    "AdditionalRestrictions": null,
                    "Description": "Students get 10% off on Jeans and Backpacks",
                    "ValidFromDate": "1900-01-01T00:00:00.0000000Z",
                    "ValidToDate": "2154-12-31T00:00:00.0000000Z",
                    "CouponCodes": [],
                    "DateValidationTypeValue": 1
                }
            ]   
        }
    ]
}

有關更多信息，請參閱 PriceLookupContext。

價格查找上下文

PriceLookupContext 類別用於 GetProductPromotions 和 GetActivePrices API 中基於屬性的定價模型。

PriceLookupContext 類別的結構如以下範例所示。

{
    HeaderContext: PriceLookupHeaderContext
    {
        CustomerAccountNumber: string
        AffiliationLoyaltyTierLines: IEnumerable<AffiliationLoyaltyTier>
        ChannelId: long?
        SalesOrderProperties: IEnumerable<AttributeValueBase>
    },
    LineContexts: IEnumerable<PriceLookupLineContext>
    [
        {
            ProductRecordId: string
            UnitOfMeasureSymbol: string
            InventorySiteId: string
            InventoryLocationId: string
            DeliveryMode: string
            CatalogId: string
            SalesLineProperties: IEnumerable<AttributeValueBase>
        },
    ]
}
請求正文範例 
"PriceLookupContext":
{
    "HeaderContext": 
    {
        "CustomerAccount": 2001,
        "AffiliationLoyaltyTierLines": 
        [
            {
                "AffiliationId": 5637144577,
                "LoyaltyTierId": 0, 
                "AffiliationTypeValue": 0,
                "ReasonCodeLines": [],
                "CustomerId": "2001"
            }
        ],
        "SalesOrderProperties":
        [
            {
                "@odata.type": "#Microsoft.Dynamics.Commerce.Runtime.DataModel.AttributeTextValue",
                "Name": "CalcDate",
                "TextValue": "2022-10-10"
            }
        ]
    },
    "LineContexts": []
}

附註

  • PriceLookupHeaderContext 參數中未指定客戶群組，因為它是透過客戶帳號推斷的。
  • ChannelId 可以在 PriceLookupHeaderContext 參數中指定。 如果未指定，則使用請求上下文中的 ChannelId（使用 Store Commerce 時的目前通道）。