Recursos de promociones
Se aplica a
- Centro de partners
Roles adecuados
- Agente de administración
Nota:
Las nuevas experiencias comerciales para los servicios basados en licencias incluyen muchas funcionalidades nuevas y están disponibles para todos los Proveedores de soluciones en la nube (CSP). Para más información, consulte Introducción a las nuevas experiencias comerciales.
Describe los recursos de las promociones aplicadas a las transacciones para las nuevas suscripciones comerciales.
Promoción
Descuento aplicado al comprar una SKU de producto si se cumplen los criterios de idoneidad.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | string | Identificador de promoción. |
| nombre | string | Nombre descriptivo de la promoción. |
| descripción | string | Descripción de la promoción. |
| startDate | string | Fecha de inicio para cuando se aplica la promoción. |
| endDate | string | Fecha de finalización para cuando se aplique la promoción. |
| requiredProducts | lista de requiredProducts | Productos, detalles de SKU y directivas de precios para las que se aplica la promoción. |
| properties | lista de propiedades | Las propiedades de la promoción incluyen si la promoción es aplicable automáticamente. |
RequiredProducts
Productos, detalles de SKU y directivas de precios para las que se aplica la promoción.
| Propiedad | Tipo | Descripción |
|---|---|---|
| productId | string | Identificador del producto para el que está disponible la promoción. |
| skuId | string | Identificador de la SKU para la que está disponible la promoción. |
| Término de | Término | Un período que incluye la duración del período y el ciclo de facturación para el que está disponible la promoción. |
| pricingPolicies | Lista de preciosPolicies | Lista de directivas que definen los tipos y valores de descuento de promoción. |
Término
Representa un término para el que se puede comprar la promoción.
| Propiedad | Tipo | Descripción |
|---|---|---|
| duration | string | Representación ISO 8601 de la duración del término. Los valores admitidos actuales son P1M (un mes), P1Y (un año) y P3Y (tres años). |
| billingCycle | string | Describe la frecuencia con la que se aplicará la promoción a la facturación. Los valores pueden incluir Mensual, Anual, OneTime o Desconocido. |
PricingPolicies
Describir los tipos y valores de descuento de promoción.
| Propiedad | Tipo | Descripción |
|---|---|---|
| type | cadena | Describir si el descuento se basa en porcentajes o descuentos de tarifa plana. |
| value | string | Define el importe del descuento aplicado. |
Propiedades
Propiedades de la promoción.
| Propiedad | Tipo | Descripción |
|---|---|---|
| isAutoApplicable | bool | Indica si la promoción se aplica automáticamente o si el asociado debe pasarla. |
PromotionEligibilitiesRequestItem
Propiedades que representan una transacción y la idoneidad de una promoción.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | int | Identificador de elemento de elegibilidad de promociones. |
| catalogItemId | string | Identificador del elemento de catálogo al que se aplicará la promoción. Incluye el identificador de producto, el identificador de SKU y el identificador de disponibilidad. |
| cantidad | int | Número de licencias o instancias. |
| termDuration | string | Representación ISO 8601 de la duración del término. Los valores admitidos actuales son P1M (un mes), P1Y (un año) y P3Y (tres años). |
| billingCycle | string | Describe la frecuencia con la que se aplicará la promoción a la facturación. Los valores pueden incluir Mensual, Anual, OneTime o Desconocido. |
| promotionID | string | Identificador de promoción. |
PromocionesEligibilidades
Una lista de productos, SKU y sus idoneidad para la promoción.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | int | Identificador de elemento de elegibilidad de promociones. |
| catalogItemId | string | Identificador del elemento de catálogo al que se aplicará la promoción. Incluye el identificador de producto, el identificador de SKU y el identificador de disponibilidad. |
| cantidad | int | Número de licencias o instancias. |
| termDuration | string | Representación ISO 8601 de la duración del término. Los valores admitidos actuales son P1M (un mes), P1Y (un año) y P3Y (tres años). |
| billingCycle | string | Describe la frecuencia con la que se aplicará la promoción a la facturación. Los valores pueden incluir Mensual, Anual, OneTime o Desconocido. |
| idoneidad | Lista de promocionesEligibilidades | Representa una lista de resultados de elegibilidad de promoción. |
PromotionEligibility
Una lista de productos, SKU y sus idoneidad para la promoción.
| Propiedad | Tipo | Descripción |
|---|---|---|
| promotionId | string | Identificador de promoción. |
| isEligible | bool | Describe si la promoción es apta para el elemento de solicitud de idoneidad especificado. |
| errors | Lista de promotionEligibilityErrors | Errores que describen por qué un elemento de solicitud de elegibilidad de promoción no era apto. |
PromotionEligibilityError
Explica por qué un elemento de solicitud de elegibilidad de promoción no era apto.
| Propiedad | Tipo | Descripción |
|---|---|---|
| type | cadena | Los tipos de error de elegibilidad de promoción pueden incluir InvalidCatalogItemId, InvalidPromotion, PrerequisiteProductOwnership, RedemptionLimit, SeatCount, OfferPurchasedPreviously o Term. |
| descripción | string | Describe si la promoción es apta para el elemento de solicitud de idoneidad especificado. |
RedemptionLimitPromotionEligibilityError
Incluye detalles sobre por qué se superó el límite de canje.
| Propiedad | Tipo | Descripción |
|---|---|---|
| maxPromotionRedemptionCount | int | Número máximo de veces que se puede adquirir una promoción. |
| remainingPromotionRedemptionCount | int | El número restante de veces que se puede adquirir una promoción. |
SeatCountPromotionEligibilityError
Incluye detalles sobre por qué se superó el límite de número de puestos. Todos los valores admiten valores NULL.
| Propiedad | Tipo | Descripción |
|---|---|---|
| minimumRequiredSeats | int | Las licencias mínimas que admitirá una promoción. |
| maximumRequiredSeats | int | Las licencias máximas que admitirá una promoción. |
| availableSeats | int | El número restante de licencias que un asociado puede adquirir para una promoción determinada. |
TermPromotionEligibilityError
Incluye detalles sobre por qué no se aceptó el término de promoción.
| Propiedad | Tipo | Descripción |
|---|---|---|
| eligibleTerms | PromotionTerm | Se admitirán los términos aptos para una promoción. |
PromotionTerm
Incluye detalles sobre por qué se superó el límite de número de puestos.
| Propiedad | Tipo | Descripción |
|---|---|---|
| billingCycle | string | Describe la frecuencia con la que se aplicará la promoción a la facturación. Los valores pueden incluir Mensual, Anual, OneTime o Desconocido. |
| duración | string | Duración del plazo que se va a comprar. |