Recursos promocionais
Aplica-se a
- Centro de Parceiros
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 mais informações, consulte Visão geral das 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 | Tipo | 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. |
| data de início | string | A data de início em que a promoção é válida. |
| data de término | cadeia de caracteres | 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 | Tipo | 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. |
| 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 aquisição da promoção.
| Propriedade | Tipo | Descrição |
|---|---|---|
| duraçã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). |
| ciclo de faturamento | 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 | Tipo | Descrição |
|---|---|---|
| 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 | Tipo | Descrição |
|---|---|---|
| éAutomaticamenteAplicável | booleano | Indica se a promoção é aplicada automaticamente ou se precisa ser aprovada pelo parceiro. |
ItemDePedidoDeEligibilidadesParaPromoção
Propriedades que representam uma transação e a elegibilidade de uma promoção.
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | int | 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 | int | O número de licenças ou instâncias. |
| duração do termo | 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). |
| ciclo de faturamento | string | Descreve a frequência com que a promoção será aplicada ao faturamento. Os valores podem incluir Mensal, Anual, OneTime ou Desconhecido. |
| ID de promoção | corda | O identificador da promoção. |
PromoçõesElegibilidade
Uma lista de produtos, SKUs e suas elegibilidade para promoção.
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | int | O identificador do item de elegibilidade das promoções. |
| IdDoItemDoCatálogo | 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. |
| termo de duraçã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). |
| ciclo de faturamento | string | Descreve a frequência com que a promoção será aplicada ao faturamento. Os valores podem incluir Mensal, Anual, Único ou Desconhecido. |
| Elegibilidade | Lista de Elegibilidades de Promoção | Representa uma lista de resultados de elegibilidade para promoções. |
Elegibilidade para Promoção
Uma lista de produtos, SKUs e suas elegibilidade para promoção.
| Propriedade | Tipo | Descrição |
|---|---|---|
| promotionId | string | O identificador da promoção. |
| éElegível | bool | Descreve se a promoção é qualificada para o item de solicitação de elegibilidade fornecido. |
| erros | Lista de Erros de Elegibilidade de Promoção | Erros ao descrever por que um item de solicitação de elegibilidade para promoção não era elegível. |
Erro de Elegibilidade na Promoção
Explica por que um item de solicitação de elegibilidade de promoção não era elegível.
| Propriedade | Tipo | Descrição |
|---|---|---|
| tipo | corda | Os tipos de erro de elegibilidade da promoção podem incluir InvalidCatalogItemId (ID de item de catálogo inválido), InvalidPromotion (Promoção inválida), PrerequisiteProductOwnership (Propriedade de produto pré-requisito), RedemptionLimit (Limite de resgate), SeatCount (Contagem de lugares), OfferPurchasedPreviously (Oferta comprada anteriormente) ou Term (Termo). |
| descrição | string | Descreve se a promoção é qualificada para o item de solicitação de elegibilidade fornecido. |
ErroDeElegibilidadeDaPromoçãoLimiteDeRedenção
Inclui detalhes sobre o motivo pelo qual o limite de resgate foi excedido.
| Propriedade | Tipo | Descrição |
|---|---|---|
| contagemMaximaDeResgatesDaPromoção | int | O número máximo de vezes que uma promoção pode ser adquirida. |
| contagemRestanteDePromoçõesResgatáveis | número inteiro | O número restante de vezes que uma promoção pode ser adquirida. |
ErroDeElegibilidadeParaPromoçãoDeContagemDeAssentos
Inclui detalhes sobre por que o limite de contagem de assentos foi excedido. Todos os valores são anuláveis.
| Propriedade | Tipo | Descrição |
|---|---|---|
| assentosMínimosRequeridos | int | O número mínimo de licenças que uma promoção suportará. |
| lugaresRequeridosMáximos | int | O máximo de licenças que uma promoção suportará. |
| assentos disponíveis | int | O número restante de licenças que um parceiro pode adquirir para uma determinada promoção. |
Erro de Elegibilidade para Promoção de Termo
Inclui detalhes sobre o motivo pelo qual o termo da promoção não foi aceito.
| Propriedade | Tipo | Descrição |
|---|---|---|
| termos elegíveis | Termo de Promoção | Os termos elegíveis que uma promoção irá apoiar. |
Termo de Promoção
Inclui detalhes sobre por que o limite de contagem de assentos foi excedido.
| Propriedade | Tipo | Descrição |
|---|---|---|
| ciclo de faturamento | string | Descreve a frequência com que a promoção será aplicada ao faturamento. Os valores podem incluir Mensal, Anual, Único ou Desconhecido. |
| duração | string | Duração do prazo a ser adquirido. |