Sherweb Platform MCP Server (wersja zapoznawcza)

Serwer Sherweb Cumulus MCP zapewnia asystentom sztucznej inteligencji bezpieczny dostęp do Cumulus za pośrednictwem protokołu kontekstu modelu. Autoryzowani partnerzy MSP mogą używać języka naturalnego do pobierania organizacji, subskrypcji, wykazu, rozliczeń i inspekcji danych, łączenia ich w przydatne odpowiedzi i wykonywania obsługiwanych operacji, takich jak składanie zamówień i zmiana subskrypcji w ramach uprawnień Cumulus.

Ten łącznik jest dostępny w następujących produktach i regionach:

Service Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate - narzędzie do automatyzacji procesów Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Contact
Name Obsługa platformy Sherweb
adres URL https://www.sherweb.com
Email support@sherweb.com
Metadane łącznika
Publisher Sztuczna inteligencja Sherweb
Website https://www.sherweb.com
Zasady ochrony prywatności https://www.sherweb.com/legal/privacy-policy/
Categories Operacje IT; Zarządzanie biznesem

Sherweb Cumulus

Sherweb to dostawca rozwiązań w chmurze, który umożliwia dostawcom usług zarządzanych zarządzanie klientami, subskrypcjami, rozliczeniami i katalogiem za pośrednictwem platformy Cumulus . Łącznik Cumulus MCP (Model Context Protocol) uwidacznia dane Cumulus bezpośrednio asystentom sztucznej inteligencji — takim jak agenci Microsoft Copilot Studio — dzięki czemu można wykonywać zapytania i wykonywać działania dotyczące firmy MSP w języku naturalnym.

Za pomocą tego łącznika możesz zadawać pytania asystenta sztucznej inteligencji, takie jak:

  • "Wyświetl listę wszystkich subskrypcji w celu odnowienia w ciągu najbliższych 60 dni".
  • "Które z moich organizacji nie mają produktu do tworzenia kopii zapasowych?"
  • "Co to są moje 10 najlepszych organizacji według przychodów cyklicznych?"
  • "Złóż zamówienie dla organizacji Contoso".

Prerequisites

  • Aktywne konto Cumulus z rolą dostawcy usług .
  • Klucz interfejsu mcp:tools API Cumulus specyficzny dla odsprzedawcy z zakresami i service-provider .
  • Środowisko Microsoft Power Platform, w którym zainstalowano rozwiązanie łącznika platformy Sherweb.

Tworzenie poświadczeń odsprzedawcy

Każdy odsprzedawca używa własnych poświadczeń klienta OAuth podczas tworzenia połączenia łącznika; ten przepływ nie używa dynamicznej rejestracji klienta (DCR) ani udostępnionego identyfikatora klienta i klucza tajnego klienta.

https://helpdesk.sherweb.com/en-us/knowledge-base/articles/KA-05021

  1. Zaloguj się do Cumulus.
  2. Przejdź do pozycji Ustawienia platformy → interfejsów API.
  3. Utwórz oddzielny klucz interfejsu API dla odsprzedawcy lub wybierz istniejący klucz odsprzedawcy.
  4. Upewnij się, że klucz ma mcp:tools zakresy i .service-provider Skopiuj identyfikator klienta i klucz tajny klienta; wpis tajny jest wyświetlany tylko podczas tworzenia.
  5. Dodaj identyfikator URI przekierowania wyświetlany dla zainstalowanego łącznika platformy Sherweb do klucza interfejsu API.

Punkty końcowe protokołu OAuth

Pole Value
Adres URL autoryzacji https://cumulus.sherweb.com/oidc/connect/authorize
Adres URL tokenu https://cumulus.sherweb.com/oidc/connect/token
Odśwież adres URL https://cumulus.sherweb.com/oidc/connect/token
Zakresy mcp:tools service-provider

Tworzenie połączenia

