購物車資源

  • 發行項

適用于：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府適用的 Microsoft Cloud 合作夥伴中心

當客戶想要從供應專案清單中購買訂閱時，合作夥伴會下訂單。

購物車

描述購物車。

屬性 類型​ 描述
id string 成功建立購物車時提供的購物車識別碼。
creationTimeStamp Datetime 以日期時間格式建立購物車的日期。 在成功建立購物車時套用。
lastModifiedTimeStamp Datetime 購物車上次更新的日期，以日期時間格式顯示。 在成功建立購物車時套用。
expirationTimeStamp Datetime 購物車到期的日期，以日期時間格式顯示。 在成功建立購物車時套用。
lastModifiedUser string 上次更新購物車的使用者。 在成功建立購物車時套用。
明細項目 物件陣列 CartLineItem 資源的陣列 。
status 字串 購物車的狀態。 可能的值為 「作用中」（可更新/提交）和「已排序」（已提交）。

CartLineItem

代表購物車中包含的一個專案。

屬性 類型​ 描述
id string 購物車明細專案的唯一識別碼。 在成功建立購物車時套用。
catalogItemId string 目錄專案識別碼。
friendlyName string 選擇性。 夥伴所定義之專案的易記名稱，以協助厘清。
數量 int 授權或實例的數目。
currencyCode string 貨幣代碼。
billingCycle Object 目前期間所設定的計費週期類型。
termDuration string 詞彙持續時間的 ISO 8601 標記法。 目前的支援值為 P1M（一個月）、P1Y（一年）和 P3Y（三年）。
參與者 物件字串組的清單 購買時 Record 上的 PartnerID 集合。
provisioningCoNtext <字典字串，字串> 布建已購買專案時所使用的其他內容。 若要判斷特定專案需要哪些值，請參閱 SKU 的 provisioningVariables 屬性。
orderGroup string 群組，指出哪些專案可以以相同順序一起提交。
addonItems CartLineItem 物件清單 附加元件之購物車明細專案的集合。 這些專案將會購買到從根購物車明細專案購買產生的基底訂用帳戶。
error Object 如果發生錯誤，則套用購物車之後套用。
renewsTo 物件陣列 RenewsTo 資源的陣列 。
證明Accepted bool 表示供應專案或 SKU 條件的合約。 僅適用于 SkuAttestationProperties 或 OfferAttestationProperties 強制Attestation 為 True 的供應專案或 SKU。
promotionId string 即將套用至購物車明細專案的促銷識別碼。
customTermEndDate Datetime 新訂用帳戶第一個計費期限的結束日期。

定價

代表價格詳細資料。 價格金額是在稅務前提供。

屬性 型別 必填 描述
listPrice double No 目錄中所列的價格，未套用任何定價修飾詞。
discountedPrice double No 套用所有適用的定價修飾詞之後的價格。
proratedPrice double No 按比例執行後折扣價格。
price double No 套用所有折扣並執行比例後，適用計費貨幣的價格。
extendedPrice double No 以適用的計費貨幣套用數量、折扣和比例的明細專案價格。

RenewsTo

代表購物車明細專案中所包含的一個專案。

屬性 型別 必填 描述
termDuration string No 更新期限的 ISO 8601 標記法。 目前的支援值為 P1M （一個月）和 P1Y （一年）。

回應成功和錯誤碼

每個回應都隨附 HTTP 狀態碼，會指出成功與否以及其他的偵錯資訊。 請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。 如需完整清單，請參閱 合作夥伴中心錯誤碼 。

CartError

表示建立購物車之後所發生的錯誤。

屬性 類型​ 描述
errorCode CartErrorCode 購物車錯誤的類型。
errorDescription string 錯誤描述，包括任何有關支援值、預設值或限制的附注。
additionalInformation AdditionalInformation 錯誤的其他資訊。

AdditionalInformation

有關錯誤的其他資訊。

屬性 類型​ 描述
availableQuantity int 可針對指定產品 SKU 購買的剩餘授權數目。
purchasedQuantity int 正在購買的授權數目。

CartErrorCode

購物車錯誤的類型。

名稱 ErrorCode 描述
CurrencyIsNotSupported 10000 指定市場不支援貨幣
CatalogItemIdIsNotValid 10001 目錄專案識別碼無效
QuotaNotAvailable 10002 沒有足夠的配額可用
InventoryNotAvailable 10003 庫存不適用於選取的供應專案
ParticipantsIsNotSupportedForPartner 10004 合作夥伴不支援設定參與者
UnableToProcessCartLineItem 10006 無法處理購物車明細專案。
SubscriptionIsNotValid 10007 訂閱無效。
SubscriptionIsNotEnabledForRI 10008 未針對保留購買啟用訂用帳戶。
SandboxLimitExceeded 10009 已超過沙箱限制。
InvalidInput 10010 泛型輸入無效。
SubscriptionNotRegistered 10011 訂閱無效。
AttestationNotAccepted 10012 尚未接受證明。
MaxAllowedSeatsPerSubscriptionExceeded 10015 要求的基座數目超過限制。
未知 0 預設值

CartCheckoutResult

代表購物車結帳的結果。

屬性 類型​ 描述
訂單 Order 物件的清單。 訂單的集合。
orderErrors OrderError 物件清單。 順序錯誤的集合。

OrderError

表示建立訂單時購物車結帳期間發生的錯誤。

屬性 類型​ 描述
orderGroupId string 訂單的訂單群組識別碼，並出現錯誤。
code int 錯誤碼。
description string 錯誤的描述。