Risorse per promozioni

Articolo
07/02/2024

Si applica a

Centro per i partner

Ruoli appropriati

Amministratore globale
Agente amministratore

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 la panoramica delle nuove esperienze commerciali.

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

Promotion

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

Proprietà	Type	Descrizione
id	string	Identificatore di promozione.
name	string	Nome descrittivo della promozione.
description	stringa	Descrizione della promozione.
startDate	string	Data di inizio per la data in cui è applicabile la promozione.
endDate	string	Data di fine per la data in cui la promozione è applicabile.
RequiredProducts	elenco di requiredProducts	I criteri di prodotto, SKU e prezzi per cui è applicabile l'innalzamento di livello.
proprietà	elenco di proprietà	Proprietà per la promozione, incluso se l'innalzamento di livello è applicabile automaticamente.

RequiredProducts

I criteri di prodotto, SKU e prezzi per cui è applicabile l'innalzamento di livello.

Proprietà	Type	Descrizione
productId	string	Un identificatore del prodotto per cui è disponibile la promozione.
skuId	string	È disponibile un identificatore dello SKU per cui è disponibile l'innalzamento di livello.
Termine di	Termine	È disponibile un termine che include la durata del periodo e il ciclo di fatturazione per cui è disponibile l'innalzamento di livello.
pricingPolicies	Elenco dei prezziCriteri	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à	Type	Descrizione
duration	string	Rappresentazione ISO 8601 della durata del termine. I valori supportati correnti sono P1M (un mese), P1Y (un anno) e P3Y (tre anni).
billingCycle	string	Descrive la frequenza con cui verrà applicata la promozione alla fatturazione. I valori possono includere Monthly, Annual, OneTime o Unknown.

PricingPolicies

Descrivere i tipi e i valori di sconto promozionali.

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

Proprietà

Proprietà per la promozione.

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

PromotionEligibilitiesRequestItem

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

Proprietà	Type	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à.
quantity	int	Numero di licenze o istanze.
termDuration	string	Rappresentazione ISO 8601 della durata del termine. I valori supportati correnti sono P1M (un mese), P1Y (un anno) e P3Y (tre anni).
billingCycle	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.

PromotionEligibilities

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

Proprietà	Type	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à.
quantity	int	Numero di licenze o istanze.
termDuration	string	Rappresentazione ISO 8601 della durata del termine. I valori supportati correnti sono P1M (un mese), P1Y (un anno) e P3Y (tre anni).
billingCycle	string	Descrive la frequenza con cui verrà applicata la promozione alla fatturazione. I valori possono includere Monthly, Annual, OneTime o Unknown.
idoneità	Elenco di PromotionEligibilities	Rappresenta un elenco di risultati di idoneità per la promozione.

PromotionEligibility

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

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

PromotionEligibilityError

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

Proprietà	Type	Descrizione
type	string	I tipi di errore di idoneità per la promozione possono includere InvalidCatalogItemId, InvalidPromotion, PrerequisiteProductOwnership, RedemptionLimit, SeatCount, OfferPurchasedPreviously o Term.
description	stringa	Descrive se la promozione è idonea per l'elemento di richiesta di idoneità specificato.

RedemptionLimitPromotionEligibilityError

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

Proprietà	Type	Descrizione
maxPromotionRedemptionCount	int	Numero massimo di volte in cui è possibile acquisire una promozione.
remainingPromotionRedemptionCount	int	Numero rimanente di volte in cui è possibile acquisire una promozione.

SeatCountPromotionEligibilityError

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

Proprietà	Type	Descrizione
minimumRequiredSeats	int	Le licenze minime supportate da una promozione.
maximumRequiredSeats	int	Le licenze massime supportate da una promozione.
availableSeats	int	Il numero rimanente di licenze che un partner può acquisire per una determinata promozione.

TermPromotionEligibilityError

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

Proprietà	Type	Descrizione
eligibleTerms	PromotionTerm	Le condizioni idonee verranno supportate da una promozione.

PromotionTerm

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

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

Condividi tramite