Recursos de promoções
Aplica-se a
- Partner Center
Funções apropriadas
- Agente de administração
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 aplicados a transações para novas assinaturas de comércio.
Promoção
Desconto aplicado na compra de 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 para quando a promoção é aplicável. |
| endDate | string | A data de término para quando a promoção é aplicável. |
| requiredProducts | lista de produtos necessários | Detalhes do produto, SKU e políticas de preços para as quais a promoção é aplicável. |
| properties | lista de propriedades | Propriedades da promoção, incluindo se a promoção é autoaplicável. |
Produtos Obrigatórios
Detalhes do produto, SKU e políticas de preços para as quais 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. |
| term | Termo | Um período que inclui a duração do prazo e o ciclo de cobrança 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 de promoção. |
Termo
Representa um prazo pelo qual a promoção pode ser comprada.
| Propriedade | Type | Descrição |
|---|---|---|
| duration | string | Uma representação ISO 8601 da duração do prazo. Os valores atuais suportados 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 ao faturamento. Os valores podem incluir Mensal, Anual, Único ou Desconhecido. |
Políticas de preços
Descreva os tipos e valores de desconto da promoção.
| Propriedade | Type | Descrição |
|---|---|---|
| type | string | Descreva se o desconto é baseado em porcentagens ou descontos de taxa fixa. |
| value | string | Define o valor do desconto aplicado. |
Propriedades
Propriedades para a promoção.
| Propriedade | Type | Descrição |
|---|---|---|
| isAutoApplicable | bool | Indica se a promoção é aplicada automaticamente ou se precisa ser passada pelo parceiro. |
PromoçãoEligibilidadesRequestItem
Propriedades que representam uma transação e a qualificação de uma promoção.
| Propriedade | Type | Descrição |
|---|---|---|
| ID | INT | As promoções elegem o identificador do item. |
| catalogItemId | string | O identificador do item de catálogo ao qual a promoção será aplicada. Inclui ID do produto, ID do SKU e ID de disponibilidade. |
| quantity | int | O número de licenças ou instâncias. |
| termDuration | string | Uma representação ISO 8601 da duração do prazo. Os valores atuais suportados 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 ao faturamento. Os valores podem incluir Mensal, Anual, Único ou Desconhecido. |
| ID da promoção | string | O identificador de promoção. |
PromoçãoEligibilidades
Uma lista de produtos, SKUs e suas elegibilidades de promoção.
| Propriedade | Type | Descrição |
|---|---|---|
| ID | INT | As promoções elegem o identificador do item. |
| catalogItemId | string | O identificador do item de catálogo ao qual a promoção será aplicada. Inclui ID do produto, ID do SKU e ID de disponibilidade. |
| quantity | int | O número de licenças ou instâncias. |
| termDuration | string | Uma representação ISO 8601 da duração do prazo. Os valores atuais suportados 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 ao faturamento. Os valores podem incluir Mensal, Anual, Único ou Desconhecido. |
| elegibilidades | Lista de PromoçõesElegibilidades | Representa uma lista de resultados de qualificação para promoção. |
PromoçãoElegibilidade
Uma lista de produtos, SKUs e suas elegibilidades de promoção.
| Propriedade | Type | Descrição |
|---|---|---|
| promotionId | string | O identificador de promoção. |
| éElegível | 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 elegibilidades de promoção não era elegível. |
PromotionEligibilityError
Explica por que um item de solicitação de qualificação para promoção não estava qualificado.
| Propriedade | Type | Descrição |
|---|---|---|
| type | string | Os tipos de erro de qualificação da promoção podem incluir InvalidCatalogItemId, InvalidPromotion, PrerequisiteProductOwnership, RedemptionLimit, SeatCount, OfferPurchasedPrevious 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 o motivo pelo qual 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 licenças foi excedido. Todos os valores são anuláveis.
| Propriedade | Type | Descrição |
|---|---|---|
| minimumRequiredSeats | int | As licenças mínimas que uma promoção suportará. |
| maximumRequiredSeats | int | O máximo de licenças que uma promoção suportará. |
| disponíveisAssentos | int | 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 | Descrição |
|---|---|---|
| elegívelTermos | Termo de Promoção | Os termos elegíveis que uma promoção suportará. |
Termo de Promoção
Inclui detalhes sobre por que o limite de contagem de licenças foi excedido.
| Propriedade | Type | Descrição |
|---|---|---|
| billingCycle | string | Descreve a frequência com que a promoção será aplicada ao faturamento. Os valores podem incluir Mensal, Anual, Único ou Desconhecido. |
| duration | string | Duração do prazo que está sendo adquirido. |