https://helpdesk.sherweb.com/en-us/knowledge-base/articles/KA-05021

  1. W programie Power Platform wybierz zainstalowany łącznik Platformy Sherweb i utwórz połączenie.
  2. Wprowadź identyfikator klienta odsprzedawcy i klucz tajny klienta po wyświetleniu monitu. Te poświadczenia są bezpiecznie przechowywane przez połączenie i są używane do autoryzacji OAuth i odświeżania tokenu tego odsprzedawcy.
  3. Zaloguj się do cumulus przy użyciu konta użytkownika autoryzowanego dla tego odsprzedawcy.
  4. Jeśli połączenie nie może ukończyć autoryzacji, sprawdź, czy identyfikator URI przekierowania łącznika jest zarejestrowany w kluczu interfejsu API tego odsprzedawcy i czy oba wymagane zakresy są włączone.

Utwórz oddzielne połączenie dla każdego odsprzedawcy. Identyfikator klienta i klucz tajny klienta identyfikują aplikację OAuth odsprzedawcy; logowanie interakcyjne określa konto użytkownika autoryzowane do korzystania z połączenia.

Odnawianie tokenu używa udzielenia tokenu odświeżania OAuth i poświadczeń podanych dla tego połączenia zamiast powtarzać wymianę kodu autoryzacji.

W przypadku bezpośrednich klientów MCP (a nie certyfikowanych łączników platformy Power Platform) skonfiguruj uwierzytelnianie OAuth przy https://mcp.sherweb.com użyciu powyższych punktów końcowych i zakresów. Bezpośrednia konfiguracja uwierzytelniania klienta MCP jest oddzielona od pól poświadczeń specyficznych dla odsprzedawcy w łączniku platformy Power Platform.

Obsługiwane operacje

narzędzia Read-Only

Tool Description
QueryOrganizations Wykonywanie zapytań względem organizacji zarządzanych przez dostawcę usług przy użyciu języka GraphQL.
QuerySubscriptions Wykonywanie zapytań dotyczących subskrypcji między organizacjami przy użyciu języka GraphQL.
QueryOrganizationConsumptions Wykonywanie zapytań dotyczących danych użycia (użycia i opłat) dla organizacji korzystających z języka GraphQL.
QueryCatalog Wykonaj zapytanie dotyczące wykazu produktów dostępnego dla dostawcy usług przy użyciu języka GraphQL.
QueryAuditLogs Wykonaj zapytanie w dzienniku inspekcji akcji wykonywanych na platformie przy użyciu języka GraphQL.
GetGraphQLSchema Pobierz pełny schemat GraphQL, aby ułatwić konstruowanie prawidłowych zapytań.
GetCopilotSkus Pobierz listę jednostek SKU sherweb dla ofert Microsoft Copilot.

Narzędzia do zapisu

Uwaga: Operacje zapisu wymagają odpowiednich uprawnień dla uwierzytelnionego konta Cumulus.

Tool Description
PlaceOrder Należy złożyć zamówienie produktu dla organizacji klienta.
ValidateQuote Zweryfikuj proponowane zamówienie i uzyskaj szczegóły cennika bez składania zamówienia.
CreateSubscriptionsAmendment Zmień liczbę stanowisk lub licencji na co najmniej jedną istniejącą subskrypcję.
CancelSubscriptions Anuluj co najmniej jedną subskrypcję dla organizacji klienta.
ConfigurePlatform Konfigurowanie platformy (na przykład Microsoft 365 dzierżawy) dla klienta.

Przykładowe wskazówki

Poniżej przedstawiono przykłady monitów języka naturalnego, których można użyć z asystentem sztucznej inteligencji połączonym z tym serwerem MCP:

Odnawianie i rozliczenia

  • "Wyświetl listę wszystkich subskrypcji w celu odnowienia w ciągu najbliższych 60 dni".
  • "Daj mi podział wszystkich opłat dla organizacji Contoso w ciągu ostatnich 3 miesięcy."
  • "Jakie subskrypcje wygasają w ciągu 30 dni we wszystkich organizacjach?"

