適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府Microsoft雲端合作夥伴中心
當客戶想從一系列優惠中購買訂閱時，合作夥伴會下訂單。
Cart
描述一輛推車。
| 房產 | 類型 | Description |
|---|---|---|
| 識別碼 | 字串 | 成功建立購物車時提供的購物車識別碼。 |
| creationTimeStamp | DateTime | 購物車的建立日期，以日期時間格式。 成功建立購物車時套用。 |
| lastModified時間戳記 | DateTime | 購物車上次更新的日期，以日期時間格式。 成功建立購物車時套用。 |
| 到期時間戳記 | DateTime | 購物車到期的日期，以日期時間格式。 成功建立購物車時套用。 |
| 最後修改者 | 字串 | 上次更新購物車的使用者。 成功建立購物車時套用。 |
| 明細項目 | 物件陣列 | CartLineItem 資源陣列。 |
| 狀態 | 字串 | 推車的狀態。 可能的值有「Active」（可更新/提交）和「Ordered」（已提交）。 |
購物車項目
代表購物車中包含的一件商品。
| 房產 | 類型 | Description |
|---|---|---|
| 識別碼 | 字串 | 購物車委刊項的唯一識別碼。 成功建立購物車時套用。 |
| 目錄項目ID | 字串 | 目錄項目識別碼。 |
| friendlyName | 字串 | 選擇性。 合作伙伴定義的項目的友好名稱，以幫助區分。 |
| 數量 | 整數 (int) | 授權或實例的數目。 |
| 貨幣代碼 | 字串 | 貨幣代碼。 |
| billingCycle | 物體 | 目前期間所設定的計費周期類型。 |
| 期限長度 | 字串 | 詞彙持續時間的 ISO 8601 標準表示法。 目前支援的數值為P1M（一個月）、P1Y（一年）及P3Y（三年）。 |
| 參與者 | 物件字串配對清單 | 用於紀錄購買中 PartnerID 的一組字串。 |
| 布建內容 | 字典<字串， 字串> | 在配置已購買物品時，提供額外背景說明。 要判斷特定項目需要哪些值，請參考 SKU 的 provisioningVariables 屬性。 |
| orderGroup | 字串 | 一組用來標示哪些項目可以以相同順序一起提交。 |
| 附加項目 | CartLineItem 物件列表 | 附加功能的購物車項目合集。 這些商品是為了根購物車項目購買而產生的基礎訂閱而購買的。 |
| 錯誤 | 物體 | 如果發生錯誤，則在建立購物車後套用。 |
| renewTo | 物件陣列 | RenewTo 資源陣列。 |
| 認證已接受 | 布爾 (bool) | 表示同意要約或 SKU 條件。 只有 SkuAttestationProperties 或 OfferAttestationProperties enforceAttestation 為 True 的供應項目或 SKU 才需要。 |
| 促銷標識符 | 字串 | 即將套用到購物車中單品的促銷 ID。 |
| customTermEndDate | DateTime | 新訂用帳戶第一個計費期限的結束日期。 |
Participants
代表經銷商的經銷商管理客戶的訂閱。
| 房產 | 類型 | Description |
|---|---|---|
| transaction_reseller | 字串 | 管理客戶的經銷商合作夥伴識別碼。 |
| additional_transaction_reseller | 字串 | 參與交易或管理客戶的其他合作夥伴的附加合作夥伴ID。 此特性僅適用於在 歐盟/歐洲自由貿易聯盟市場營運的經銷商。 |
Pricing
代表價格細節。 顯示的價格金額為稅前。
| 房產 | 類型 | 為必填項目 | Description |
|---|---|---|---|
| listPrice | 雙倍 | 否 | 目錄中列出的價格，未加任何價格調整。 |
| 折扣價 | 雙倍 | 否 | 套用所有適用的價格修正後的價格。 |
| 按比例計算的價格 | 雙倍 | 否 | 按比例後的折扣價格。 |
| 價格 | 雙倍 | 否 | 價格在適用的帳單貨幣中計算，扣除所有折扣並完成按比例調整後。 |
| 累計價格 | 雙倍 | 否 | 該項目的價格，含數量、折扣及按比例計算，依適用的帳單貨幣計算。 |
RenewTo
代表購物車項目中包含的一個項目。
| 房產 | 類型 | 為必填項目 | Description |
|---|---|---|---|
| 期限長度 | 字串 | 否 | 續約期限持續時間的 ISO 8601 表示。 目前支援的數值為 P1M （一個月）和 P1Y （一年）。 |
ScheduledNextTerm說明
本表描述了新商務體驗（NCE）中以授權為基礎的試用優惠續訂的 scheduledNextTermInstructions 屬性。 若未指定數值，試用將續約為付費訂閱，並續訂為年度期限、每月計費及25個授權數。
| 房產 | 類型 | 為必填項目 | Description |
|---|---|---|---|
| 產品 | 陣列 | 否 | 一個陣列，指定試用訂閱轉換為付費訂閱時的優惠，以及付費訂閱的期限和計費頻率。 |
| 數量 | 整數 (int) | 否 | 試用服務續約後，對應的付費訂閱的授權數量。 |
Product
本表描述了 NCE 授權基礎試用優惠續約的 productTerm 屬性。 若此數列中未指定數值，試用將續訂為付費訂閱，並以年度及月費計費。
| 房產 | 類型 | 為必填項目 | Description |
|---|---|---|---|
| 產品ID | 字串 | 否 | 試用期轉換為的付費訂閱產品所代表的 GUID 格式。 |
| skuId | 字串 | 否 | 一個格式化為代表試用續訂的付費訂閱 SKU 的 GUID。 |
| 可用性標識碼 | 字串 | 否 | 格式化的 GUID 用來表示試用期過後續約為付費訂閱時的可用性。 |
| billingCycle | 字串 | 否 | 付費訂閱在試用期間續約後的計費頻率。 |
| 期限長度 | 字串 | 否 | 對應的付費訂閱在試用優惠續約後的期限長度。 |
回應成功和錯誤碼
每個回應都有一個 HTTP 狀態代碼，指出成功或失敗，以及更多偵錯資訊。 使用網路追蹤工具來讀取此程式代碼、錯誤類型和額外參數。 如需完整清單，請參閱 合作夥伴中心錯誤碼。
購物車錯誤
代表建立購物車後發生的錯誤。
| 房產 | 類型 | Description |
|---|---|---|
| 錯誤代碼 | 購物車錯誤代碼 | 購物車錯誤的類型。 |
| 錯誤描述 | 字串 | 錯誤描述，包括任何關於支援值、預設值或限制的註解。 |
| 附加資訊 | 其他資訊 | 關於錯誤的更多資訊。 |
附加資訊
有關錯誤的其他資訊。
| 房產 | 類型 | Description |
|---|---|---|
| 可用數量 | 整數 (int) | 該產品 SKU 可購買的剩餘授權數量。 |
| 購買數量 | 整數 (int) | 購買的授權數量。 |
購物車錯誤代碼
購物車錯誤的類型。
| 名稱 | ErrorCode | Description |
|---|---|---|
| 不支援的貨幣 | 10000 | 貨幣在特定市場不被支援 |
| 目錄項目非有效 | 10001 | 目錄商品編號無效 |
| 配額不可用 | 10002 | 配額不足 |
| 庫存不可得 | 10003 | 部分優惠的庫存尚未提供 |
| 不支援夥伴的參與者功能 | 10004 | Partner 不支援設定參與者 |
| 無法處理購物車項目 | 10006 | 無法處理購物車的項目。 |
| 訂閱無效 | 10007 | 訂閱無效。 |
| 訂閱未啟用用於RI | 10008 | 預約購買時不會啟用訂閱。 |
| 沙盒極限 | 10009 | 沙盒的限制已被超過。 |
| 無效輸入 | 10010 | 一般的輸入無效。 |
| SubscriptionNotRegistered | 10011 | 訂閱無效。 |
| 驗證不被接受 | 10012 | 證明未被接受。 |
| 超過每個訂閱允許的最大座位數 | 10015 | 申請的座位數超過限制。 |
| Unknown | 0 | 預設值 |
購物車結帳結果
代表購物車結帳結果。
| 房產 | 類型 | Description |
|---|---|---|
| orders | Order 物件的清單。 | 訂單的集合。 |
| 訂單錯誤 | OrderError 物件列表。 | 訂單錯誤數據的集合。 |
OrderError
代表在購物車結帳過程中訂單建立時發生的錯誤。
| 房產 | 類型 | Description |
|---|---|---|
| orderGroupId | 字串 | 出現錯誤的訂單之訂單群組ID。 |
| 字碼 | 整數 (int) | 錯誤碼。 |
| 說明 | 字串 | 錯誤的描述。 |