Condividi tramite

Risorse dei prodotti

  • Articolo

Risorse che rappresentano beni o servizi acquistabili. Include le risorse per descrivere il tipo di prodotto e la forma (SKU) e per verificare la disponibilità del prodotto in un inventario.

Prodotto

Rappresenta un bene o un servizio acquistabile. Un prodotto da solo non è un articolo acquistabile.

Proprietà Digitare Descrizione
Id Stringa ID di un prodotto.
titolo Stringa Titolo del prodotto.
descrizione Stringa Descrizione del prodotto.
tipo di prodotto TipoDiArticolo Oggetto che descrive la categorizzazione di tipo di questo prodotto.
isMicrosoftProduct Bool Indica se il prodotto è un prodotto Microsoft.
publisherName Stringa Nome dell'editore del prodotto, se disponibile.
link ProductLinks Collegamenti alle risorse contenuti all'interno del prodotto.

Tipo di elemento

Rappresenta il tipo di un prodotto.

Proprietà Digitare Descrizione
Id Stringa Identificatore del tipo.
nome visualizzato Stringa Nome visualizzato per un tipo di elemento.
sottotipo TipoElemento Opzionale. Oggetto che descrive una categorizzazione del sottotipo per un tipo di elemento.

Contiene un elenco di collegamenti per un Prodotto.

Proprietà Digitare Descrizione
SKU collegamento Collegamento per l'accesso agli SKU sottostanti.
link CollegamentiRisorsa Collegamenti alle risorse contenuti all'interno di una risorsa.

Sku

Rappresenta un'unità di mantenimento delle scorte (SKU) acquistabile in un prodotto.

Proprietà Digitare Descrizione
Id Stringa ID per lo SKU. L'ID è univoco solo all'interno del contesto del prodotto padre.
titolo Corda Titolo dello SKU.
descrizione Stringa Descrizione dello SKU.
ID prodotto Stringa ID del prodotto padre che contiene uno SKU.
quantità minima Int Quantità minima consentita per l'acquisto.
quantità massima Int Quantità massima consentita per l'acquisto.
isTrial Bool Indica se uno SKU è un elemento di valutazione.
cicliDiFatturazioneSupportati Matrice di stringhe Elenco dei cicli di fatturazione supportati per uno SKU. I valori supportati sono i nomi dei membri disponibili in BillingCycleType.
prerequisiti per l'acquisto Matrice di stringhe Elenco di passaggi o azioni prerequisiti necessari prima di acquistare un articolo. I valori supportati sono:
"InventoryCheck" - Indica che l'inventario dell'articolo deve essere valutato prima di tentare di acquistare un articolo.
"AzureSubscriptionRegistration" - Indica che è necessaria una sottoscrizione di Azure e deve essere registrata prima di tentare di acquistare un articolo.
variabiliInventario Matrice di stringhe Elenco di variabili necessarie per eseguire un controllo dell'inventario su un elemento. I valori supportati sono:
"CustomerId" - ID del cliente per il quale l'acquisto sarebbe dovuto.
"AzureSubscriptionId" - ID della sottoscrizione di Azure che verrebbe usata per un acquisto di prenotazione di Azure.
"ArmRegionName" - Area per cui verificare l'inventario. Questo valore deve corrispondere a "ArmRegionName" da DynamicAttributes dello SKU.
variabili di provisioning Matrice di stringhe Elenco di variabili che devono essere fornite nel contesto di provisioning di un elemento della riga carrello durante l'acquisto di un articolo. I valori supportati sono:
Ambito: l’ambito per l'acquisto di una prenotazione di Azure: "Singolo", "Condiviso".
"SubscriptionId" - ID della sottoscrizione di Azure che verrebbe usata per un acquisto di prenotazione di Azure.
"Duration" - Durata della prenotazione di Azure: "1Year", "3Year".
dynamicAttributes coppie chiave/valore Dizionario di proprietà dinamiche che si applicano a un elemento. Le proprietà in un dizionario sono dinamiche e possono cambiare senza preavviso. I partner devono evitare di creare dipendenze complesse da chiavi specifiche esistenti nel valore di una proprietà.
collegamenti ResourceLinks Collegamenti alle risorse contenuti nello SKU.
AttestazioniProprietà Attestazione delle Proprietà Proprietà di attestazione per uno SKU.
tipo di consumo Stringa È disponibile solo se lo SKU supporta il consumo, come l'eccedenza .
proprietàOffertaSpecializzata Elenco di specializedOfferProperties È disponibile solo se il prodotto appartiene al sottotipo di offerta specializzata.
impegno di acquisto minimo ImpegnoMinimoDiAcquisto Importo fisso allocato per i servizi di calcolo.