Spis i portfolio

  • "Które z moich organizacji nie mają produktu do tworzenia kopii zapasowych?"
  • "Co to są moje 10 najlepszych organizacji według przychodów cyklicznych?"
  • "Pokaż mi wszystkie ostatnio anulowane subskrypcje."
  • "Wyświetl listę wszystkich ofert produktów, które obejmują jednostkę SKU Copilot".

Actions

  • "Złożyć zamówienie na 5 miejsc Microsoft 365 Business Premium dla organizacji Contoso."
  • "Zweryfikuj ofertę dla 10 miejsc w planie Azure dla organizacji Fabrikam"."
  • "Zmniejsz liczbę miejsc Exchange Online dla organizacji Contoso z 20 do 15"."

Znane problemy i ograniczenia

  • Głębokość zapytania GraphQL: bardzo głęboko zagnieżdżone zapytania GraphQL mogą przekraczać limit czasu. Jeśli upłynął limit czasu zapytania, uprosz ją, zmniejszając głębokość zagnieżdżania lub liczbę żądanych pól.
  • Wymagane stronicowanie: kwerendy listy (QueryOrganizations, QuerySubscriptionsitp.) wymagają argumentów stronicowania (first/after lub last/before). Zapytania bez stronicowania będą zwracać błąd.
  • Zakresy: Upewnij się, że zarówno zakresy OAuth, jak mcp:tools i service-provider są uwzględnione w zakresach protokołu OAuth podczas tworzenia klucza interfejsu API. Brak jednego z tych zakresów spowoduje błędy uwierzytelniania.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Required
Identyfikator klienta odsprzedawcy ciąg Wprowadź identyfikator klienta wystawiony dla tego odsprzedawcy. True
Klucz tajny klienta odsprzedawcy securestring Wprowadź klucz tajny klienta wystawiony dla tego odsprzedawcy. True

Akcje

Anulowanie subskrypcji dla organizacji

Anulowanie subskrypcji dla organizacji.
Konfigurowanie platformy dla klienta

Konfigurowanie platformy dla klienta.
Pobieranie schematu GraphQL w formacie SDL

Pobierz schemat GraphQL w formacie SDL.
Pobierz jednostki SKU Sherweb zamapowane na oferty Microsoft Copilot

Pobierz jednostki SKU Sherweb zamapowane na oferty Microsoft Copilot.
Weryfikowanie oferty bez składania zamówienia

Zweryfikuj cudzysłów bez składania zamówienia.
Wykonywanie zapytań dotyczących dzienników inspekcji przy użyciu języka GraphQL

Wykonywanie zapytań dotyczących dzienników inspekcji przy użyciu języka GraphQL.
Wykonywanie zapytań dotyczących organizacji przy użyciu języka GraphQL

Wykonywanie zapytań względem organizacji przy użyciu języka GraphQL.
Wykonywanie zapytań dotyczących subskrypcji przy użyciu języka GraphQL

Wykonywanie zapytań dotyczących subskrypcji przy użyciu języka GraphQL.
Wykonywanie zapytań dotyczących użycia organizacji przy użyciu języka GraphQL

Wykonywanie zapytań dotyczących użycia organizacji przy użyciu języka GraphQL.
Wykonywanie zapytań o elementy wykazu przy użyciu języka GraphQL

Wykonywanie zapytań o elementy wykazu przy użyciu języka GraphQL.
Zamawianie klienta

Wyłóż zamówienie dla klienta.
Zmiana ilości subskrypcji

Zmień ilości subskrypcji.

Anulowanie subskrypcji dla organizacji

Identyfikator operacji:
CancelSubscriptions

Anulowanie subskrypcji dla organizacji.

Parametry

Nazwisko Klucz Wymagane Typ Opis
identyfikator organizacji
 organizationId True uuid
subscriptionIds
 subscriptionIds True array of uuid

Zwraca

Body
SubscriptionsCancellation

