Sherweb Platform MCP Server (預覽版)
Sherweb Cumulus MCP 伺服器透過模型上下文協定(Model Context Protocol)讓 AI 助理能安全存取 Cumulus。 授權的 MSP 合作夥伴可利用自然語言檢索組織、訂閱、目錄、帳單及稽核資料,將其組合成有用的答案,並在其 Cumulus 權限內執行支援操作,如下訂單與修訂訂閱。
此連接器適用於以下產品和區域:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government 區域 - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| Name | Sherweb 支援 |
| URL | https://www.sherweb.com |
| support@sherweb.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | Sherweb 的人工智慧 |
| Website | https://www.sherweb.com |
| 隱私權原則 | https://www.sherweb.com/legal/privacy-policy/ |
| Categories | IT運營;企業管理 |
雪網積雲
Sherweb 是一家雲端解決方案供應商,協助託管服務供應商(MSP)透過 Cumulus 平台管理客戶、訂閱、帳單及目錄管理。 Cumulus MCP(模型上下文協定)連接器直接將您的 Cumulus 資料暴露給 AI 助理,例如 Microsoft Copilot Studio 代理,讓您能以自然語言查詢並處理您的 MSP 業務。
透過這個連接器,你可以問你的 AI 助理以下問題:
- 「列出所有未來60天內可續約的訂閱。」
- 「我哪個組織沒有備用產品?」
- 「我以經常性收入排名前十的組織是什麼?」
- 「訂購組織,Contoso。」
Prerequisites
- 一個啟用的 Cumulus 帳戶,服務 提供者 角色。
- 一個專屬經銷商的 Cumulus API 金鑰,裡面有
mcp:tools和service-provider範圍。 - 一個安裝 Sherweb Platform 連接器解決方案的 Microsoft Power Platform 環境。
建立經銷商憑證
每個經銷商在建立連接器連線時,會使用其現有的 OAuth 用戶端憑證;此流程不使用動態用戶端註冊(DCR)或共用的用戶端 ID 與用戶端秘密。
https://helpdesk.sherweb.com/en-us/knowledge-base/articles/KA-05021
- 登入 Cumulus。
- 進入 平台設定 → API。
- 為經銷商建立獨立的 API 金鑰,或選擇該經銷商現有的金鑰。
- 確保鑰匙有 和
mcp:toolsservice-provider瞄準鏡。 複製其用戶端 ID 與用戶端秘密;秘密只有在被創造時才會顯示。 - 將已安裝的 Sherweb Platform 連接器顯示的重定向 URI 加入 API 金鑰。
OAuth 端點
| Field | Value |
|---|---|
| 授權 URL | https://cumulus.sherweb.com/oidc/connect/authorize |
| 權杖 URL | https://cumulus.sherweb.com/oidc/connect/token |
| 重新整理URL | https://cumulus.sherweb.com/oidc/connect/token |
| 範圍 | mcp:tools service-provider |
建立連結
https://helpdesk.sherweb.com/en-us/knowledge-base/articles/KA-05021
- 在 Power Platform 中,選擇已安裝的 Sherweb Platform 連接器並建立連線。
- 在被要求時輸入經銷商的客戶 ID 和客戶秘密。 這些憑證由連線安全儲存,並用於該經銷商的 OAuth 授權與憑證更新。
- 請用該經銷商授權的用戶帳號登入 Cumulus。
- 如果連線無法完成授權,請確認連接器重定向 URI 是否註冊在該經銷商的 API 金鑰上,且兩個必要的範圍都已啟用。
為每個經銷商建立獨立連結。 客戶端 ID 與客戶端秘密識別經銷商的 OAuth 應用程式;互動式登入會決定授權使用該連線的使用者帳號。
令牌更新使用 OAuth 更新令牌授權及該連線所提供的憑證,而非重複授權碼交換。
對於直接 MCP 用戶端(而非認證的 Power Platform 連接器),請設定 OAuth 不 https://mcp.sherweb.com 使用上述端點與範圍。 直接 MCP 用戶端認證設定與 Power Platform 連接器中經銷商專屬的憑證欄位是分開的。
支援的作業
Read-Only 工具
| Tool | Description |
|---|---|
QueryOrganizations |
查詢由服務提供者使用 GraphQL 管理的組織。 |
QuerySubscriptions |
使用 GraphQL 查詢跨組織的訂閱。 |
QueryOrganizationConsumptions |
查詢使用 GraphQL 組織的用電量資料(使用量與收費)。 |
QueryCatalog |
使用 GraphQL 查詢服務提供者可用的產品目錄。 |
QueryAuditLogs |
查詢使用 GraphQL 在平台上執行的行為的稽核日誌。 |
GetGraphQLSchema |
檢索完整的 GraphQL 架構以協助構建有效查詢。 |
GetCopilotSkus |
取得 Microsoft Copilot 的 Sherweb SKU 優惠清單。 |
書寫工具
註: 寫入操作需要在已認證的 Cumulus 帳號上取得適當的權限。
| Tool | Description |
|---|---|
PlaceOrder |
為客戶組織下訂單。 |
ValidateQuote |
驗證擬訂訂單並取得價格細節,無需下訂單即可。 |
CreateSubscriptionsAmendment |
調整一個或多個現有訂閱的座位或執照數量。 |
CancelSubscriptions |
取消一個或多個客戶組織的訂閱。 |
ConfigurePlatform |
為客戶配置一個平台(例如 Microsoft 365 租戶)。 |
範例提示
以下是你可以用連接到這個 MCP 伺服器的 AI 助理使用的自然語言提示範例:
續約與帳單
- 「列出所有未來60天內可續約的訂閱。」
- 「告訴我過去三個月Contoso組織所有指控的細數。」
- 「所有組織的訂閱期限在30天內到期?」
庫存與投資組合
- 「我哪個組織沒有備用產品?」
- 「我以經常性收入排名前十的組織是什麼?」
- 「給我看所有最近取消的訂閱。」
- 「列出包含 Copilot SKU 的產品供應。」
Actions
- 「訂購 5 個 Microsoft 365 商務進階版 給 Contoso 組織。」
- 「驗證Fabrikam組織Azure計畫10席的報價。」
- 「將Contoso組織的Exchange Online座位數量從20個減少到15個。」
已知問題和限制
- GraphQL 查詢深度:非常深度巢狀的 GraphQL 查詢可能會逾時。如果查詢逾時,透過減少巢狀深度或請求欄位數量來簡化。
-
需要分頁:列表查詢(
QueryOrganizations、QuerySubscriptions等)需要分頁參數(after/first或 )。last/before沒有分頁的查詢會回傳錯誤。 -
範圍:建立 API 金鑰時,確保
mcp:tools和service-provider都包含在 OAuth 範圍內;缺少任一範圍將導致認證錯誤。
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有地區 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| Name | 類型 | Description | Required |
|---|---|---|---|
| 經銷商客戶識別碼 | 字串 | 輸入為該經銷商所發出的客戶識別碼。 | True |
| 經銷商客戶秘密 | 安全字串 | 請輸入為該經銷商發出的客戶秘密。 | True |
動作
| 使用 GraphQL 查詢目錄項目 |
使用 GraphQL 查詢目錄項目。 |
| 使用 GraphQL 查詢稽核日誌 |
使用 GraphQL 查詢稽核日誌。 |
| 使用 GraphQL 查詢組織消耗 |
使用 GraphQL 查詢組織消耗。 |
| 使用 GraphQL 查詢訂閱 |
使用 GraphQL 查詢訂閱。 |
| 使用 GraphQL 的查詢組織 |
使用 GraphQL 查詢組織。 |
| 修訂訂閱數量 |
調整訂閱數量。 |
| 取得 SDL 格式的 GraphQL 架構 |
取得 SDL 格式的 GraphQL 架構。 |
| 取消組織訂閱 |
取消組織的訂閱。 |
| 在不下訂單的情況下驗證報價 |
在不下訂單的情況下驗證報價。 |
| 將 Sherweb SKU 對應到 Microsoft Copilot 的優惠 |
讓 Sherweb SKU 對應到 Microsoft Copilot 優惠。 |
| 為客戶下單 |
為顧客下單。 |
| 為客戶配置平台 |
為客戶設定一個平台。 |
使用 GraphQL 查詢目錄項目
使用 GraphQL 查詢目錄項目。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
graphqlQuery
|
graphqlQuery | True | string |
傳回
游標分頁的通用連接類型,「T」連接中項目的類型
使用 GraphQL 查詢稽核日誌
使用 GraphQL 查詢稽核日誌。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
graphqlQuery
|
graphqlQuery | True | string |
傳回
游標分頁的通用連接類型,「T」連接中項目的類型
使用 GraphQL 查詢組織消耗
使用 GraphQL 查詢組織消耗。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
graphqlQuery
|
graphqlQuery | True | string |
傳回
游標分頁的通用連接類型,「T」連接中項目的類型
使用 GraphQL 查詢訂閱
使用 GraphQL 查詢訂閱。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
graphqlQuery
|
graphqlQuery | True | string |
傳回
游標分頁的通用連接類型,「T」連接中項目的類型
使用 GraphQL 的查詢組織
使用 GraphQL 查詢組織。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
graphqlQuery
|
graphqlQuery | True | string |
傳回
游標分頁的通用連接類型,「T」連接中項目的類型
修訂訂閱數量
調整訂閱數量。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
組織ID
|
organizationId | True | uuid | |
|
subscriptionId
|
subscriptionId | True | uuid | |
|
新數量
|
newQuantity | integer |
傳回
取得 SDL 格式的 GraphQL 架構
取消組織訂閱
取消組織的訂閱。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
組織ID
|
organizationId | True | uuid | |
|
subscriptionIds
|
subscriptionIds | True | array of uuid |
傳回
在不下訂單的情況下驗證報價
在不下訂單的情況下驗證報價。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
客戶ID
|
customerId | True | uuid | |
|
sku
|
sku | True | string | |
|
數量
|
quantity | integer | ||
|
購買訂單號
|
purchaseOrderNumber | string | ||
|
命令者
|
orderedBy | True | string |
傳回
將 Sherweb SKU 對應到 Microsoft Copilot 的優惠
為客戶下單
為顧客下單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
客戶ID
|
customerId | True | uuid | |
|
sku
|
sku | True | string | |
|
數量
|
quantity | integer | ||
|
購買訂單號
|
purchaseOrderNumber | string | ||
|
命令者
|
orderedBy | True | string |
傳回
為客戶配置平台
為客戶設定一個平台。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
客戶ID
|
customerId | True | uuid | |
|
platformId
|
platformId | True | uuid | |
|
識別碼
|
identifier | True | string | |
|
value
|
value | string |
傳回
- response
- string
定義
選擇
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
參數選擇值
|
parameterChoiceValue | string | |
|
parameterChoiceDisplayName
|
parameterChoiceDisplayName | string |
ConnectionOfProjectedAuditLog
游標分頁的通用連接類型,「T」連接中項目的類型
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
邊緣
|
edges | array of EdgeOfProjectedAuditLog |
本頁的邊列表。 每條邊包含節點及其游標。 |
|
nodes
|
nodes | array of ProjectedAuditLog |
本頁節點的扁平列表(不含游標元資料)。 |
|
總計數量
|
totalCount | integer |
所有頁面的總項目數量(如要求時) |
|
頁面資訊
|
pageInfo | PageInfo |
用於游標導覽的分頁元資料。 |
ConnectionOfProjectedCatalogItem
游標分頁的通用連接類型,「T」連接中項目的類型
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
邊緣
|
edges | array of EdgeOfProjectedCatalogItem |
本頁的邊列表。 每條邊包含節點及其游標。 |
|
nodes
|
nodes | array of ProjectedCatalogItem |
本頁節點的扁平列表(不含游標元資料)。 |
|
總計數量
|
totalCount | integer |
所有頁面的總項目數量(如要求時) |
|
頁面資訊
|
pageInfo | PageInfo |
用於游標導覽的分頁元資料。 |
ConnectionOfProjectedConsumptionItem
游標分頁的通用連接類型,「T」連接中項目的類型
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
邊緣
|
edges | array of EdgeOfProjectedConsumptionItem |
本頁的邊列表。 每條邊包含節點及其游標。 |
|
nodes
|
nodes | array of ProjectedConsumptionItem |
本頁節點的扁平列表(不含游標元資料)。 |
|
總計數量
|
totalCount | integer |
所有頁面的總項目數量(如要求時) |
|
頁面資訊
|
pageInfo | PageInfo |
用於游標導覽的分頁元資料。 |
規劃組織的連結
游標分頁的通用連接類型,「T」連接中項目的類型
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
邊緣
|
edges | array of EdgeOfProjectedOrganization |
本頁的邊列表。 每條邊包含節點及其游標。 |
|
nodes
|
nodes | array of ProjectedOrganization |
本頁節點的扁平列表(不含游標元資料)。 |
|
總計數量
|
totalCount | integer |
所有頁面的總項目數量(如要求時) |
|
頁面資訊
|
pageInfo | PageInfo |
用於游標導覽的分頁元資料。 |
ConnectionOfProjectedSubscription
游標分頁的通用連接類型,「T」連接中項目的類型
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
邊緣
|
edges | array of EdgeOfProjectedSubscription |
本頁的邊列表。 每條邊包含節點及其游標。 |
|
nodes
|
nodes | array of ProjectedSubscription |
本頁節點的扁平列表(不含游標元資料)。 |
|
總計數量
|
totalCount | integer |
所有頁面的總項目數量(如要求時) |
|
頁面資訊
|
pageInfo | PageInfo |
用於游標導覽的分頁元資料。 |
EdgeOfProjectedAuditLog
在游標分頁連接中的一條邊,包含該節點及其游標。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
節點
|
node | ProjectedAuditLog | |
|
資料指標
|
cursor | string |
此邊的游標用於游標分頁。 |
EdgeOfProjectedCatalogItem
在游標分頁連接中的一條邊,包含該節點及其游標。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
節點
|
node | ProjectedCatalogItem | |
|
資料指標
|
cursor | string |
此邊的游標用於游標分頁。 |
EdgeOfProjectedConsumptionItem
在游標分頁連接中的一條邊,包含該節點及其游標。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
節點
|
node | ProjectedConsumptionItem | |
|
資料指標
|
cursor | string |
此邊的游標用於游標分頁。 |
EdgeOfProjectedOrganization(投影組織邊緣)
在游標分頁連接中的一條邊,包含該節點及其游標。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
節點
|
node | ProjectedOrganization | |
|
資料指標
|
cursor | string |
此邊的游標用於游標分頁。 |
EdgeOfProjectedSubscription
在游標分頁連接中的一條邊,包含該節點及其游標。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
節點
|
node | ProjectedSubscription | |
|
資料指標
|
cursor | string |
此邊的游標用於游標分頁。 |
EventSource
發票度量
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
期間範圍
|
periodRange | InvoicePeriodRange | |
|
累積的經常性成本
|
accumulatedRecurringCost | double |
O(1) |
|
發票計數
|
invoiceCount | integer |
O(1) |
|
複利 月成本 成長率
|
compoundMonthlyCostGrowthRate | double |
O(1) |
|
成本濃度比
|
costConcentrationRatio | double |
O(1) |
|
成本波動率
|
costVolatility | double |
O(1) |
發票期間範圍
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
寄件者
|
from | date |
O(1) |
|
to
|
to | date |
O(1) |
頁面資訊
用於游標導覽的分頁元資料。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
有下一頁
|
hasNextPage | boolean | |
|
有上一頁
|
hasPreviousPage | boolean | |
|
start游標
|
startCursor | string | |
|
結束游標
|
endCursor | string |
位置順序回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
requestTrackingID
|
requestTrackingId | uuid | |
|
subscriptionIds
|
subscriptionIds | array of uuid |
PlatformRequiredParameter
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
參數描述
|
parameterDescription | string | |
|
參數識別碼
|
parameterIdentifier | string | |
|
參數預設值
|
parameterDefaultValue | string | |
|
parameterFormatType
|
parameterFormatType | string | |
|
參數格式模式
|
parameterFormatPattern | string | |
|
parameterFormatChoices
|
parameterFormatChoices | array of Choice |
ProjectedAuditLog
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
id
|
id | integer | |
|
targetName
|
targetName | string | |
|
動作
|
action | string | |
|
date
|
date | date-time | |
|
使用者顯示名稱
|
userDisplayName | string | |
|
類別名稱
|
categoryName | string | |
|
說明
|
description | string | |
|
details
|
details | array of ProjectedAuditLogDetail |
ProjectedAuditLogDetail
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
propertyName
|
propertyName | string | |
|
oldValue
|
oldValue | string | |
|
newValue
|
newValue | string |
預計目錄項目
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
sku
|
sku | string |
O(1) |
|
name
|
name | string |
O(1) |
|
說明
|
description | string |
O(1) |
|
billingCycle
|
billingCycle | string |
O(1) |
|
承諾期限
|
commitmentTerm | string |
O(1) |
|
價格資訊
|
pricingInformation | ProjectedPricingInformation | |
|
平臺
|
platforms | array of ProjectedPlatforms |
O(1) 額外呼叫 |
預計承諾期限
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
型別
|
type | ProjectedCommitmentTermType | |
|
結束日期
|
endDate | date-time | |
|
renewalConfiguration
|
renewalConfiguration | ProjectedRenewalConfiguration |
ProjectedCommitmentTermType
預計消費項目
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
產品
|
product | string |
O(1) |
|
vendorName
|
vendorName | string |
O(1) |
|
總計數量
|
totalQuantities | integer |
O(1) |
|
消費量
|
consumedQuantities | integer |
O(1) |
|
可用數量
|
availableQuantities | integer |
O(1) |
預計貨幣
預計費 Dto
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
固定收費
|
recurringFee | ProjectedMoney | |
|
setupFee
|
setupFee | ProjectedMoney | |
|
費用:費用:重複收費
|
costRecurringFee | ProjectedMoney | |
|
billingCycle
|
billingCycle | string |
預估金錢
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | double | |
|
貨幣
|
currency | ProjectedCurrency | |
|
進位
|
rounding | integer |
預計組織
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
id
|
id | uuid |
O(1) |
|
name
|
name | string |
O(1) |
|
uniqueName (唯一名稱)
|
uniqueName | string |
O(1) |
|
parentId
|
parentId | uuid |
O(1) |
|
parentName (父名稱)
|
parentName | string |
O(1) |
|
暫停
|
suspendedOn | date-time |
O(n) |
|
是被暫停的
|
isSuspended | boolean |
O(1) |
|
已刪除
|
isDeleted | boolean |
O(1) |
|
isActive
|
isActive | boolean |
O(n) |
|
停賽後的日子
|
daysSinceSuspension | integer |
O(n) |
|
訂閱計數
|
totalSubscriptionCount | integer |
O(n) |
|
uniqueSkus
|
uniqueSkus | array of string |
O(n) |
|
每月持續收費
|
totalMonthlyRecurringFee | double |
O(n) |
|
總額每月成本定期費用
|
totalMonthlyCostRecurringFee | double |
O(n) |
|
總額每年定期費用
|
totalYearlyRecurringFee | double |
O(n) |
|
總計 年費 定期費
|
totalYearlyCostRecurringFee | double |
O(n) |
|
總計其他定期費用
|
totalOtherRecurringFee | double |
O(n),非月費或年度計費週期的累積 |
|
總計其他成本重複收費
|
totalOtherCostRecurringFee | double |
O(n), 以非月或年計費的計費週期彙總 |
|
invoiceMetrics
|
invoiceMetrics | InvoiceMetrics |
投影平台
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
platformId
|
platformId | uuid | |
|
必要參數
|
requiredParameters | array of PlatformRequiredParameter |
O(1) 額外呼叫 |
預計價格資訊
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
固定收費
|
recurringFee | double | |
|
setupFee
|
setupFee | double | |
|
貨幣
|
currency | ProjectedCurrency | |
|
billingCycle
|
billingCycle | string |
ProjectedRenewalConfiguration
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
isConfigurable
|
isConfigurable | boolean | |
|
renew設定
|
renewSettings | ProjectedRenewSettings |
投影更新設定
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
續約日期
|
renewalDate | date-time | |
|
排程數量
|
scheduledQuantity | integer | |
|
共同終止日期
|
coTerminationEndDate | date-time |
預計訂閱
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
subscriptionId
|
subscriptionId | uuid |
O(1) |
|
組織ID
|
organizationId | uuid |
O(1) |
|
cancelledOn(取消了)
|
cancelledOn | date-time |
O(n) |
|
isActive
|
isActive | boolean |
O(n) |
|
天自創造以來
|
daysSinceCreation | integer |
O(n) |
|
createdOn
|
createdOn | date-time |
O(1) |
|
數量
|
quantity | integer |
O(1) |
|
承諾期限
|
commitmentTerm | ProjectedCommitmentTerm | |
|
直到Renewal
|
daysUntilRenewal | integer |
O(n) |
|
sherwebSku
|
sherwebSku | string |
O(1) |
|
microsoftSkus
|
microsoftSkus | array of string |
O(n) |
|
說明
|
description | string |
O(1) |
|
expirationDate
|
expirationDate | date-time |
O(1) |
|
上次續約日期
|
lastRenewalDate | date-time |
O(n) |
|
學費
|
fees | ProjectedFeesDto | |
|
productName
|
productName | string |
O(1) |
|
是共終止的
|
isCoterminated | boolean |
O(n) |
|
歷程
|
history | array of SubscriptionHistoryEvent |
O(n) |
RenewedTermEndDateDetail
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
前一日期
|
previousDate | date | |
|
新日期
|
newDate | date |
重新更新學期起始日期詳情
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
前一日期
|
previousDate | date | |
|
新日期
|
newDate | date |
SkuDetail
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
sku
|
sku | string | |
|
skuName
|
skuName | string |
訂閱歷史事件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
createdOn
|
createdOn | date-time | |
|
許可證數量
|
licenseCount | integer | |
|
sku
|
sku | string | |
|
offerName
|
offerName | string | |
|
使用者
|
user | string | |
|
共同終止日期
|
coTerminationDate | string | |
|
事件源
|
eventSource | EventSource | |
|
termEndDateDetail
|
termEndDateDetail | RenewedTermEndDateDetail | |
|
termStartDateDetail
|
termStartDateDetail | RenewedTermStartDateDetail |
訂閱修正案
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
訂閱修正案ID
|
subscriptionsAmendmentId | uuid | |
|
trackingId
|
trackingId | TrackingId |
訂閱取消
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
訂閱取消ID
|
subscriptionsCancellationId | uuid | |
|
trackingId
|
trackingId | TrackingId |
TrackingId
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
requestTrackingID
|
requestTrackingId | uuid |
驗證訂單行項目
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
lineNumber
|
lineNumber | integer | |
|
sku
|
sku | string | |
|
name
|
name | string | |
|
billingCycle
|
billingCycle | string | |
|
承諾期限
|
commitmentTerm | string | |
|
數量
|
quantity | integer | |
|
單價
|
unitPrice | double | |
|
累計價格
|
extendedPrice | double | |
|
貨幣
|
currency | string |
驗證排序結果
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
訊息
|
message | string | |
|
明細項目
|
lineItems | array of ValidateOrderLineItem | |
|
小計
|
subtotal | double | |
|
貨幣
|
currency | string |
字串
這是基本資料類型「string」。