Attributi SKU dinamici

Proprietà rilevanti relative a nuovi prodotti e servizi basati sulle licenze commerciali.

Nota

Le nuove esperienze commerciali per i servizi basati su licenza includono molte nuove funzionalità e sono disponibili per tutti i provider di soluzioni cloud. Per altre informazioni, vedere panoramica delle nuove esperienze commerciali.

Proprietà Digitare Descrizione
hasConstraints Booleano Descrive se lo SKU contiene vincoli delle risorse
isAddon Booleano Descrive se lo SKU è un componente aggiuntivo
prerequisitoSkus matrice di stringhe Descrive i prodotti e gli SKU con cui il componente aggiuntivo può funzionare
upgradeTargetOffers matrice di stringhe Un elenco di prodotti e SKU a cui l'elemento può eseguire l'aggiornamento
istruzioni di conversione Elenco delle istruzioni di conversione Elenco di istruzioni applicabili alle operazioni di conversione

proprietàOffertaSpecializzata

Nota

Le nuove esperienze commerciali per i servizi basati su licenza includono molte nuove funzionalità e sono disponibili per tutti i provider di soluzioni cloud. Per altre informazioni, vedere panoramica delle nuove esperienze commerciali.

Applicabile solo per i sottoTipi di prodotto "SpecializedOffers"

Proprietà Digitare Descrizione
data di inizio Corda ID dei termini a cui si applicano le istruzioni
data di fine Stringa Opzioni che definiscono i rinnovi
Politiche di Prezzo Elenco delle politiche di prezzo Elenco di criteri che definiscono i tipi e i valori di sconto promozionali.

Impegno di Acquisto Minimo

Attributi della quantità minima di cui è possibile eseguire il commit nei servizi di calcolo.

Proprietà Digitare Descrizione
grano Stringa Periodo dell'impegno minimo di acquisto.
codiceValuta Dictionary<String, String> La "valuta" e il "simbolo" dell'importo minimo che è possibile impegnare.
importo Int Importo minimo di cui è possibile eseguire il commit nei servizi di calcolo.

Politiche di Prezzo

Descrivere i tipi e i valori di sconto promozionali.

Proprietà Digitare Descrizione
tipo Stringa Descrivere se lo sconto è basato su percentuali o sconti a tariffa fissa.
valore Stringa Definisce l'importo dello sconto applicato.

Disponibilità

Rappresenta una configurazione in cui uno SKU è disponibile per l'acquisto(ad esempio paese/area geografica, valuta e segmento del settore).

Proprietà Digitare Descrizione
Id Stringa ID per questa disponibilità. Questo ID è univoco solo nel contesto del prodotto padre e dell'unità di gestione delle scorte . Nota I ID di disponibilità possono cambiare nel tempo. I partner dovrebbero basarsi solo su questo valore entro un breve periodo dopo averlo recuperato.
productId Corda ID del prodotto che contiene questa disponibilità.
skuId Stringa ID dello SKU che contiene questa disponibilità.
catalogItemId Stringa Identificatore univoco per questo elemento nel catalogo. Questo ID deve essere inserito nelle proprietà OrderLineItem.OfferId o CartLineItem.CatalogItemId al momento dell'acquisto dello SKU principale. Nota Questo ID può cambiare nel tempo. È consigliabile basarsi solo su questo valore entro un breve periodo di tempo dopo il recupero. Deve essere accessibile e utilizzato solo al momento dell'acquisto.
valuta predefinita Stringa Valuta predefinita supportata per questa disponibilità.
segmento Corda Segmento di settore per questa disponibilità. I valori supportati sono: Commercial, Education, Government, NonProfit.
paese Stringa Paese o area geografica (in formato codice paese ISO) in cui si applica questa disponibilità.
è acquistabile Bool Indica se questa disponibilità è acquistabile.
èRinnovabile Bool Indica se questa disponibilità è rinnovabile.
Istruzioni per il rinnovo RenewalInstruction Rappresenta le istruzioni di rinnovo per una determinata disponibilità.
prodotto Prodotto Il prodotto a cui corrisponde questa disponibilità.
Sku SKU Lo SKU a cui corrisponde questa disponibilità.
Termini Matrice di risorse di termini Raccolta di termini applicabili a questa disponibilità.
campo da golf Collegamenti alle Risorse Collegamenti alle risorse contenuti nella disponibilità.

Istruzioni per il rinnovo

Nota

Le nuove esperienze commerciali per i servizi basati su licenza includono molte nuove funzionalità e sono disponibili per tutti i provider di soluzioni cloud. Per altre informazioni, vedere panoramica delle nuove esperienze commerciali.