Konfigurowanie platformy dla klienta

Identyfikator operacji:
ConfigurePlatform

Konfigurowanie platformy dla klienta.

Parametry

Nazwisko Klucz Wymagane Typ Opis
customerId (identyfikator klienta)
 customerId True uuid
Identyfikator platformy
 platformId True uuid
identyfikator
 identifier True string
value
 value string

Zwraca

response
string

Pobieranie schematu GraphQL w formacie SDL

Identyfikator operacji:
GetGraphQLSchema

Pobierz schemat GraphQL w formacie SDL.

Zwraca

response
string

Pobierz jednostki SKU Sherweb zamapowane na oferty Microsoft Copilot

Identyfikator operacji:
GetCopilotSkus

Pobierz jednostki SKU Sherweb zamapowane na oferty Microsoft Copilot.

Zwraca

response
array of SkuDetail

Weryfikowanie oferty bez składania zamówienia

Identyfikator operacji:
ValidateQuote

Zweryfikuj cudzysłów bez składania zamówienia.

Parametry

Nazwisko Klucz Wymagane Typ Opis
customerId (identyfikator klienta)
 customerId True uuid
sku
 sku True string
ilość
 quantity integer
purchaseOrderNumber
 purchaseOrderNumber string
orderBy
 orderedBy True string

Zwraca

Body
ValidateOrderResult

Wykonywanie zapytań dotyczących dzienników inspekcji przy użyciu języka GraphQL

Identyfikator operacji:
QueryAuditLogs

Wykonywanie zapytań dotyczących dzienników inspekcji przy użyciu języka GraphQL.

Parametry

Nazwisko Klucz Wymagane Typ Opis
graphqlQuery
 graphqlQuery True string

Zwraca

Ogólny typ połączenia dla stronicowania opartego na kursorze, "T" Typ elementów w połączeniu

Body
ConnectionOfProjectedAuditLog

Wykonywanie zapytań dotyczących organizacji przy użyciu języka GraphQL

Identyfikator operacji:
QueryOrganizations

Wykonywanie zapytań względem organizacji przy użyciu języka GraphQL.

Parametry

Nazwisko Klucz Wymagane Typ Opis
graphqlQuery
 graphqlQuery True string

Zwraca

Ogólny typ połączenia dla stronicowania opartego na kursorze, "T" Typ elementów w połączeniu

Body
ConnectionOfProjectedOrganization

Wykonywanie zapytań dotyczących subskrypcji przy użyciu języka GraphQL

Identyfikator operacji:
QuerySubscriptions

Wykonywanie zapytań dotyczących subskrypcji przy użyciu języka GraphQL.

Parametry

Nazwisko Klucz Wymagane Typ Opis
graphqlQuery
 graphqlQuery True string

Zwraca

Ogólny typ połączenia dla stronicowania opartego na kursorze, "T" Typ elementów w połączeniu

Body
ConnectionOfProjectedSubscription

Wykonywanie zapytań dotyczących użycia organizacji przy użyciu języka GraphQL

Identyfikator operacji:
QueryOrganizationConsumptions

Wykonywanie zapytań dotyczących użycia organizacji przy użyciu języka GraphQL.

Parametry

Nazwisko Klucz Wymagane Typ Opis
graphqlQuery
 graphqlQuery True string

Zwraca

Ogólny typ połączenia dla stronicowania opartego na kursorze, "T" Typ elementów w połączeniu

Body
ConnectionOfProjectedConsumptionItem

Wykonywanie zapytań o elementy wykazu przy użyciu języka GraphQL

Identyfikator operacji:
QueryCatalog

Wykonywanie zapytań o elementy wykazu przy użyciu języka GraphQL.

Parametry

Nazwisko Klucz Wymagane Typ Opis
graphqlQuery
 graphqlQuery True string

Zwraca

Ogólny typ połączenia dla stronicowania opartego na kursorze, "T" Typ elementów w połączeniu

