Sherweb Platform MCP Server (anteprima)
Il server MCP Sherweb Cumulus offre agli assistenti di intelligenza artificiale l'accesso sicuro a Cumulus tramite il protocollo di contesto del modello. I partner MSP autorizzati possono usare il linguaggio naturale per recuperare le organizzazioni, le sottoscrizioni, il catalogo, la fatturazione e i dati di controllo, combinarli in risposte utili ed eseguire operazioni supportate, ad esempio l'inserimento di ordini e sottoscrizioni, all'interno delle autorizzazioni Cumulus.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Service | Classe | Regions |
|---|---|---|
| Copilot Studio | Premium | Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| App per la logica | Standard | Tutte le aree di App per la logica , ad eccezione delle seguenti: - aree Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Premium | Tutte le aree Power Apps ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Premium | Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Name | Supporto di Sherweb |
| URL | https://www.sherweb.com |
| support@sherweb.com |
| Metadati del connettore | |
|---|---|
| Editore | Intelligenza artificiale di Sherweb |
| Website | https://www.sherweb.com |
| Informativa sulla privacy | https://www.sherweb.com/legal/privacy-policy/ |
| Categorie | Operazioni IT; Gestione aziendale |
Sherweb Cumulus
Sherweb è un provider di soluzioni cloud che consente ai provider di servizi gestiti di gestire clienti, sottoscrizioni, fatturazione e catalogo tramite la piattaforma Cumulus . Il connettore Cumulus MCP (Model Context Protocol) espone i dati cumulus direttamente agli assistenti di intelligenza artificiale, ad esempio gli agenti Microsoft Copilot Studio, in modo da poter eseguire query e agire sul business MSP in linguaggio naturale.
Con questo connettore è possibile porre domande sull'assistente intelligenza artificiale, ad esempio:
- "Elencare tutte le sottoscrizioni fino al rinnovo nei prossimi 60 giorni".
- "Quale delle mie organizzazioni non ha un prodotto di backup?"
- "Quali sono le prime 10 organizzazioni in base ai ricavi ricorrenti?"
- "Effettuare un ordine per l'organizzazione Contoso".
Prerequisites
- Un account Cumulus attivo con il ruolo Provider di servizi .
- Chiave API Cumulus specifica del rivenditore con gli
mcp:toolsambiti eservice-provider. - Ambiente Microsoft Power Platform in cui è installata la soluzione di connettore Sherweb Platform.
Creazione di credenziali rivenditore
Ogni rivenditore usa le proprie credenziali client OAuth esistenti durante la creazione di una connessione al connettore; questo flusso non usa registrazione client dinamica (DCR) o un ID client condiviso e un segreto client.
https://helpdesk.sherweb.com/en-us/knowledge-base/articles/KA-05021
- Accedere a Cumulus.
- Passare a Impostazioni piattaforma → API.
- Creare una chiave API separata per il rivenditore o selezionare la chiave esistente del rivenditore.
- Verificare che la chiave abbia gli
mcp:toolsambiti eservice-provider. Copiare l'ID client e il segreto client; il segreto viene visualizzato solo quando viene creato. - Aggiungere l'URI di reindirizzamento visualizzato per il connettore Sherweb Platform installato alla chiave API.
Endpoint OAuth
| Field | Value |
|---|---|
| URL di autorizzazione | https://cumulus.sherweb.com/oidc/connect/authorize |
| URL del token | https://cumulus.sherweb.com/oidc/connect/token |
| Aggiorna URL | https://cumulus.sherweb.com/oidc/connect/token |
| Ambiti | mcp:tools service-provider |
Creazione di una connessione
https://helpdesk.sherweb.com/en-us/knowledge-base/articles/KA-05021
- In Power Platform selezionare il connettore Sherweb Platform installato e creare una connessione.
- Immettere l'ID client del rivenditore e il segreto client quando richiesto. Queste credenziali vengono archiviate in modo sicuro dalla connessione e vengono usate per l'autorizzazione OAuth e l'aggiornamento del token del rivenditore.
- Accedere a Cumulus con un account utente autorizzato per tale rivenditore.
- Se la connessione non è in grado di completare l'autorizzazione, verificare che l'URI di reindirizzamento del connettore sia registrato nella chiave API del rivenditore e che entrambi gli ambiti obbligatori siano abilitati.
Creare una connessione separata per ogni rivenditore. L'ID client e il segreto client identificano l'applicazione OAuth del rivenditore; l'accesso interattivo determina l'account utente autorizzato a usare la connessione.
Il rinnovo del token usa la concessione del token di aggiornamento OAuth e le credenziali fornite per tale connessione, anziché ripetere lo scambio di codice di autorizzazione.
Per i client MCP diretti (anziché il connettore Power Platform certificato), configurare OAuth https://mcp.sherweb.com rispetto all'uso degli endpoint e degli ambiti precedenti. La configurazione dell'autenticazione client MCP diretta è separata dai campi delle credenziali specifiche del rivenditore nel connettore Power Platform.
Operazioni supportate
strumenti Read-Only
| Tool | Description |
|---|---|
QueryOrganizations |
Eseguire query sulle organizzazioni gestite dal provider di servizi usando GraphQL. |
QuerySubscriptions |
Eseguire query sulle sottoscrizioni tra organizzazioni usando GraphQL. |
QueryOrganizationConsumptions |
Eseguire query sui dati sull'utilizzo (utilizzo e addebiti) per le organizzazioni che usano GraphQL. |
QueryCatalog |
Eseguire una query sul catalogo prodotti disponibile per il provider di servizi usando GraphQL. |
QueryAuditLogs |
Eseguire una query sul log di controllo delle azioni eseguite sulla piattaforma usando GraphQL. |
GetGraphQLSchema |
Recuperare lo schema GraphQL completo per creare query valide. |
GetCopilotSkus |
Ottenere l'elenco degli SKU Sherweb per Microsoft Copilot offerte. |
Strumenti di scrittura
Nota: Le operazioni di scrittura richiedono le autorizzazioni appropriate per l'account Cumulus autenticato.
| Tool | Description |
|---|---|
PlaceOrder |
Inserire un ordine di prodotto per un'organizzazione cliente. |
ValidateQuote |
Convalidare un ordine proposto e ottenere i dettagli sui prezzi senza effettuare l'ordine. |
CreateSubscriptionsAmendment |
Modificare la quantità di postazioni o licenze per una o più sottoscrizioni esistenti. |
CancelSubscriptions |
Annullare una o più sottoscrizioni per un'organizzazione del cliente. |
ConfigurePlatform |
Configurare una piattaforma (ad esempio, Microsoft 365 tenant) per un cliente. |
Esempio di Richieste
Di seguito sono riportati alcuni esempi di richieste in linguaggio naturale che è possibile usare con un assistente di intelligenza artificiale connesso a questo server MCP:
Rinnovi e fatturazione
- "Elencare tutte le sottoscrizioni fino al rinnovo nei prossimi 60 giorni".
- "Dammi un dettaglio di tutti gli addebiti per l'organizzazione Contoso negli ultimi 3 mesi".
- "Quali sottoscrizioni scadono entro 30 giorni in tutte le organizzazioni?"
Inventario e portafoglio
- "Quale delle mie organizzazioni non ha un prodotto di backup?"
- "Quali sono le prime 10 organizzazioni in base ai ricavi ricorrenti?"
- "Mostra tutte le sottoscrizioni annullate di recente."
- "Elencare tutte le offerte di prodotto che includono uno SKU Copilot."
Actions
- "Effettuare un ordine per 5 postazioni di Microsoft 365 Business Premium per l'organizzazione Contoso".
- "Convalidare un preventivo per 10 postazioni di Azure Piano per l'organizzazione Fabrikam".
- "Ridurre la quantità di postazioni Exchange Online per l'organizzazione Contoso da 20 a 15".
Problemi noti e limitazioni
- Profondità query GraphQL: è possibile che si verifichi un timeout delle query GraphQL molto annidate. Se si verifica il timeout di una query, semplificarla riducendo la profondità di annidamento o il numero di campi richiesti.
-
Paginazione obbligatoria: elencare le query (
QueryOrganizations,QuerySubscriptionse così via) richiedono argomenti di impaginazione (after/firsto ).last/beforeLe query senza impaginazione restituiranno un errore. -
Ambiti: assicurarsi che sia
mcp:toolscheservice-providersiano inclusi negli ambiti OAuth durante la creazione della chiave API. Entrambi gli ambiti mancanti genereranno errori di autenticazione.
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Predefinita | Parametri per la creazione della connessione. | Tutte le aree geografiche | Non condivisibile |
Predefinito
Applicabile: tutte le aree
Parametri per la creazione della connessione.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
| Name | Type | Description | Required |
|---|---|---|---|
| ID client rivenditore | string | Immettere l'ID client rilasciato per questo rivenditore. | True |
| Segreto client rivenditore | securestring | Immettere il segreto client rilasciato per questo rivenditore. | True |
Azioni
| Annullare le sottoscrizioni per un'organizzazione |
Annullare le sottoscrizioni per un'organizzazione. |
| Configurare una piattaforma per un cliente |
Configurare una piattaforma per un cliente. |
| Convalidare un'offerta senza inserire l'ordine |
Convalidare un'offerta senza inserire l'ordine. |
| Effettuare un ordine per un cliente |
Effettuare un ordine per un cliente. |
| Eseguire query sugli elementi del catalogo usando GraphQL |
Eseguire query sugli elementi del catalogo usando GraphQL. |
| Eseguire query sui consumi dell'organizzazione con GraphQL |
Eseguire query sui consumi dell'organizzazione usando GraphQL. |
| Eseguire query sui log di controllo con GraphQL |
Eseguire query sui log di controllo usando GraphQL. |
| Eseguire query sulle organizzazioni con GraphQL |
Eseguire query sulle organizzazioni usando GraphQL. |
| Eseguire query sulle sottoscrizioni con GraphQL |
Eseguire query sulle sottoscrizioni usando GraphQL. |
| Modificare le quantità di sottoscrizioni |
Modificare le quantità di sottoscrizioni. |
| Ottenere gli SKU Sherweb mappati alle offerte di Microsoft Copilot |
Ottenere gli SKU Sherweb mappati alle offerte di Microsoft Copilot. |
| Ottenere lo schema GraphQL in formato SDL |
Ottenere lo schema GraphQL in formato SDL. |
Annullare le sottoscrizioni per un'organizzazione
Annullare le sottoscrizioni per un'organizzazione.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
organizationId
|
organizationId | True | uuid | |
|
subscriptionIds
|
subscriptionIds | True | array of uuid |
Valori restituiti
Configurare una piattaforma per un cliente
Configurare una piattaforma per un cliente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID cliente
|
customerId | True | uuid | |
|
platformId
|
platformId | True | uuid | |
|
identificatore
|
identifier | True | string | |
|
valore
|
value | string |
Valori restituiti
- response
- string
Convalidare un'offerta senza inserire l'ordine
Convalidare un'offerta senza inserire l'ordine.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID cliente
|
customerId | True | uuid | |
|
sku
|
sku | True | string | |
|
quantità
|
quantity | integer | ||
|
purchaseOrderNumber
|
purchaseOrderNumber | string | ||
|
orderedBy
|
orderedBy | True | string |
Valori restituiti
- Corpo
- ValidateOrderResult
Effettuare un ordine per un cliente
Effettuare un ordine per un cliente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID cliente
|
customerId | True | uuid | |
|
sku
|
sku | True | string | |
|
quantità
|
quantity | integer | ||
|
purchaseOrderNumber
|
purchaseOrderNumber | string | ||
|
orderedBy
|
orderedBy | True | string |
Valori restituiti
- Corpo
- PlaceOrderResponse
Eseguire query sugli elementi del catalogo usando GraphQL
Eseguire query sugli elementi del catalogo usando GraphQL.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
graphqlQuery
|
graphqlQuery | True | string |
Valori restituiti
Tipo di connessione generico per la paginazione basata su cursore, "T"Tipo di elementi nella connessione
Eseguire query sui consumi dell'organizzazione con GraphQL
Eseguire query sui consumi dell'organizzazione usando GraphQL.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
graphqlQuery
|
graphqlQuery | True | string |
Valori restituiti
Tipo di connessione generico per la paginazione basata su cursore, "T"Tipo di elementi nella connessione
Eseguire query sui log di controllo con GraphQL
Eseguire query sui log di controllo usando GraphQL.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
graphqlQuery
|
graphqlQuery | True | string |
Valori restituiti
Tipo di connessione generico per la paginazione basata su cursore, "T"Tipo di elementi nella connessione
Eseguire query sulle organizzazioni con GraphQL
Eseguire query sulle organizzazioni usando GraphQL.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
graphqlQuery
|
graphqlQuery | True | string |
Valori restituiti
Tipo di connessione generico per la paginazione basata su cursore, "T"Tipo di elementi nella connessione
Eseguire query sulle sottoscrizioni con GraphQL
Eseguire query sulle sottoscrizioni usando GraphQL.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
graphqlQuery
|
graphqlQuery | True | string |
Valori restituiti
Tipo di connessione generico per la paginazione basata su cursore, "T"Tipo di elementi nella connessione
Modificare le quantità di sottoscrizioni
Modificare le quantità di sottoscrizioni.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
organizationId
|
organizationId | True | uuid | |
|
subscriptionId
|
subscriptionId | True | uuid | |
|
newQuantity
|
newQuantity | integer |
Valori restituiti
- Corpo
- SubscriptionsAmendment
Ottenere gli SKU Sherweb mappati alle offerte di Microsoft Copilot
Ottenere gli SKU Sherweb mappati alle offerte di Microsoft Copilot.
Valori restituiti
- response
- array of SkuDetail
Ottenere lo schema GraphQL in formato SDL
Definizioni
Scelta
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
parameterChoiceValue
|
parameterChoiceValue | string | |
|
parameterChoiceDisplayName
|
parameterChoiceDisplayName | string |
ConnectionOfProjectedAuditLog
Tipo di connessione generico per la paginazione basata su cursore, "T"Tipo di elementi nella connessione
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Margini
|
edges | array of EdgeOfProjectedAuditLog |
Elenco di bordi in questa pagina. Ogni bordo contiene il nodo e il relativo cursore. |
|
nodes
|
nodes | array of ProjectedAuditLog |
Elenco bidimensionale dei nodi in questa pagina (senza metadati del cursore). |
|
conteggio totale
|
totalCount | integer |
Numero totale di elementi in tutte le pagine (se richiesto) |
|
pageInfo
|
pageInfo | PageInfo |
Metadati di paginazione per lo spostamento basato su cursore. |
ConnectionOfProjectedCatalogItem
Tipo di connessione generico per la paginazione basata su cursore, "T"Tipo di elementi nella connessione
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Margini
|
edges | array of EdgeOfProjectedCatalogItem |
Elenco di bordi in questa pagina. Ogni bordo contiene il nodo e il relativo cursore. |
|
nodes
|
nodes | array of ProjectedCatalogItem |
Elenco bidimensionale dei nodi in questa pagina (senza metadati del cursore). |
|
conteggio totale
|
totalCount | integer |
Numero totale di elementi in tutte le pagine (se richiesto) |
|
pageInfo
|
pageInfo | PageInfo |
Metadati di paginazione per lo spostamento basato su cursore. |
ConnectionOfProjectedConsumptionItem
Tipo di connessione generico per la paginazione basata su cursore, "T"Tipo di elementi nella connessione
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Margini
|
edges | array of EdgeOfProjectedConsumptionItem |
Elenco di bordi in questa pagina. Ogni bordo contiene il nodo e il relativo cursore. |
|
nodes
|
nodes | array of ProjectedConsumptionItem |
Elenco bidimensionale dei nodi in questa pagina (senza metadati del cursore). |
|
conteggio totale
|
totalCount | integer |
Numero totale di elementi in tutte le pagine (se richiesto) |
|
pageInfo
|
pageInfo | PageInfo |
Metadati di paginazione per lo spostamento basato su cursore. |
ConnectionOfProjectedOrganization
Tipo di connessione generico per la paginazione basata su cursore, "T"Tipo di elementi nella connessione
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Margini
|
edges | array of EdgeOfProjectedOrganization |
Elenco di bordi in questa pagina. Ogni bordo contiene il nodo e il relativo cursore. |
|
nodes
|
nodes | array of ProjectedOrganization |
Elenco bidimensionale dei nodi in questa pagina (senza metadati del cursore). |
|
conteggio totale
|
totalCount | integer |
Numero totale di elementi in tutte le pagine (se richiesto) |
|
pageInfo
|
pageInfo | PageInfo |
Metadati di paginazione per lo spostamento basato su cursore. |
ConnectionOfProjectedSubscription
Tipo di connessione generico per la paginazione basata su cursore, "T"Tipo di elementi nella connessione
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Margini
|
edges | array of EdgeOfProjectedSubscription |
Elenco di bordi in questa pagina. Ogni bordo contiene il nodo e il relativo cursore. |
|
nodes
|
nodes | array of ProjectedSubscription |
Elenco bidimensionale dei nodi in questa pagina (senza metadati del cursore). |
|
conteggio totale
|
totalCount | integer |
Numero totale di elementi in tutte le pagine (se richiesto) |
|
pageInfo
|
pageInfo | PageInfo |
Metadati di paginazione per lo spostamento basato su cursore. |
EdgeOfProjectedAuditLog
Bordo in una connessione impaginata basata su cursore contenente il nodo e il relativo cursore.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
node
|
node | ProjectedAuditLog | |
|
cursore
|
cursor | string |
Cursore per questo bordo, utilizzato per l'impaginazione basata su cursore. |
EdgeOfProjectedCatalogItem
Bordo in una connessione impaginata basata su cursore contenente il nodo e il relativo cursore.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
node
|
node | ProjectedCatalogItem | |
|
cursore
|
cursor | string |
Cursore per questo bordo, utilizzato per l'impaginazione basata su cursore. |
EdgeOfProjectedConsumptionItem
Bordo in una connessione impaginata basata su cursore contenente il nodo e il relativo cursore.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
node
|
node | ProjectedConsumptionItem | |
|
cursore
|
cursor | string |
Cursore per questo bordo, utilizzato per l'impaginazione basata su cursore. |
EdgeOfProjectedOrganization
Bordo in una connessione impaginata basata su cursore contenente il nodo e il relativo cursore.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
node
|
node | ProjectedOrganization | |
|
cursore
|
cursor | string |
Cursore per questo bordo, utilizzato per l'impaginazione basata su cursore. |
EdgeOfProjectedSubscription
Bordo in una connessione impaginata basata su cursore contenente il nodo e il relativo cursore.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
node
|
node | ProjectedSubscription | |
|
cursore
|
cursor | string |
Cursore per questo bordo, utilizzato per l'impaginazione basata su cursore. |
EventSource
InvoiceMetrics
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
periodRange
|
periodRange | InvoicePeriodRange | |
|
accumulateRecurringCost
|
accumulatedRecurringCost | double |
O(1) |
|
invoiceCount
|
invoiceCount | integer |
O(1) |
|
compoundMonthlyCostGrowthRate
|
compoundMonthlyCostGrowthRate | double |
O(1) |
|
costConcentrationRatio
|
costConcentrationRatio | double |
O(1) |
|
costVolatility
|
costVolatility | double |
O(1) |
InvoicePeriodRange
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
da
|
from | date |
O(1) |
|
to
|
to | date |
O(1) |
PageInfo
Metadati di paginazione per lo spostamento basato su cursore.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
hasNextPage
|
hasNextPage | boolean | |
|
hasPreviousPage
|
hasPreviousPage | boolean | |
|
startCursor
|
startCursor | string | |
|
endCursor
|
endCursor | string |
PlaceOrderResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
requestTrackingId
|
requestTrackingId | uuid | |
|
subscriptionIds
|
subscriptionIds | array of uuid |
PlatformRequiredParameter
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
parameterDescription
|
parameterDescription | string | |
|
parameterIdentifier
|
parameterIdentifier | string | |
|
parameterDefaultValue
|
parameterDefaultValue | string | |
|
parameterFormatType
|
parameterFormatType | string | |
|
parameterFormatPattern
|
parameterFormatPattern | string | |
|
parameterFormatChoices
|
parameterFormatChoices | array of Choice |
ProjectedAuditLog
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
id
|
id | integer | |
|
targetName
|
targetName | string | |
|
action
|
action | string | |
|
date
|
date | date-time | |
|
userDisplayName
|
userDisplayName | string | |
|
categoryName
|
categoryName | string | |
|
description
|
description | string | |
|
details
|
details | array of ProjectedAuditLogDetail |
ProjectedAuditLogDetail
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
propertyName
|
propertyName | string | |
|
oldValue
|
oldValue | string | |
|
newValue
|
newValue | string |
ProjectedCatalogItem
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
sku
|
sku | string |
O(1) |
|
name
|
name | string |
O(1) |
|
description
|
description | string |
O(1) |
|
billingCycle
|
billingCycle | string |
O(1) |
|
commitmentTerm
|
commitmentTerm | string |
O(1) |
|
pricingInformation
|
pricingInformation | ProjectedPricingInformation | |
|
Piattaforme
|
platforms | array of ProjectedPlatforms |
O(1) chiamata aggiuntiva |
ProjectedCommitmentTerm
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
type
|
type | ProjectedCommitmentTermType | |
|
Data di fine
|
endDate | date-time | |
|
renewalConfiguration
|
renewalConfiguration | ProjectedRenewalConfiguration |
ProjectedCommitmentTermType
ProjectedConsumptionItem
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
prodotto
|
product | string |
O(1) |
|
vendorName
|
vendorName | string |
O(1) |
|
totalQuantities
|
totalQuantities | integer |
O(1) |
|
consumedQuantities
|
consumedQuantities | integer |
O(1) |
|
availableQuantities
|
availableQuantities | integer |
O(1) |
ProjectedCurrency
ProjectedFeesDto
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ricorrenteFee
|
recurringFee | ProjectedMoney | |
|
setupFee
|
setupFee | ProjectedMoney | |
|
costRecurringFee
|
costRecurringFee | ProjectedMoney | |
|
billingCycle
|
billingCycle | string |
ProjectedMoney
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
valore
|
value | double | |
|
currency
|
currency | ProjectedCurrency | |
|
arrotondamento
|
rounding | integer |
ProjectedOrganization
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
id
|
id | uuid |
O(1) |
|
name
|
name | string |
O(1) |
|
nome unico
|
uniqueName | string |
O(1) |
|
parentId
|
parentId | uuid |
O(1) |
|
nomegenitore
|
parentName | string |
O(1) |
|
suspendedOn
|
suspendedOn | date-time |
O(n) |
|
isSuspended
|
isSuspended | boolean |
O(1) |
|
èCancellato
|
isDeleted | boolean |
O(1) |
|
isActive
|
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), Aggregazione delle tariffe ricorrenti con un billingCycle diverso da mensile o annuale |
|
totalOtherCostRecurringFee
|
totalOtherCostRecurringFee | double |
O(n), Aggregazione dei costi ricorrenti con un billingCycle diverso da mensile o annuale |
|
invoiceMetrics
|
invoiceMetrics | InvoiceMetrics |
ProjectedPlatforms
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
platformId
|
platformId | uuid | |
|
requiredParameters
|
requiredParameters | array of PlatformRequiredParameter |
O(1) chiamata aggiuntiva |
ProjectedPricingInformation
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ricorrenteFee
|
recurringFee | double | |
|
setupFee
|
setupFee | double | |
|
currency
|
currency | ProjectedCurrency | |
|
billingCycle
|
billingCycle | string |
ProjectedRenewalConfiguration
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
isConfigurable
|
isConfigurable | boolean | |
|
renewSettings
|
renewSettings | ProjectedRenewSettings |
ProjectedRenewSettings
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
renewalDate
|
renewalDate | date-time | |
|
scheduledQuantity
|
scheduledQuantity | integer | |
|
coTerminationEndDate
|
coTerminationEndDate | date-time |
ProjectedSubscription
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
subscriptionId
|
subscriptionId | uuid |
O(1) |
|
organizationId
|
organizationId | uuid |
O(1) |
|
cancelledOn
|
cancelledOn | date-time |
O(n) |
|
isActive
|
isActive | boolean |
O(n) |
|
daysSinceCreation
|
daysSinceCreation | integer |
O(n) |
|
createdOn
|
createdOn | date-time |
O(1) |
|
quantità
|
quantity | integer |
O(1) |
|
commitmentTerm
|
commitmentTerm | ProjectedCommitmentTerm | |
|
daysUntilRenewal
|
daysUntilRenewal | integer |
O(n) |
|
sherwebSku
|
sherwebSku | string |
O(1) |
|
microsoftSkus
|
microsoftSkus | array of string |
O(n) |
|
description
|
description | string |
O(1) |
|
expirationDate
|
expirationDate | date-time |
O(1) |
|
lastRenewalDate
|
lastRenewalDate | date-time |
O(n) |
|
tariffe
|
fees | ProjectedFeesDto | |
|
productName
|
productName | string |
O(1) |
|
isCoterminated
|
isCoterminated | boolean |
O(n) |
|
history
|
history | array of SubscriptionHistoryEvent |
O(n) |
RenewedTermEndDateDetail
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
previousDate
|
previousDate | date | |
|
newDate
|
newDate | date |
RenewedTermStartDateDetail
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
previousDate
|
previousDate | date | |
|
newDate
|
newDate | date |
SkuDetail
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
sku
|
sku | string | |
|
skuName
|
skuName | string |
SubscriptionHistoryEvent
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
createdOn
|
createdOn | date-time | |
|
licenseCount
|
licenseCount | integer | |
|
sku
|
sku | string | |
|
offerName
|
offerName | string | |
|
user
|
user | string | |
|
coTerminationDate
|
coTerminationDate | string | |
|
fonte di evento
|
eventSource | EventSource | |
|
termEndDateDetail
|
termEndDateDetail | RenewedTermEndDateDetail | |
|
termStartDateDetail
|
termStartDateDetail | RenewedTermStartDateDetail |
SottoscrizioniAmendment
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
subscriptionsAmendmentId
|
subscriptionsAmendmentId | uuid | |
|
trackingId
|
trackingId | TrackingId |
SubscriptionsCancellation
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
subscriptionsCancellationId
|
subscriptionsCancellationId | uuid | |
|
trackingId
|
trackingId | TrackingId |
TrackingId
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
requestTrackingId
|
requestTrackingId | uuid |
ValidateOrderLineItem
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
NumeroLinea
|
lineNumber | integer | |
|
sku
|
sku | string | |
|
name
|
name | string | |
|
billingCycle
|
billingCycle | string | |
|
commitmentTerm
|
commitmentTerm | string | |
|
quantità
|
quantity | integer | |
|
prezzo unitario
|
unitPrice | double | |
|
prezzo esteso
|
extendedPrice | double | |
|
currency
|
currency | string |
ValidateOrderResult
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
message
|
message | string | |
|
lineItems
|
lineItems | array of ValidateOrderLineItem | |
|
subtotale
|
subtotal | double | |
|
currency
|
currency | string |
string
Si tratta del tipo di dati di base 'string'.