購物車資源
適用于：合作夥伴中心 |由 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 | 錯誤的描述。 |