Condividi tramite


Risorse per promozioni

Si applica a

  • Centro per i partner

Ruoli appropriati

  • 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.