Ressources de promotion
S’applique à
- Espace partenaires
Rôles appropriés
- 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 |
|---|---|---|
| duration | 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. |
| valeur | 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. |