Recursos promocionais

Artigo
09/27/2024

Aplica-se a

Partner Center

Funções apropriadas

Agente administrativo

Nota

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 (Provedor de Soluções na Nuvem). Para obter mais informações, consulte Visão geral de novas experiências comerciais.

Descreve os recursos para promoções aplicadas a transações para novas assinaturas comerciais.

Promoção

Desconto aplicado ao comprar um produto SKU se os critérios de elegibilidade forem atendidos.

Propriedade	Type	Descrição
id	string	O identificador da promoção.
nome	string	O nome amigável da promoção.
descrição	string	Uma descrição da promoção.
startDate	string	A data de início para quando a promoção é aplicável.
endDate	string	A data final para quando a promoção é aplicável.
Produtos necessários	lista de produtos necessários	Produto, detalhes de SKU e políticas de preços para as quais a promoção é aplicável.
propriedades	Lista de propriedades	Propriedades para a promoção, incluindo se a promoção é autoaplicável.

Produtos Necessários

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

Propriedade	Type	Description
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.
vigência	Termo	Um termo que inclui a duração do prazo e o ciclo de faturamento para o qual a promoção está disponível.
preçosPolíticas	Lista de preçosPolíticas	Uma lista de políticas que definem os tipos e valores de desconto da promoção.

Termo

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

Propriedade	Type	Description
duration	string	Uma representação ISO 8601 da duração do termo. Os valores suportados atuais são P1M (um mês), P1Y (um ano) e P3Y (três anos).
faturamentoCiclo	string	Descreve a frequência com que a promoção será aplicada ao faturamento. Os valores podem incluir Mensal, Anual, OneTime ou Desconhecido.

Políticas de Preços

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

Propriedade	Type	Description
tipo	string	Descreva se o desconto se baseia em percentagens ou descontos de taxa fixa.
valor	string	Define o valor do desconto aplicado.

Propriedades

Imóveis para a promoção.

Propriedade	Type	Description
isAutoApplicable	booleano	Indica se a promoção é aplicada automaticamente ou se precisa ser aprovada pelo parceiro.

PromoçãoElegibilidadesPedidoItem

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

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

PromoçõesElegibilidade

Uma lista de produtos, SKUs e suas elegibilidade para promoção.

Propriedade	Type	Descrição
id	número inteiro	O identificador do item de elegibilidade das promoções.
catalogItemId	string	O identificador de item de catálogo ao qual a promoção será aplicada. Inclui ID do produto, ID do SKU e ID de disponibilidade.
quantidade	número inteiro	O número de licenças ou instâncias.
termoDuração	string	Uma representação ISO 8601 da duração do termo. Os valores suportados atuais são P1M (um mês), P1Y (um ano) e P3Y (três anos).
faturamentoCiclo	string	Descreve a frequência com que a promoção será aplicada ao faturamento. Os valores podem incluir Mensal, Anual, Único Tempo ou Desconhecido.
Elegibilidade	Lista de Elegibilidade Promocional	Representa uma lista de resultados de elegibilidade da promoção.

PromoçãoElegibilidade

Uma lista de produtos, SKUs e suas elegibilidade para promoção.

Propriedade	Type	Description
promotionId	string	O identificador da promoção.
isElegível	booleano	Descreve se a promoção é qualificada para o item de solicitação de elegibilidade fornecido.
erros	Lista de PromoçãoElegibilidadeErros	Erros ao descrever por que um item de solicitação de elegibilidade para promoção não era elegível.

PromoçãoElegibilidadeErro

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

Propriedade	Type	Description
tipo	string	Os tipos de erro de elegibilidade da 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 elegibilidade fornecido.

RedemptionLimitPromotionEligibilityError

Inclui detalhes sobre o motivo pelo qual o limite de resgate foi excedido.

Propriedade	Type	Description
maxPromotionRedemptionCount	número inteiro	O número máximo de vezes que uma promoção pode ser adquirida.
remainingPromotionRedemptionCount	número inteiro	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	Description
mínimoRequiredSeats	número inteiro	As licenças mínimas que uma promoção suportará.
máximoRequiredSeats	número inteiro	O máximo de licenças que uma promoção suportará.
disponíveisAssentos	número inteiro	O número restante de licenças que um parceiro pode adquirir para uma determinada promoção.

TermPromotionEligibilityError

Inclui detalhes sobre o motivo pelo qual o termo da promoção não foi aceito.

Propriedade	Type	Description
elegívelTermos	PromoçãoTermo	Os termos elegíveis que uma promoção irá apoiar.

PromoçãoTermo

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

Propriedade	Type	Description
faturamentoCiclo	string	Descreve a frequência com que a promoção será aplicada ao faturamento. Os valores podem incluir Mensal, Anual, Único Tempo ou Desconhecido.
duration	string	Duração do prazo a ser adquirido.

Partilhar via