Promotie ophalen via ID

Van toepassing op

• Partnercentrum

Juiste rollen

• Beheermedewerker

Notitie

De nieuwe commerce-ervaringen voor services op basis van licenties omvatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle CSP's (Cloud Solution Provider). Voor meer informatie, zie het overzicht van nieuwe commerce-ervaringen.

Partners kunnen één promotie krijgen voor een bepaalde promotie-id en land/regio. Deze methode retourneert de promotiegegevens, waarbij de begin- en einddatum van de promotie worden genegeerd. Deze methode wordt voornamelijk gebruikt voor afstemmingsdoeleinden om promotiedetails op te halen, zelfs nadat de promotie is verlopen.

Vereisten

• Referenties zoals beschreven in Partnercentrum-authenticatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.

• Promotie-id is een gescheiden set tekenreeksen die een specifieke promotie vertegenwoordigen.

• Het land vertegenwoordigt het klantland of de regio waarvoor promoties beschikbaar zijn. Land wordt vertegenwoordigd door een landcode van twee tekens.

REST-aanvraag

Aanvraagsyntaxis

Wijze	Aanvraag-URI
GET	{baseURL}/v1/productpromotions/{promotion-id}?country={country-code} HTTP/1.1

URI-parameter

Gebruik de volgende queryparameters om beschikbare promoties te retourneren.

Name	Soort	Vereist	Beschrijving
promotie-id	string	Y	Een tekenreeks die de promotie definieert die moet worden opgehaald.
land	tekenreeks	Y	Een landcode van twee letters die bepaalt voor welke klantland-/regiopromoties beschikbaar zijn.

Aanvraagkoppen

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen

Promotiebeperkingen

Promotiebeperkingen worden nu geretourneerd door deze API. Zie voorbeelden in het onderstaande antwoord. Als een promotie geschiktheidsbeperkingen heeft, worden details geretourneerd in het antwoord. Deze gegevens kunnen worden gebruikt om te begrijpen of uw klant in aanmerking komt voor de korting.

Categorie beperking	Beperkingswaarde	Beperkingstype	Beschrijving
Zitplaatsbeperkingen	MinSeats	Abonnementsaantal	Minimale stoelen die nodig zijn voor de klant om in aanmerking te komen voor de promotie.
Zitplaatsbeperkingen	Maximale Zitplaatsen	AbonnementHoeveelheid	Maximum aantal plaatsen waar de promotie op kan worden toegepast.
AssetOwnershipLimits	MinAssets	LevenslangeInwisselAantal	Het minimale aantal keren dat de promotie kan worden toegepast voor een klant, meestal 0.
AssetOwnershipLimits	MaxAssets	LevenslangeInwisselTelling	Het maximum aantal keren dat de promotie kan worden aangevraagd voor de klant.
Geschiktheidsbeperkingen	isToepasbaar	Eerste Aankoop	Vlag die aangeeft of dit de eerste aankoop van de product-SKU van de klant moet zijn om de promotie te ontvangen.
ProductOwnershipConstraints	bigId	N.v.t.	Opgegeven aanbiedingen die de klant al moet bezitten om in aanmerking te komen voor de promotie (Product-SKU).

Aanvraagvoorbeeld

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

REST-antwoord

Als dit lukt, retourneert deze methode één promotie.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of er sprake is van succes of een fout, en aanvullende informatie voor foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie Foutcodes voor de volledige lijst.

Responsvoorbeeld

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"
                }
            ]
        ]
    }
}