Partager via

Ressources de promotion

  • Article

S’applique à

  • Espace partenaires

Rôles appropriés

  • Administrateur général
  • Agent administrateur

Remarque

Les nouvelles expériences commerciales pour les services basés sur des licences incluent de nombreuses nouvelles fonctionnalités et sont disponibles pour tous les Fournisseur de solutions Cloud (CSP). Pour plus d’informations, consultez la Vue d’ensemble des nouvelles expériences commerciales.

Décrit les ressources pour les promotions appliquées aux transactions pour les nouveaux abonnements commerciaux.

Promotion

Remise appliquée lors de l’achat d’une référence SKU de produit si les critères d’éligibilité sont satisfaits.

Propriété Type Description
id string Identificateur de promotion.
name chaîne Nom convivial de la promotion.
description string Description de la promotion.
startDate string Date de début de la promotion.
endDate string Date de fin de la promotion.
requiredProducts liste des requiredProducts Les produits, les détails de la référence SKU et les stratégies de tarification dont la promotion s’applique.
properties liste des propriétés Propriétés de la promotion, y compris si la promotion est applicable automatiquement.

RequiredProducts

Les produits, les détails de la référence SKU et les stratégies de tarification dont la promotion s’applique.

Propriété Type Description
productId string Un identificateur du produit pour lequel la promotion est disponible.
skuId string Identificateur de la référence SKU pour laquelle la promotion est disponible.
term Terme Un terme incluant la durée du terme et cycle de facturation la promotion est disponible.
pricingPolicies Liste des tarifsPolicies Liste des stratégies qui définissent les types et valeurs de remise de promotion.

Terme

Représente un terme pour lequel la promotion peut être achetée.

Propriété Type Description
durée string Représentation ISO 8601 de la durée du terme. Les valeurs prises en charge actuelles sont P1M (un mois), P1Y (un an) et P3Y (trois ans).
billingCycle string Décrit la fréquence à laquelle la promotion sera appliquée à la facturation. Les valeurs peuvent inclure mensuel, annuel, OneTime ou Inconnu.

PricingPolicies

Décrire les types et valeurs de remise de promotion.

Propriété Type Description
type string Décrivez si la remise est basée sur des pourcentages ou des remises à taux fixe.
value string Définit le montant de la remise appliquée.

Propriétés

Propriétés de la promotion.

Propriété Type Description
isAutoApplicable bool Indique si la promotion est appliquée automatiquement ou si elle doit être transmise par le partenaire.

PromotionEligibilitiesRequestItem

Propriétés représentant une transaction et l’éligibilité d’une promotion.

Propriété Type Description
id int Identificateur d’élément d’éligibilité des promotions.
catalogItemId string L’identificateur de l’élément de catalogue auquel la promotion sera appliquée. Inclut l’ID de produit, l’ID de référence SKU et l’ID de disponibilité.
quantité int Nombre de licences ou d’instances.
termDuration string Représentation ISO 8601 de la durée du terme. Les valeurs prises en charge actuelles sont P1M (un mois), P1Y (un an) et P3Y (trois ans).
billingCycle string Décrit la fréquence à laquelle la promotion sera appliquée à la facturation. Les valeurs peuvent inclure mensuel, annuel, OneTime ou Inconnu.
promotionID string Identificateur de promotion.

PromotionEligibilities

Liste des produits, références SKU et éligibilité de leur promotion.

Propriété Type Description
id int Identificateur d’élément d’éligibilité des promotions.
catalogItemId string L’identificateur de l’élément de catalogue auquel la promotion sera appliquée. Inclut l’ID de produit, l’ID de référence SKU et l’ID de disponibilité.
quantité int Nombre de licences ou d’instances.
termDuration string Représentation ISO 8601 de la durée du terme. Les valeurs prises en charge actuelles sont P1M (un mois), P1Y (un an) et P3Y (trois ans).
billingCycle string Décrit la fréquence à laquelle la promotion sera appliquée à la facturation. Les valeurs peuvent inclure Monthly, Annual, OneTime ou Unknown.
éligibilités Liste des promotionEligibilities Représente la liste des résultats de l’éligibilité à la promotion.

PromotionEligibility

Liste des produits, références SKU et éligibilité de leur promotion.

Propriété Type Description
promotionId string Identificateur de promotion.
is Eligible bool Décrit si la promotion est éligible à l’élément de demande d’éligibilité donné.
erreurs Liste de PromotionEligibilityErrors Erreurs décrivant pourquoi un élément de demande d’éligibilité de promotion n’était pas éligible.

PromotionEligibilityError

Explique pourquoi un élément de demande d’éligibilité de promotion n’était pas éligible.

Propriété Type Description
type string Les types d’erreurs d’éligibilité de promotion peuvent inclure InvalidCatalogItemId, InvalidPromotion, PrerequisiteProductOwnership, RedemptionLimit, SeatCount, OfferPurchasedPreviously ou Term.
description string Décrit si la promotion est éligible à l’élément de demande d’éligibilité donné.

RedemptionLimitPromotionEligibilityError

Inclut des détails sur la raison pour laquelle la limite d’échange a été dépassée.

Propriété Type Description
maxPromotionRedemptionCount int Nombre maximal de fois qu’une promotion peut être acquise.
restantPromotionRedemptionCount int Nombre restant de fois qu’une promotion peut être acquise.

SeatCountPromotionEligibilityError

Inclut des détails sur la raison pour laquelle la limite de nombre de sièges a été dépassée. Toutes les valeurs sont nullables.

Propriété Type Description
minimumRequiredSeats int Les licences minimales qu’une promotion prend en charge.
maximumRequiredSeats int Les licences maximales qu’une promotion prend en charge.
availableSeats int Le nombre restant de licences qu’un partenaire peut acquérir pour une promotion donnée.

TermPromotionEligibilityError

Inclut des détails sur la raison pour laquelle le terme de promotion n’a pas été accepté.

Propriété Type Description
eligibleTerms PromotionTerm Les conditions éligibles d’une promotion prendront en charge.

PromotionTerm

Inclut des détails sur la raison pour laquelle la limite de nombre de sièges a été dépassée.

Propriété Type Description
billingCycle string Décrit la fréquence à laquelle la promotion sera appliquée à la facturation. Les valeurs peuvent inclure Monthly, Annual, OneTime ou Unknown.
durée string Durée de l’achat du terme.