Body
ConnectionOfProjectedCatalogItem

Zamawianie klienta

Identyfikator operacji:
PlaceOrder

Wyłóż zamówienie dla klienta.

Parametry

Nazwisko Klucz Wymagane Typ Opis
customerId (identyfikator klienta)
 customerId True uuid
sku
 sku True string
ilość
 quantity integer
purchaseOrderNumber
 purchaseOrderNumber string
orderBy
 orderedBy True string

Zwraca

Body
PlaceOrderResponse

Zmiana ilości subskrypcji

Identyfikator operacji:
CreateSubscriptionsAmendment

Zmień ilości subskrypcji.

Parametry

Nazwisko Klucz Wymagane Typ Opis
identyfikator organizacji
 organizationId True uuid
subscriptionId
 subscriptionId True uuid
newQuantity
 newQuantity integer

Zwraca

Body
SubscriptionsAmendment

Definicje

Wybór

Nazwisko Ścieżka Typ Opis
parameterChoiceValue
 parameterChoiceValue string
parameterChoiceDisplayName
 parameterChoiceDisplayName string

ConnectionOfProjectedAuditLog

Ogólny typ połączenia dla stronicowania opartego na kursorze, "T" Typ elementów w połączeniu

Nazwisko Ścieżka Typ Opis
Krawędzie
 edges array of EdgeOfProjectedAuditLog

Lista krawędzi na tej stronie. Każda krawędź zawiera węzeł i jego kursor.
nodes
 nodes array of ProjectedAuditLog

Spłaszczona lista węzłów na tej stronie (bez metadanych kursora).
łączna liczba
 totalCount integer

Łączna liczba elementów na wszystkich stronach (gdy jest to wymagane)
pageInfo
 pageInfo PageInfo

Metadane stronicowania na potrzeby nawigacji opartej na kursorach.

ConnectionOfProjectedCatalogItem

Ogólny typ połączenia dla stronicowania opartego na kursorze, "T" Typ elementów w połączeniu

Nazwisko Ścieżka Typ Opis
Krawędzie
 edges array of EdgeOfProjectedCatalogItem

Lista krawędzi na tej stronie. Każda krawędź zawiera węzeł i jego kursor.
nodes
 nodes array of ProjectedCatalogItem

Spłaszczona lista węzłów na tej stronie (bez metadanych kursora).
łączna liczba
 totalCount integer

Łączna liczba elementów na wszystkich stronach (gdy jest to wymagane)
pageInfo
 pageInfo PageInfo

Metadane stronicowania na potrzeby nawigacji opartej na kursorach.

ConnectionOfProjectedConsumptionItem

Ogólny typ połączenia dla stronicowania opartego na kursorze, "T" Typ elementów w połączeniu

Nazwisko Ścieżka Typ Opis
Krawędzie
 edges array of EdgeOfProjectedConsumptionItem

Lista krawędzi na tej stronie. Każda krawędź zawiera węzeł i jego kursor.
nodes
 nodes array of ProjectedConsumptionItem

Spłaszczona lista węzłów na tej stronie (bez metadanych kursora).
łączna liczba
 totalCount integer

Łączna liczba elementów na wszystkich stronach (gdy jest to wymagane)
pageInfo
 pageInfo PageInfo

Metadane stronicowania na potrzeby nawigacji opartej na kursorach.

ConnectionOfProjectedOrganization

Ogólny typ połączenia dla stronicowania opartego na kursorze, "T" Typ elementów w połączeniu

Nazwisko Ścieżka Typ Opis
Krawędzie
 edges array of EdgeOfProjectedOrganization

Lista krawędzi na tej stronie. Każda krawędź zawiera węzeł i jego kursor.
nodes
 nodes array of ProjectedOrganization

Spłaszczona lista węzłów na tej stronie (bez metadanych kursora).
łączna liczba
 totalCount integer

Łączna liczba elementów na wszystkich stronach (gdy jest to wymagane)
pageInfo
 pageInfo PageInfo

