Recursos de promociones

Artículo
01/31/2024

Se aplica a

Centro de partners

Roles adecuados

Administrador global
Agente de administrador

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 obtener más información, consulte la introducción a las experiencias comerciales.

Describe los recursos de las promociones aplicadas a las transacciones de 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.
name	string	Nombre descriptivo de la promoción.
description	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 aplica la promoción.
requiredProducts	lista de requiredProducts	Productos, detalles de SKU y directivas de precios para las que es aplicable la promoción.
properties	lista de propiedades	Propiedades para la promoción, incluido si la promoción es aplicable automáticamente.

RequiredProducts

Productos, detalles de SKU y directivas de precios para las que es aplicable 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	Término	Un plazo que incluye la duración del plazo y el ciclo de facturación para el que está disponible la promoción.
pricingPolicies	Lista de preciosDirectivas	Una 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	string	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.
quantity	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.

PromotionEligibilities

Una lista de productos, SKU y sus elegibilidades de 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.
quantity	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 elegibilidades de promoción	Representa una lista de resultados de elegibilidad de promoción.

PromotionEligibility

Una lista de productos, SKU y sus elegibilidades de 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	string	Los tipos de error de elegibilidad de promoción pueden incluir InvalidCatalogItemId, InvalidPromotion, PrerequisiteProductOwnership, RedemptionLimit, SeatCount, OfferPurchasedPreviously o Term.
description	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 recuento de puestos. Todos los valores aceptan 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 partner 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 recuento 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.
duration	string	Duración del plazo que se va a comprar.

Compartir a través de