合作夥伴會建立轉移給客戶的目前合作夥伴。 目前或來源合作夥伴會接受轉移，並提交以完成傳輸。
TransferEntity
描述 transferEntity 以進行新的商務轉移。
| 屬性 | 類型 | 描述 |
|---|---|---|
| ID | 字串 | 成功建立 transferEntity 時提供的 transferEntity 識別碼。 |
| 狀態 | 字串 | transferEntity 的狀態。 可能的值為 “Active” （可以刪除/提交） 和 “Completed” （已經完成）。 成功建立 transferEntity 時套用。 |
| 轉移類型 | 字串 | 數位，表示傳輸的類型。 3 轉換為 ModernAzure，5 轉換為 NewCommerce。 合作夥伴們在執行夥伴間的新商務轉移時可以選擇使用其中一種方法，但應該標準化為方法5。 |
| 客戶電郵ID | 字串 | 識別用於通知的客戶電子郵件。 |
| 創建時間 | 日期時間 | transferEntity 建立的日期，其格式為日期時間格式。 成功建立 transferEntity 時套用。 |
| 最後修改時間 | 日期時間 | transferEntity 上次更新的日期，格式為日期和時間格式。 成功建立 transferEntity 時套用。 |
| 完成時間 | 日期時間 | transferEntity 完成的日期，使用日期和時間格式呈現。 在 transferEntity 成功完成時套用。 |
| 客戶名稱 | 字串 | 選擇性。 要轉移訂閱的客戶的名稱。 |
| 客戶租戶識別碼 | 字串 | 識別客戶的 GUID 格式客戶識別碼。 成功建立 transferEntity 時套用。 |
| 夥伴租戶ID | 字串 | 用 GUID 格式的夥伴識別碼來識別合作夥伴。 |
| 來源合作夥伴名稱 | 字串 | 選擇性。 正在起始轉移之合作夥伴組織的名稱。 |
| 目標夥伴名稱 | 字串 | 選擇性。 轉移的目標合作夥伴組織名稱。 |
| partnerOnRecord | 字串 | 選擇性。 記錄的間接提供者的合作夥伴會指派給轉讓的項目明細。 |
| 目標產品類型 | 字串 | 選擇性。 字串集合，指定可提交以進行轉移的訂用帳戶類型。 Null 假設為所有類型。 價值可包括 AzureSubscription、AzureReservation、AzureSavingsPlan 及 OnlineServicesNCE、Software、SaaS。 |
| 目標合作夥伴租戶 ID | 字串 | GUID 格式化的合作夥伴識別碼，可識別轉移的目標合作夥伴。 |
| 目標合作夥伴電子郵件ID | 字串 | GUID 格式化的合作夥伴識別碼，可識別轉移的目標合作夥伴。 此標識碼與 targetPartnerTenantId 相同 |
| transferDirection | 字串 | 數位，表示傳輸的方向。 1 代表接受轉移之合作夥伴的傳入轉移。 2 代表創建轉移的合作夥伴的傳出轉移。 |
| 忽略資格檢查 | 字串 | 此值應該是錯誤的。 |
| 最後修改者 | 字串 | GUID 格式化的使用者識別碼，識別最後修改傳輸的使用者 |
| 明細項目 | 物件陣列 | 一個由TransferLineItem 資源組成的陣列。 |
TransferLineItem
代表新商務轉移中所包含的一個專案。 來源合作夥伴會看到他們嘗試轉移的項目的明細。 目標合作夥伴會在完成後看到新建立的項目。 目標合作夥伴可以使用明細項目 ID 協助瞭解從轉移產生的新建立訂閱。
| 屬性 | 類型 | 描述 |
|---|---|---|
| ID | 字串 | 轉帳項目的唯一標識碼。 成功建立 transferEntity 時套用。 |
| 友好名稱 | 字串 | 訂用帳戶的名稱。 |
| 訂閱ID | 字串 | 訂用帳戶識別碼。 |
| 數量 | 整數 (int) | 授權或實例的數目。 |
| billingCycle | 物件 | 目前期間所設定的計費周期類型。 |
| 產品類型 | 字串 | 字串，表示已傳輸的產品類型。 |
| 狀態 | 字串 | transferEntity 中明細項目的狀態。 |
| 訂閱期開始日期來源 | 日期時間 | 此值代表轉交給目標夥伴的原始訂閱創建日期與時間（UTC）。 |
| 價格 | 價格列表 | 完成的轉移明細項的價格值集合。 僅適用於新交易中基於許可證的轉讓條目。 |
價格
價格代表說明各項成本的數值。 價格包含四個價值。
| 屬性 | 類型 | 描述 |
|---|---|---|
| 建議售價 | 浮點整數 | 下一個計費期間的單位價格，且不包含任何價格調整。 這個金額是稅前的。 在含稅國家/地區，此價格包含稅費;否則就不行。 每計費期間單位價格。 僅適用於新交易中基於許可證的轉讓條目。 |
| 折扣價 | 浮點整數 | 套用所有適用的價格修正後的上市價格。 這個金額是稅前的。 在含稅國家/地區，此價格包含稅費;否則就不行。 僅適用於新交易中基於許可證的轉讓條目。 |
| 價格 | 浮點整數 | 剩餘計費週期的單位收費金額按比例計算。 所有折扣和按比例調整都已套用後的目標帳單貨幣單價。 這個金額是稅前的。 在含稅國家/地區，此價格包含稅費;否則就不行。 這是 UX 裡的 UnitPrice。 下一單位帳單金額。 僅適用於新交易中基於許可證的轉讓條目。 |
| 累計價格 | 浮點整數 | 以目標帳單貨幣計算的此項目價格，其中包含應用之數量、折扣及按比例計算。 在本 學期剩餘期間。 這個金額是稅前的。 在含稅國家/地區，此價格包含稅費;否則就不行。 這是用戶體驗版的 TotalPrice。 僅適用於新交易中基於許可證的轉讓條目。 |
| 貨幣代碼 | 字串 | 這是定價貨幣的縮寫。 僅適用於新交易中基於許可證的轉讓條目。 |
傳統授權型傳輸的傳輸實體
描述轉移實體。
| 屬性 | 類型 | 描述 |
|---|---|---|
| ID | 字串 | 成功建立 transferEntity 時提供的 transferEntity 識別碼。 |
| 創建時間 | 日期時間 | transferEntity 建立的日期，其格式為日期時間格式。 成功建立 transferEntity 時套用。 |
| 最後修改時間 | 日期時間 | transferEntity 上次更新的日期，格式為日期和時間格式。 成功建立 transferEntity 時套用。 |
| 最後修改者 | 字串 | 上次更新「transferEntity」的使用者。 成功建立 transferEntity 後套用。 |
| 客戶名稱 | 字串 | 選擇性。 要轉移訂閱的客戶的名稱。 |
| 客戶租戶識別碼 | 字串 | 識別客戶的 GUID 格式客戶識別碼。 成功建立 transferEntity 時套用。 |
| 夥伴租戶ID | 字串 | 用 GUID 格式的夥伴識別碼來識別合作夥伴。 |
| 來源合作夥伴名稱 | 字串 | 選擇性。 正在起始轉移之合作夥伴組織的名稱。 |
| sourcePartnerTenantId (來源合作夥伴租戶ID) | 字串 | GUID 格式化的合作夥伴識別碼，可識別起始傳輸的合作夥伴。 |
| 目標夥伴名稱 | 字串 | 選擇性。 轉移的目標合作夥伴組織名稱。 |
| 目標合作夥伴租戶 ID | 字串 | GUID 格式化的合作夥伴識別碼，可識別轉移的目標合作夥伴。 |
| 明細項目 | 物件陣列 | 一個由TransferLineItem 資源組成的陣列。 |
| 狀態 | 字串 | transferEntity 的狀態。 可能的值為 “Active” （可以刪除/提交） 和 “Completed” （已經完成）。 成功建立 transferEntity 時套用。 |
傳統授權型傳輸的 TransferLineItem
表示 transferEntity 中包含的一個項目。
| 屬性 | 類型 | 描述 |
|---|---|---|
| ID | 字串 | 轉帳項目的唯一標識碼。 成功建立 transferEntity 時套用。 |
| 訂閱ID | 字串 | 訂用帳戶識別碼。 |
| 數量 | 整數 (int) | 授權或實例的數目。 |
| billingCycle | 物件 | 目前期間所設定的計費周期類型。 |
| 友好名稱 | 字串 | 選擇性。 合作伙伴定義的項目的友好名稱，以幫助區分。 |
| 記錄中的合作夥伴編號 | 字串 | 已接受轉移時所購買的 Record 上的 PartnerId。 |
| 優惠編號 | 字串 | 報價識別碼。 |
| 附加項目 | TransferLineItem 物件清單 | 伴隨正在轉移的基礎訂閱一起轉移的附加元件的 transferEntity 明細項目集合。 成功建立 transferEntity 時套用。 |
| 傳輸錯誤 | 字串 | 在 transferEntity 接受之後套用，以防發生錯誤。 |
| 狀態 | 字串 | transferEntity 中明細項目的狀態。 |
傳輸提交結果
表示傳統授權型傳輸接受的傳輸結果。
| 屬性 | 類型 | 描述 |
|---|---|---|
| 訂單 | Order 物件的清單。 | 訂單的集合。 |
| 傳輸錯誤 | TransferError 物件的清單。 | 傳輸錯誤的集合。 |
TransferError
表示接受傳統授權型傳輸時所發生的錯誤。
| 屬性 | 類型 | 描述 |
|---|---|---|
| transferGroupId | 字串 | 出現錯誤的訂單之訂單群組ID。 |
| 字碼 | 整數 (int) | 錯誤碼。 |
| 描述 | 字串 | 錯誤的描述。 |
| 明細項目 | TransferLineItem 物件清單 | 屬於傳輸錯誤一部分的 transferEntity 行專案的集合。 |
TransferErrorCode
[Enum/dotnet/api/system.enum]，其值表示傳統授權型傳輸的順序錯誤類型。
| 值 | 位置 | 描述 |
|---|---|---|
| 夥伴令牌遺失 | 800001 | 請求環境中缺少合作夥伴令牌。 |
| 無效輸入 | 800002 | 要求輸入無效。 |
| 服務異常 | 800003 | 未預期的服務錯誤。 |
| 無效優惠代碼 | 800004 | 無效的優惠編號。 |
| 建立訂單錯誤 | 800005 | 建立訂單不成功。 |
| 無法找到MPN ID | 800015 | 找不到 PartnerID。 |
| NotValidIndirectResellerMpnId（無效的間接經銷商Mpn ID） | 800016 | PartnerID 不是有效的間接轉銷商。 |
| 找不到TransferId | 900100 | 找不到傳輸要求。 |
| 狀態進行中時不允許轉移 | 900101 | 轉移請求已在執行中。 |
| 如果狀態已完成，則不允許轉移 | 900102 | 傳輸要求已經完成。 |
| 轉帳創建訂單錯誤 | 900103 | 傳輸順序不成功。 |
| 轉移已由其他請求處理 | 900104 | 傳輸正在由另一個請求處理中。 |