Metadane stronicowania na potrzeby nawigacji opartej na kursorach.

ConnectionOfProjectedSubscription

Ogólny typ połączenia dla stronicowania opartego na kursorze, "T" Typ elementów w połączeniu

Nazwisko Ścieżka Typ Opis
Krawędzie
 edges array of EdgeOfProjectedSubscription

Lista krawędzi na tej stronie. Każda krawędź zawiera węzeł i jego kursor.
nodes
 nodes array of ProjectedSubscription

Spłaszczona lista węzłów na tej stronie (bez metadanych kursora).
łączna liczba
 totalCount integer

Łączna liczba elementów na wszystkich stronach (gdy jest to wymagane)
pageInfo
 pageInfo PageInfo

Metadane stronicowania na potrzeby nawigacji opartej na kursorach.

EdgeOfProjectedAuditLog

Krawędź w połączeniu podzielonym na strony opartego na kursorach zawierająca węzeł i jego kursor.

Nazwisko Ścieżka Typ Opis
węzeł
 node ProjectedAuditLog
kursor
 cursor string

Kursor dla tej krawędzi używany do stronicowania opartego na kursorach.

EdgeOfProjectedCatalogItem

Krawędź w połączeniu podzielonym na strony opartego na kursorach zawierająca węzeł i jego kursor.

Nazwisko Ścieżka Typ Opis
węzeł
 node ProjectedCatalogItem
kursor
 cursor string

Kursor dla tej krawędzi używany do stronicowania opartego na kursorach.

EdgeOfProjectedConsumptionItem

Krawędź w połączeniu podzielonym na strony opartego na kursorach zawierająca węzeł i jego kursor.

Nazwisko Ścieżka Typ Opis
węzeł
 node ProjectedConsumptionItem
kursor
 cursor string

Kursor dla tej krawędzi używany do stronicowania opartego na kursorach.

EdgeOfProjectedOrganization

Krawędź w połączeniu podzielonym na strony opartego na kursorach zawierająca węzeł i jego kursor.

Nazwisko Ścieżka Typ Opis
węzeł
 node ProjectedOrganization
kursor
 cursor string

Kursor dla tej krawędzi używany do stronicowania opartego na kursorach.

EdgeOfProjectedSubscription

Krawędź w połączeniu podzielonym na strony opartego na kursorach zawierająca węzeł i jego kursor.

Nazwisko Ścieżka Typ Opis
węzeł
 node ProjectedSubscription
kursor
 cursor string

Kursor dla tej krawędzi używany do stronicowania opartego na kursorach.

EventSource

integer

Metryki faktur

Nazwisko Ścieżka Typ Opis
periodRange
 periodRange InvoicePeriodRange
skumulowany koszt cykliczny
 accumulatedRecurringCost double

O(1)
invoiceCount
 invoiceCount integer

O(1)
compoundMonthlyCostGrowthRate
 compoundMonthlyCostGrowthRate double

O(1)
costConcentrationRatio
 costConcentrationRatio double

O(1)
zmienność kosztów
 costVolatility double

O(1)

InvoicePeriodRange

Nazwisko Ścieżka Typ Opis
from
 from date

O(1)
to
 to date

O(1)

PageInfo

Metadane stronicowania na potrzeby nawigacji opartej na kursorach.

Nazwisko Ścieżka Typ Opis
hasNextPage
 hasNextPage boolean
hasPreviousPage
 hasPreviousPage boolean
startCursor
 startCursor string
endCursor
 endCursor string

PlaceOrderResponse

Nazwisko Ścieżka Typ Opis
requestTrackingId
 requestTrackingId uuid
subscriptionIds
 subscriptionIds array of uuid

PlatformRequiredParameter

Nazwisko Ścieżka Typ Opis
parametrDescription
 parameterDescription string
parametrIdentifier
 parameterIdentifier string
parameterDefaultValue
 parameterDefaultValue string
parameterFormatType
 parameterFormatType string