Rappresenta le istruzioni di rinnovo per una determinata disponibilità.

Proprietà Digitare Descrizione
idTerminiApplicabili Matrice di stringhe Identificativi dei termini a cui si applicano le istruzioni
Opzioni di rinnovo Matrice di RenewalOption Opzioni che definiscono i rinnovi

Opzione di Rinnovo

Nota

Le nuove esperienze commerciali per i servizi basati su licenza includono molte nuove funzionalità e sono disponibili per tutti i provider di soluzioni cloud. Per altre informazioni, vedere panoramica delle nuove esperienze commerciali.

Rappresenta le istruzioni di rinnovo per una determinata disponibilità.

Proprietà Digitare Descrizione
renewToId Stringa Rappresenta il prodotto e lo SKU a cui eseguire il rinnovo
èAutoRinnovabile Bool Indica se la disponibilità può essere rinnovata automaticamente

Termine

Rappresenta un termine per il quale è possibile acquistare la disponibilità.

Proprietà Tipo Descrizione
durata Stringa Rappresentazione ISO 8601 della durata del termine. I valori supportati correnti sono P1M (un mese), P1Y (un anno) e P3Y (tre anni).
descrizione Stringa Descrizione del termine.

RichiestaVerificaInventario

Rappresenta una richiesta di controllo dell'inventario rispetto a determinati elementi del catalogo.

Proprietà Digitare Descrizione
targetItems Matrice di InventoryItem Elenco di elementi del catalogo che verranno valutati dal controllo dell'inventario.
inventoryContext Coppie chiave/valore Dizionario dei valori di contesto necessari per eseguire i controlli di inventario. Ogni SKU dei prodotti definirà quali valori (se presenti) sono necessari per eseguire questa operazione.
link CollegamentiRisorse Collegamenti alle risorse contenuti nella richiesta di controllo dell'inventario.

Elemento di Inventario

Rappresenta un singolo elemento in un'operazione di controllo dell'inventario. Questa risorsa viene usata per specificare gli elementi di destinazione in una richiesta di input e viene usata anche per rappresentare i risultati di output dell'operazione di controllo dell'inventario.

Proprietà Digitare Descrizione
productId Stringa (Obbligatorio) ID del prodotto .
skuId Stringa ID dello SKU . Quando si usa questa risorsa come input per una richiesta di inventario, questo valore è facoltativo. Se questo valore non viene specificato, tutti gli SKU nel prodotto verranno considerati come articoli di destinazione dell'operazione di controllo dell'inventario.
èLimitato Bool Indica se l'articolo è stato trovato con un inventario ristretto.
Restrizioni Matrice di InventoryRestriction Dettagli di eventuali restrizioni trovate per questo elemento. Questa proprietà verrà popolata solo se è "limitato" = "true".

Restrizione dell'Inventario

Rappresenta i dettagli di una restrizione dell'inventario. Questi dettagli sono applicabili solo per i risultati dell'output del controllo inventario, non per le richieste di input.

Proprietà Tipo Descrizione
codiceMotivo Stringa Codice che identifica il motivo della restrizione.
descrizione Stringa Descrizione della restrizione dell'inventario.
proprietà Coppie chiave/valore Il dizionario delle proprietà che possono fornire ulteriori dettagli sulla restrizione.

TipoDiCicloDiFatturazione

[Enum/dotnet/api/system.enum) con valori che indicano un tipo di ciclo di fatturazione.

Valore Posizione Descrizione
Sconosciuto 0 Inizializzatore di enumerazione.
Mensile 1 Indica che il partner verrà addebitato mensilmente.
Annuale 2 Indica che il partner verrà addebitato annualmente.
Nessuno 3 Indica che al partner non gli verrà addebitato alcun costo. Questo valore può essere usato per articoli di prova.
OneTime 4 Indica che il partner verrà addebitato una sola volta.
Triennale 5 Indica che al partner verrà addebitato un importo ogni tre anni.

AttestazioniProprietà

Rappresenta un tipo di attestazione e, se necessario per l'acquisto.

Proprietà Digitare Descrizione
tipo di attestazione Corda Indica il tipo di attestazione. I prodotti Windows 365 avranno il valore di Windows 365. Il testo dell'attestazione di Windows 365 è "Capisco che ogni persona che usa Windows 365 Business con Vantaggio Windows Hybrid deve avere anche una copia valida di Windows 10/11 Pro installata nel proprio dispositivo di lavoro principale".
forzaAttestazione Booleano Indica se l'attestazione è necessaria per l'acquisto.