Share via

Recursos de promoções

  • Artigo

Aplica-se a

  • Partner Center

Funções apropriadas

  • Administrador global
  • Agente administrativo

Observação

As novas experiências de comércio para serviços baseados em licença incluem muitos recursos novos e estão disponíveis para todos os CSPs (provedores de soluções em nuvem). Para obter mais informações, confira a visão geral das novas experiências de comércio.

Descreve os recursos para promoções aplicadas a transações para novas assinaturas de comércio.

Promoção

Desconto aplicado ao comprar um SKU de produto se os critérios de qualificação forem atendidos.

Propriedade Type Descrição
id string O identificador de promoção.
name string O nome amigável da promoção.
descrição string Uma descrição da promoção.
startDate string A data de início de quando a promoção é aplicável.
endDate string A data de término de quando a promoção é aplicável.
requiredProducts lista de requiredProducts Produtos, detalhes de SKU e políticas de preços para os qual a promoção é aplicável.
properties lista de propriedades Propriedades para a promoção, incluindo se a promoção é aplicável automaticamente.

RequiredProducts

Produtos, detalhes de SKU e políticas de preços para os qual a promoção é aplicável.

Propriedade Type Descrição
productId string Um identificador do produto para o qual a promoção está disponível.
skuId string Um identificador do SKU para o qual a promoção está disponível.
Termo Termo Um termo que inclui a duração do prazo e ciclo de cobrança a promoção está disponível.
pricingPolicies Lista de pricingPolicies Uma lista de políticas que definem os tipos e valores de desconto de promoção.

Termo

Representa um termo para o qual a promoção pode ser comprada.

Propriedade Type Descrição
duration string Uma representação ISO 8601 da duração do termo. Os valores atuais com suporte são P1M (um mês), P1Y (um ano) e P3Y (três anos).
billingCycle string Descreve a frequência com que a promoção será aplicada à cobrança. Os valores podem incluir Monthly, Annual, OneTime ou Unknown.

PricingPolicies

Descreva os tipos de desconto e os valores de promoção.

Propriedade Type Descrição
type string Descreva se o desconto é baseado em percentuais ou descontos de taxa fixa.
value string Define o valor do desconto aplicado.

Propriedades

Propriedades da promoção.

Propriedade Type Descrição
isAutoApplicable bool Indica se a promoção é aplicada automaticamente ou se precisa ser passada pelo parceiro.

PromotionEligibilitiesRequestItem

Propriedades que representam uma transação e a qualificação de uma promoção.

Propriedade Type Descrição
id INT O identificador de item de qualificação de promoções.
catalogItemId string O identificador de item de catálogo ao qual a promoção será aplicada. Inclui ID do produto, ID de SKU e ID de disponibilidade.
quantidade INT O número de licenças ou instâncias.
termDuration string Uma representação ISO 8601 da duração do termo. Os valores atuais com suporte são P1M (um mês), P1Y (um ano) e P3Y (três anos).
billingCycle string Descreve a frequência com que a promoção será aplicada à cobrança. Os valores podem incluir Mensal, Anual, OneTime ou Desconhecido.
promotionID string O identificador de promoção.

PromotionEligibilities

Uma lista de produtos, SKUs e suas qualificações de promoção.

Propriedade Type Descrição
id INT O identificador de item de qualificações de promoções.
catalogItemId string O identificador de item de catálogo ao qual a promoção será aplicada. Inclui ID do produto, ID de SKU e ID de disponibilidade.
quantidade INT O número de licenças ou instâncias.
termDuration string Uma representação ISO 8601 da duração do termo. Os valores atuais com suporte são P1M (um mês), P1Y (um ano) e P3Y (três anos).
billingCycle string Descreve a frequência com que a promoção será aplicada à cobrança. Os valores podem incluir Mensal, Anual, OneTime ou Desconhecido.
qualificações Lista de PromotionEligibilities Representa uma lista de resultados de qualificação da promoção.

PromotionEligibility

Uma lista de produtos, SKUs e suas qualificações de promoção.

Propriedade Type Descrição
promotionId string O identificador de promoção.
isEligible bool Descreve se a promoção é qualificada para o item de solicitação de qualificação especificado.
erros Lista de PromotionEligibilityErrors Erros que descrevem por que um item de solicitação de qualificação de promoção não era qualificado.

PromotionEligibilityError

Explica por que um item de solicitação de qualificação de promoção não era qualificado.

Propriedade Type Descrição
type string Os tipos de erro de qualificação de promoção podem incluir InvalidCatalogItemId, InvalidPromotion, PrerequisiteProductOwnership, RedemptionLimit, SeatCount, OfferPurchasedPreviously ou Term.
descrição string Descreve se a promoção é qualificada para o item de solicitação de qualificação especificado.

RedemptionLimitPromotionEligibilityError

Inclui detalhes sobre por que o limite de resgate foi excedido.

Propriedade Type Descrição
maxPromotionRedemptionCount INT O número máximo de vezes que uma promoção pode ser adquirida.
remainingPromotionRedemptionCount INT O número restante de vezes que uma promoção pode ser adquirida.

SeatCountPromotionEligibilityError

Inclui detalhes sobre por que o limite de contagem de assentos foi excedido. Todos os valores são anuláveis.

Propriedade Type Descrição
minimumRequiredSeats INT As licenças mínimas que uma promoção dará suporte.
maximumRequiredSeats INT As licenças máximas que uma promoção dará suporte.
availableSeats INT O número restante de licenças que um parceiro pode adquirir para uma determinada promoção.

TermPromotionEligibilityError

Inclui detalhes sobre por que o termo de promoção não foi aceito.

Propriedade Type Descrição
eligibleTerms PromotionTerm Os termos qualificados aos quais uma promoção dará suporte.

PromotionTerm

Inclui detalhes sobre por que o limite de contagem de assentos foi excedido.

Propriedade Type Descrição
billingCycle string Descreve a frequência com que a promoção será aplicada à cobrança. Os valores podem incluir Monthly, Annual, OneTime ou Unknown.
duration string Duração do termo que está sendo comprado.