parameterFormatPattern
 parameterFormatPattern string
parameterFormatChoices
 parameterFormatChoices array of Choice

ProjectedAuditLog

Nazwisko Ścieżka Typ Opis
identyfikator
 id integer
targetName
 targetName string
akcja
 action string
date
 date date-time
WyświetlanaNazwaUżytkownika
 userDisplayName string
categoryName
 categoryName string
opis
 description string
details
 details array of ProjectedAuditLogDetail

ProjectedAuditLogDetail

Nazwisko Ścieżka Typ Opis
propertyName
 propertyName string
oldValue
 oldValue string
newValue
 newValue string

ProjectedCatalogItem

Nazwisko Ścieżka Typ Opis
sku
 sku string

O(1)
name
 name string

O(1)
opis
 description string

O(1)
billingCycle
 billingCycle string

O(1)
commitmentTerm
 commitmentTerm string

O(1)
pricingInformation
 pricingInformation ProjectedPricingInformation
Platformy
 platforms array of ProjectedPlatforms

Połączenie dodatkowe O(1)

ProjectedCommitmentTerm

Nazwisko Ścieżka Typ Opis
typ
 type ProjectedCommitmentTermType
data zakończenia
 endDate date-time
renewalConfiguration
 renewalConfiguration ProjectedRenewalConfiguration

ProjectedCommitmentTermType

integer

ProjectedConsumptionItem

Nazwisko Ścieżka Typ Opis
product
 product string

O(1)
vendorName
 vendorName string

O(1)
totalQuantities
 totalQuantities integer

O(1)
consumedQuantities
 consumedQuantities integer

O(1)
availableQuantities
 availableQuantities integer

O(1)

Prognozowanacurrency

integer

ProjectedFeesDto

Nazwisko Ścieżka Typ Opis
cyklicznefee
 recurringFee ProjectedMoney
setupFee
 setupFee ProjectedMoney
costRecurringFee
 costRecurringFee ProjectedMoney
billingCycle
 billingCycle string

ProjectedMoney

Nazwisko Ścieżka Typ Opis
value
 value double
waluta
 currency ProjectedCurrency
zaokrąglanie
 rounding integer

Projektowanaorganizacja

Nazwisko Ścieżka Typ Opis
identyfikator
 id uuid

O(1)
name
 name string

O(1)
uniqueName (unikatowa) nazwa
 uniqueName string

O(1)
parentId (identyfikator rodzica)
 parentId uuid

O(1)
nazwa_elementu nadrzędnego
 parentName string

O(1)
suspendedOn
 suspendedOn date-time

O(n)
isSuspended
 isSuspended boolean

O(1)
usunięty
 isDeleted boolean

O(1)
Aktywny
 isActive boolean

O(n)
daysSinceSuspension
 daysSinceSuspension integer

O(n)
totalSubscriptionCount
 totalSubscriptionCount integer

O(n)
uniqueSkus
 uniqueSkus array of string

O(n)
totalMonthlyRecurringFee
 totalMonthlyRecurringFee double

O(n)
totalMonthlyCostRecurringFee
 totalMonthlyCostRecurringFee double

O(n)
totalYearlyRecurringFee
 totalYearlyRecurringFee double

O(n)
totalYearlyCostRecurringFee
 totalYearlyCostRecurringFee double

O(n)
totalOtherRecurringFee
 totalOtherRecurringFee double

O(n), agregacja opłat cyklicznych z cyklem rozliczeniowym innym niż miesięczny lub roczny
totalOtherCostRecurringFee
 totalOtherCostRecurringFee double

O(n), agregacja opłat cyklicznych za pomocą cyklu rozliczeniowego innego niż miesięczny lub roczny
invoiceMetrics
 invoiceMetrics InvoiceMetrics

ProjectedPlatforms

Nazwisko Ścieżka Typ Opis
Identyfikator platformy
 platformId uuid
requiredParameters
 requiredParameters array of PlatformRequiredParameter

