Promosyon uygunluğunu doğrulama

  • Makale
  • Okumak için 2 dakika

Uygulandığı Yer

  • İş Ortağı Merkezi

Uygun roller

  • Genel yönetici
  • Yönetici aracısı

Not

Yeni Ticaret değişiklikleri şu anda yalnızca Microsoft 365 ve Dynamics 365 yeni ticaret deneyimi teknik önizlemesinde yer alan iş ortakları tarafından kullanılabilir.

Parters, müşteri işlemlerinin verilen promosyon için uygun olup olmadığını doğrular. Müşteri işlemi belirli bir yükseltme için uygunsa bu yöntem True döndürür. İş ortakları, yükseltmenin uygulandığını doğrulamak için işlem göndermeden önce uygunluğu doğrular.

Önkoşullar

  • kimlik doğrulamasında açıklandığı gibi İş Ortağı Merkezi bilgileri. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamasını destekler.

  • Uygunluk, satın alınan ürün sku kullanılabilirliğini, değerlendirilen yükseltme kimliğini, miktarı, süreyi ve işlem faturalama döngüsünü içerir.

REST isteği

İstek söz dizimi

Yöntem İstek URI'si
YAYINLA {baseURL}/v1/customers/{customerId}/promotionEligibilities HTTP/1.1

URI parametresi

Kullanılabilir yükseltmeleri geri dönmek için aşağıdaki sorgu parametrelerini kullanın.

Ad Tür Gerekli Açıklama
Customerıd string Y Değer, müşteri belirtmenize olanak sağlayan bir tanımlayıcı olan GUID biçimli bir customer-tenant-id değeridir.

İstek üst bilgileri

Daha fazla bilgi için bkz. İş Ortağı Merkezi REST üst bilgileri.

İstek gövdesi

Gövde, PromotionEligibilitiesRequestItems koleksiyonu içerir. Bu tabloda Bir PromotionEligibilitiesRequestItem için özellikler açıkmektedir.

Özellik Tür Gerekli Açıklama
catalogItemId string Yes Katalog öğesi tanımlayıcısı.
miktar int Yes Lisans veya örnek sayısı.
termDuration DateTime Yes Sürenin ISO 8601 gösterimi. Desteklenen geçerli değerler P1M (bir ay), P1Y (bir yıl) ve P3Y (üç yıl) değerleridir.
billingCycle string Yes Faturalama döngüsünün türünü gösteren değer.
promotionId string Yes Yükseltme öğesi tanımlayıcısı.

İstek örneği

POST https://api.partnercenter.microsoft.com/v1/customers/46632f71-f052-4384-8f84-4cdb6c12c2a1/promotionEligibilities 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

{
    "items": [
        {
            "catalogItemId": "CFQ7TTC0LH2Z:0002:CFQ7TTC0HRVK",
            "quantity": 2400,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "promotionId": "39NFJQT1PM6C:0005:39NFJQT1Q5L7"
        }
    ]
}

REST yanıtı

Başarılı olursa, bu yöntem uygunluk sonuçlarının bir koleksiyonunu döndürür.

Yanıt başarı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu gösteren bir HTTP durum kodu ve daha fazla hata ayıklama bilgisi ile birlikte gelir. Bu kodu, hata türünü ve daha fazla parametreyi okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. Hata Kodları.

Yanıt örneği

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, 26 Feb 2021 20:42:26 GMT

{
    "totalCount": 1,
    "items": [
        {
            "id": 0,
            "catalogItemId": "CFQ7TTC0LH2Z:0002:CFQ7TTC0HRVK",
            "quantity": 2400,
            "billingCycle": "monthly",
            "termDuration": "P1Y",
            "eligibilities": [
                {
                    "promotionId": "39NFJQT1PM6C:0005:39NFJQT1Q5L7",
                    "isEligible": false,
                    "errors": [
                        {
                            "minimumRequiredSeats": 1,
                            "maximumRequiredSeats": 2400,
                            "availableSeats": 500,
                            "type": "SeatCount",
                            "description": "The provided quantity does not satisfy the minimum or maximum seat requirements for the promotion."
                        }
                    ]
                }
            ],
            "attributes": {
                "objectType": "PromotionEligibilities"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}