Risorse per promozioni

Si applica a

• Centro per i partner

Ruoli appropriati

• Agente amministrativo

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 ulteriori informazioni, consultare la panoramica delle nuove esperienze commerciali.

Descrive le risorse per le promozioni applicate alle transazioni per le nuove sottoscrizioni commerciali.

Promozione

Sconto applicato quando si acquista uno SKU di prodotto se vengono soddisfatti i criteri di idoneità.

Proprietà	Tipo	Descrizione
id	string	Identificatore di promozione.
nome	string	Nome descrittivo della promozione.
descrizione	string	Descrizione della promozione.
data di inizio	string	Data di inizio dell'applicabilità della promozione.
data di fine	string	La data di fine applicazione della promozione.
ProdottiRichiesti	elenco di prodotti richiesti	Dettagli sul prodotto, SKU e politiche di prezzo a cui si applica la promozione.
proprietà	elenco di proprietà	Proprietà per la promozione, incluso se l'innalzamento di livello è applicabile automaticamente.

ProdottiRichiesti

I dettagli sui prodotti, SKU e le politiche di prezzo a cui si applica la promozione.

Proprietà	Tipo	Descrizione
productId	string	Un identificatore del prodotto per cui è disponibile la promozione.
skuId	string	Un identificatore dello SKU per cui è disponibile la promozione.
Termine	Termine	Un termine che include la durata e il ciclo di fatturazione per cui è disponibile la promozione.
politiche di pricing	Elenco delle politiche di prezzo	Elenco di criteri che definiscono i tipi e i valori di sconto promozionali.

Termine

Rappresenta un termine per il quale è possibile acquistare la promozione.

Proprietà	Tipo	Descrizione
durata	string	Rappresentazione ISO 8601 della durata del termine. I valori supportati correnti sono P1M (un mese), P1Y (un anno) e P3Y (tre anni).
ciclo di fatturazione	string	Descrive la frequenza con cui verrà applicata la promozione alla fatturazione. I valori possono includere Monthly, Annual, OneTime o Unknown.

Politiche di Prezzo

Descrivere i tipi e i valori di sconto promozionali.

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

Proprietà

Proprietà per la promozione.

Proprietà	Tipo	Descrizione
èAutoApplicabile	bool	Indica se l'innalzamento di livello viene applicato automaticamente o se deve essere passato dal partner.

ElementoRichiestaIdoneitàPromozioni

Proprietà che rappresentano una transazione e l'idoneità di una promozione.

Proprietà	Tipo	Descrizione
id	int	Identificatore dell'elemento di idoneità delle promozioni.
catalogItemId	string	L'identificatore dell'elemento del catalogo a cui verrà applicata la promozione. Include ID prodotto, ID SKU e ID di disponibilità.
quantità	int	Numero di licenze o istanze.
durata del termine	string	Rappresentazione ISO 8601 della durata del termine. I valori supportati correnti sono P1M (un mese), P1Y (un anno) e P3Y (tre anni).
ciclo di fatturazione	string	Descrive la frequenza con cui verrà applicata la promozione alla fatturazione. I valori possono includere Monthly, Annual, OneTime o Unknown.
promotionID	string	Identificatore di promozione.

Eleggibilità per le Promozioni

Elenco di prodotti, SKU e idoneità per la promozione.

Proprietà	Tipo	Descrizione
id	int	Identificatore dell'elemento di idoneità delle promozioni.
catalogItemId	string	L'identificatore dell'elemento del catalogo a cui verrà applicata la promozione. Include ID prodotto, ID SKU e ID di disponibilità.
quantità	int	Numero di licenze o istanze.
durata del termine	string	Rappresentazione ISO 8601 della durata del termine. I valori supportati correnti sono P1M (un mese), P1Y (un anno) e P3Y (tre anni).
ciclo di fatturazione	string	Descrive la frequenza con cui verrà applicata la promozione alla fatturazione. I valori possono includere Monthly, Annual, OneTime o Unknown.
idoneità	Elenco di Eligibilità alle promozioni	Rappresenta un elenco di risultati di idoneità per la promozione.

Idoneità alla Promozione

Elenco di prodotti, SKU e idoneità per la promozione.

Proprietà	Tipo	Descrizione
promotionId	string	Identificatore di promozione.
èIdoneo	bool	Descrive se la promozione è idonea per l'elemento di richiesta di idoneità specificato.
errori	Elenco degli Errori di Idoneità alla Promozione	Errori che descrivono il motivo per cui un elemento di richiesta di idoneità alla promozione non è idoneo.

ErroreIdoneitàPromozione

Spiega perché un elemento della richiesta di idoneità alla promozione non è stato idoneo.

Proprietà	Tipo	Descrizione
tipo	string	I tipi di errore di idoneità per la promozione possono includere ID articolo non valido nel catalogo (InvalidCatalogItemId), promozione non valida (InvalidPromotion), proprietà del prodotto prerequisito (PrerequisiteProductOwnership), limite di riscatto (RedemptionLimit), conteggio dei posti (SeatCount), offerta già acquistata (OfferPurchasedPreviously) o condizione (Term).
descrizione	string	Descrive se la promozione è idonea per l'elemento di richiesta di idoneità specificato.

ErroreDiIdoneitàPerLimiteDiRiscattoPromozione

Include informazioni dettagliate sul motivo per cui è stato superato il limite di riscatto.

Proprietà	Tipo	Descrizione
numeroMassimoRiscattiPromozione	int	Numero massimo di volte in cui è possibile acquisire una promozione.
conteggioRimastoRiscattiPromozione	int	Numero rimanente di volte in cui è possibile acquisire una promozione.

ErroreDiIdoneitàDellaPromozionePerIlNumeroDiPosti

Include informazioni dettagliate sul motivo per cui è stato superato il limite di conteggio dei posti. Tutti i valori sono nullable.

Proprietà	Tipo	Descrizione
postiMinimiRichiesti	int	Il numero minimo di licenze supportato da una promozione.
sediliRichiestiMassimi	int	Il numero massimo di licenze che una promozione supporterà.
posti disponibili	int	Il numero rimanente di licenze che un partner può acquisire per una determinata promozione.

Errore di idoneità alla promozione del termine

Include informazioni dettagliate sul motivo per cui il termine di promozione non è stato accettato.

Proprietà	Tipo	Descrizione
termini idonei	Termine della Promozione	I termini idonei che una promozione supporterà.

Termini della Promozione

Include informazioni dettagliate sul motivo per cui è stato superato il limite di conteggio dei posti.

Proprietà	Tipo	Descrizione
ciclo di fatturazione	string	Descrive la frequenza con cui verrà applicata la promozione alla fatturazione. I valori possono includere Monthly, Annual, OneTime o Unknown.
durata	string	Durata del periodo di acquisto.