Połączenie dodatkowe O(1)

Przewidywany kosztinformacji

Nazwisko Ścieżka Typ Opis
cyklicznefee
 recurringFee double
setupFee
 setupFee double
waluta
 currency ProjectedCurrency
billingCycle
 billingCycle string

ProjectedRenewalConfiguration

Nazwisko Ścieżka Typ Opis
isConfigurable
 isConfigurable boolean
renewSettings
 renewSettings ProjectedRenewSettings

ProjectedRenewSettings

Nazwisko Ścieżka Typ Opis
renewalDate (data odnowienia)
 renewalDate date-time
scheduledQuantity
 scheduledQuantity integer
coTerminationEndDate
 coTerminationEndDate date-time

Przewidywany podsubskrypcja

Nazwisko Ścieżka Typ Opis
subscriptionId
 subscriptionId uuid

O(1)
identyfikator organizacji
 organizationId uuid

O(1)
anulowane
 cancelledOn date-time

O(n)
Aktywny
 isActive boolean

O(n)
daysSinceCreation
 daysSinceCreation integer

O(n)
createdOn (Utworzony On)
 createdOn date-time

O(1)
ilość
 quantity integer

O(1)
commitmentTerm
 commitmentTerm ProjectedCommitmentTerm
daysUntilRenewal
 daysUntilRenewal integer

O(n)
sherwebSku
 sherwebSku string

O(1)
microsoftSkus
 microsoftSkus array of string

O(n)
opis
 description string

O(1)
expirationDate
 expirationDate date-time

O(1)
lastRenewalDate
 lastRenewalDate date-time

O(n)
opłaty
 fees ProjectedFeesDto
productName
 productName string

O(1)
isCoterminated
 isCoterminated boolean

O(n)
historia
 history array of SubscriptionHistoryEvent

O(n)

RenewedTermEndDateDetail

Nazwisko Ścieżka Typ Opis
previousDate
 previousDate date
newDate
 newDate date

RenewedTermStartDateDetail

Nazwisko Ścieżka Typ Opis
previousDate
 previousDate date
newDate
 newDate date

SkuDetail

Nazwisko Ścieżka Typ Opis
sku
 sku string
skuName
 skuName string

SubscriptionHistoryEvent

Nazwisko Ścieżka Typ Opis
createdOn (Utworzony On)
 createdOn date-time
liczba licencji
 licenseCount integer
sku
 sku string
offerName
 offerName string
użytkownik
 user string
coTerminationDate
 coTerminationDate string
źródło zdarzeń
 eventSource EventSource
termEndDateDetail
 termEndDateDetail RenewedTermEndDateDetail
termStartDateDetail
 termStartDateDetail RenewedTermStartDateDetail

SubskrypcjeAmendment

Nazwisko Ścieżka Typ Opis
subscriptionsAmendmentId
 subscriptionsAmendmentId uuid
trackingId (identyfikator śledzenia)
 trackingId TrackingId

SubskrypcjeKonskrypcja

Nazwisko Ścieżka Typ Opis
subscriptionsCancellationId
 subscriptionsCancellationId uuid
trackingId (identyfikator śledzenia)
 trackingId TrackingId

TrackingId

Nazwisko Ścieżka Typ Opis
requestTrackingId
 requestTrackingId uuid

ValidateOrderLineItem

Nazwisko Ścieżka Typ Opis
numer linii
 lineNumber integer
sku
 sku string
name
 name string
billingCycle
 billingCycle string
commitmentTerm
 commitmentTerm string
ilość
 quantity integer
cena jednostkowa
 unitPrice double
Cena rozszerzona
 extendedPrice double
waluta
 currency string

ValidateOrderResult

Nazwisko Ścieżka Typ Opis
komunikat
 message string
lineItems
 lineItems array of ValidateOrderLineItem
Suma częściowa
 subtotal double
waluta
 currency string

ciąg

Jest to podstawowy typ danych "string".