Obtener promoción por identificador

Artículo
09/27/2024

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.

Los partners pueden obtener una sola promoción para un identificador de promoción y un país o región determinados. Este método devuelve los datos de promoción, ignorando las fechas de inicio y finalización de la promoción. Este método se usa principalmente con fines de conciliación para recuperar los detalles de la promoción incluso después de que la promoción haya expirado.

Requisitos previos

Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación con credenciales de aplicación independiente y app+usuario.
El identificador de promoción está delimitado por un conjunto de cadenas que representan una promoción específica.
El país representa las promociones de país o región del cliente disponibles. El país se representa mediante un código de país de dos caracteres.

Solicitud REST

Sintaxis de la solicitud

Método	URI de solicitud
GET	{baseURL}/v1/productpromotions/{promotion-id}?country={country-code HTTP/1.1

Parámetro de URI

Use los siguientes parámetros de consulta para devolver promociones disponibles.

Nombre	Type	Obligatorio	Descripción
promotion-id	string	Y	Cadena que define la promoción que se va a recuperar.
country	string	Y	Código de país de dos letras para el que se determinan las promociones de país o región del cliente para las que están disponibles.

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

Ninguno

Restricciones promocionales

Las restricciones promocionales ahora las devuelve esta API. Vea ejemplos en la respuesta siguiente. Si una promoción tiene restricciones de idoneidad, los detalles se devuelven en la respuesta. Estos datos se pueden usar para comprender si el cliente califica para el descuento.

Categoría de restricción	Valor de restricción	Tipo de restricción	Descripción
SeatConstraints	MinSeats	SubscriptionQuantity	Asientos mínimos necesarios para que el cliente sea apto para la promoción.
SeatConstraints	MaxSeats	SubscriptionQuantity	Número máximo de asientos a los que se puede aplicar la promoción.
AssetOwnershipLimits	MinAssets	LifetimeRedemptionCount	El número mínimo de veces que se puede aplicar la promoción a un cliente, normalmente 0.
AssetOwnershipLimits	MaxAssets	LifetimeRedemptionCount	Número máximo de veces que se puede aplicar la promoción al cliente.
ElegibilidadConstraints	isApplicable	FirstPurchase	Marca que indica si debe ser la primera compra del cliente de la SKU del producto para recibir la promoción.
ProductOwnershipConstraints	bigId	N/D	Las ofertas especificadas que el cliente ya debe poseer para poder optar a la promoción (SKU del producto).

Ejemplo de solicitud

GET https://api.partnercenter.microsoft.com/v1/productpromotions/CFQ7TTC0HD33:0003:CFQ7TTC0K59M?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

Respuesta REST

Si se ejecuta correctamente, este método devuelve una sola promoción.

Códigos de error y de respuesta correctos

Cada respuesta incluye un código de estado HTTP que indica éxito o error y más información de depuración. Use una herramienta de seguimiento de red para leer este código, tipo de error y otros parámetros. Para obtener la lista completa, consulte Códigos de error.

Ejemplo de respuesta

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 24 Apr 2023 20:42:26 GMT

 
{
    "id": "39NFJQT1SNC7:0001:39NFJQT1Q5KM",
    "name": "TEST Promotion May 2023 - Microsoft 365 F3",
    "description": "TEST Promotion May 2023 - Microsoft 365 F3",
    "startDate": "2023-05-03T00:00:00+00:00",
    "endDate": "9999-01-01T00:00:00+00:00",
    "properties": {
        "isAutoApplicable": true
    },
    "requiredProducts": [
        {
            "productId": "CFQ7TTC0LH05",
            "skuId": "0001",
            "term": {
                "duration": "P1Y",
                "billingCycle": "Annual"
            },
            "pricingPolicies": [
                {
                    "policyType": "PercentDiscount",
                    "value": "0.5"
                }
            ]
        }
    ],
    "promotionConstraints": { 
        "seatConstraints": [
            {
                "minSeats": 10,
                "maxSeats": 100,
                "type": "SubscriptionQuantity"
            }
        ],
        "assetOwnershipLimits": [
            {
                "minAssets": 0,
                "maxAssets": 3,
                "type": "LifetimeRedemptionCount"
            }
        ],
        "eligibilityConstraints": [
            {
                "isApplicable": true,
                "type": "FirstPurchase"
            }
        ],
        "productOwnershipConstraints": [
            [
                {
                    "bigId": "CFQ7TTC0MBMD/0002"
                }
            ]
        ]
    }
}

Compartir a través de