Obtener promoción por identificador

  • Article

Se aplica a

  • Centro de partners

Roles adecuados

  • Administrador global
  • 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

None

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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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"
                }
            ]
        ]
    }
}