İş Ortağı Merkezi API'lerini kullanarak dolaylı kurumsal bayi için müşteri oluşturma

Makale
03/28/2024

Şunlar için geçerlidir: İş Ortağı Merkezi

Dolaylı sağlayıcı, dolaylı bir kurumsal bayi için müşteri oluşturabilir.

Önkoşullar

İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca App+User kimlik bilgileriyle kimlik doğrulamayı destekler.
Dolaylı kurumsal bayinin kiracı tanımlayıcısı.
Dolaylı kurumsal bayinin dolaylı sağlayıcıyla bir ortaklığı olmalıdır.

C#

Dolaylı kurumsal bayiye yeni müşteri eklemek için:

Yeni bir Customer nesnesi örneği oluşturup BillingProfile ve CompanyProfile dosyalarının örneğini oluşturup doldurun. Dolaylı bayi kimliğini AssociatedPartnerID özelliğine atadığınızdan emin olun.
Müşteri toplama işlemlerine arabirim almak için IAggregatePartner.Customers özelliğini kullanın.
Müşteriyi oluşturmak için Create veya CreateAsync yöntemini çağırın.

C# örneği

// IAggregatePartner partnerOperations;
// var indirectResellerId;
var customerToCreate = new Customer()
{
    CompanyProfile = new CustomerCompanyProfile()
    {
        Domain = string.Format(CultureInfo.InvariantCulture,
            "WingtipToys{0}.{1}",
            new Random().Next(),
            this.Context.Configuration.Scenario.CustomerDomainSuffix)
    },
    BillingProfile = new CustomerBillingProfile()
    {
        Culture = "EN-US",
        Email = "Gena@wingtiptoys.com",
        Language = "En",
        CompanyName = "Wingtip Toys",
        DefaultAddress = new Address()
        {
            FirstName = "Gena",
            LastName = "Soto",
            AddressLine1 = "One Microsoft Way",
            City = "Redmond",
            State = "WA",
            Country = "US",
            PostalCode = "98052",
            PhoneNumber = "4255550101"
        }
    },
    AssociatedPartnerId = indirectResellerId
};

var newCustomer = partnerOperations.Customers.Create(customerToCreate);

Örnek: Konsol test uygulaması. Proje: İş Ortağı Merkezi SDK Örnekleri Sınıfı: CreateCustomerforIndirectReseller.cs

REST isteği

İstek söz dizimi

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

İstek üst bilgileri

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

Request body

Bu tablo, istek gövdesindeki gerekli özellikleri açıklar.

Adı	Tür	Zorunlu	Açıklama
BillingProfile	nesne	Yes	Müşterinin faturalama profili bilgileri.
CompanyProfile	nesne	Yes	Müşterinin şirket profili bilgileri.
AssociatedPartnerId	string	Yes	Dolaylı bayi kimliği. Burada sağlanan kimlikle belirtilen dolaylı kurumsal bayinin dolaylı sağlayıcıyla bir ortaklığı olması gerekir, aksi takdirde istek başarısız olur. Ayrıca AssociatedPartnerId değeri sağlanmazsa, müşterinin dolaylı bayi yerine dolaylı sağlayıcının doğrudan müşterisi olarak oluşturulduğunu unutmayın.
Domain	String	Yes	Müşterinin etki alanı adı (örneğin, contoso.onmicrosoft.com).
organizationRegistrationNumber	string	Yes	Müşterinin kuruluş kayıt numarası (belirli ülkelerde/bölgelerdeKI INN numarası olarak da adlandırılır). Yalnızca şu ülkelerde/bölgelerde bulunan müşterinin şirketi/kuruluşu için gereklidir: Ermenistan(AM), Azerbaycan(AZ), Belarus(BY), Macaristan(HU), Kazakistan(KZ), Kırgızistan(KG), Moldova(MD), Rusya(RU), Tacikistan(TJ), Özbekistan(UZ), Ukrayna(UA), Hindistan, Brezilya, Güney Afrika, Polonya, Birleşik Arap Emirlikleri, Suudi Arabistan, Türkiye, Tayland, Vietnam, Myanmar, Irak, Güney Sudan ve Venezuela. Müşterinin başka ülkelerde/bölgelerde bulunan şirketi/kuruluşu için bu isteğe bağlı bir alandır.

Faturalama profili

Bu tabloda, yeni bir müşteri oluşturmak için gereken CustomerBillingProfile kaynağından gereken en düşük alanlar açıklanmaktadır.

Adı	Tür	Zorunlu	Açıklama
e-posta	string	Yes	Müşterinin e-posta adresi.
kültür	string	Yes	İletişim ve para birimi için tercih ettikleri kültür, örneğin `en-US`. Desteklenen kültürler için bkz . İş Ortağı Merkezi tarafından desteklenen diller ve yerel ayarlar.
dil	string	Yes	Varsayılan dil. İki karakterli dil kodu (örneğin `en` veya `fr`) desteklenir.
company_name	string	Yes	Kayıtlı şirket/kuruluş adı.
default_address	Adres	Yes	Müşterinin şirketinin/kuruluşunun kayıtlı adresi. Uzunluk sınırlamaları hakkında bilgi için Adres kaynağına bakın.

Şirket profili

Bu tabloda, yeni bir müşteri oluşturmak için gereken CustomerCompanyProfile kaynağından gereken en düşük alanlar açıklanmaktadır.

Adı	Tür	Zorunlu	Açıklama
etki alanı	string	Yes	Müşterinin etki alanı adı (örneğin, contoso.onmicrosoft.com).
organizationRegistrationNumber	Dize	Koşula bağlıdır	Müşterinin kuruluş kayıt numarası (belirli ülkelerde/bölgelerdeki INN numarası olarak da adlandırılır). Bu alanın tamamlanması için müşterinin şirketi/kuruluşu aşağıdaki ülkelerde/bölgelerde bulunuyorsa gereklidir: - Ermenistan (AM) - Azerbaycan (AZ) - Beyaz Rusya (BY) - Macaristan (HU) - Kazakistan (KZ) - Kırgızistan (KG) - Moldova (MD) - Rusya (RU) - Tacikistan (TJ) - Özbekistan (UZ) - Ukrayna (UA) -Hindistan -Brezilya -Güney Afrika -Polonya - Birleşik Arap Emirlikleri -Suudi Arabistan - Türkiye -Tayland -Vietnam -Myanmar -Irak - Güney Sudan -Venezuela - Çin Müşterinin başka ülkelerde/bölgelerde bulunan şirketi/kuruluşu için bu, isteğe bağlı bir alandır.

Varsayılan Olarak GDAP

Adı	Tür	Açıklama
enableGDAPByDefault	ikili	GDAP'yi varsayılan olarak etkinleştirmek isteyip istemediğinizi belirten Boole değeri. True ise varsayılan olarak GDAP oluştururuz. False ise GDAP oluşturmayacağız. Bu yalnızca GDAP'ı destekleyen bulutlarda kabul edilir. Desteklenmediyse, DAP varsayılan olarak oluşturulur.

İstek örneği

POST https://api.partnercenter.microsoft.com/v1/customers HTTP/1.1
Authorization: Bearer <token>
MS-RequestId: d628adbe-b7ee-412e-ac55-58f22b4ba2f4
MS-CorrelationId: 0dd197a8-992c-44ca-aeae-21cd83494dce
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 823
Expect: 100-continue
Connection: Keep-Alive

{
    "enableGDAPByDefault": false,
    "Id": null,
    "CommerceId": null,
    "CompanyProfile": {
        "TenantId": null,
        "Domain": "WingtipToys678152504.onmicrosoft.com",
        "CompanyName": null,
        "Attributes": {
            "ObjectType": "CustomerCompanyProfile"
        }
    },
    "BillingProfile": {
        "Id": null,
        "FirstName": null,
        "LastName": null,
        "Email": "Gena@wingtiptoys.com",
        "Culture": "EN-US",
        "Language": "En",
        "CompanyName": "Wingtip Toys",
        "DefaultAddress": {
            "Country": "US",
            "Region": null,
            "City": "Redmond",
            "State": "WA",
            "AddressLine1": "One Microsoft Way",
            "AddressLine2": null,
            "PostalCode": "98052",
            "FirstName": "Gena",
            "LastName": "Soto",
            "PhoneNumber": "4255550101"
        },
        "Attributes": {
            "ObjectType": "CustomerBillingProfile"
        }
    },
    "RelationshipToPartner": "none",
    "AllowDelegatedAccess": null,
    "UserCredentials": null,
    "CustomDomains": null,
    "AssociatedPartnerId": "484e548c-f5f3-4528-93a9-c16c6373cb59",
    "Attributes": {
        "ObjectType": "Customer"
    }
}

Önemli

Haziran 2023 itibarıyla en son İş Ortağı Merkezi .NET SDK sürümü 3.4.0 arşivlenmiştir. SDK sürümünü, yararlı bilgiler içeren bir benioku dosyasıyla birlikte GitHub'dan indirebilirsiniz.

İş ortaklarının İş Ortağı Merkezi REST API'lerini kullanmaya devam etmesi teşvik edilir.

REST yanıtı

Başarılı olursa, yanıt yeni müşteri için bir Müşteri kaynağı içerir.

Yanıt başarısı ve hata kodları

Yanıtlar, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . İş Ortağı Merkezi REST hata kodları.

Yanıt örneği

HTTP/1.1 201 Created
Content-Length: 1085
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 0dd197a8-992c-44ca-aeae-21cd83494dce
MS-RequestId: d628adbe-b7ee-412e-ac55-58f22b4ba2f4
MS-CV: Yy/YaA0gYEmfQyR/.0
MS-ServerId: 030020525
Date: Tue, 06 Jun 2017 23:11:40 GMT

{
    "enableGDAPByDefault": false,
    "id": "626099fe-17af-4756-9fd0-6a73b7127859",
    "commerceId": "626099fe-17af-4756-9fd0-6a73b7127859",
    "companyProfile": {
        "tenantId": "626099fe-17af-4756-9fd0-6a73b7127859",
        "domain": "WingtipToys678152504.onmicrosoft.com",
        "companyName": "Wingtip Toys",
        "links": {
            "self": {
                "uri": "/customers/626099fe-17af-4756-9fd0-6a73b7127859/profiles/company",
                "method": "GET",
                "headers": []
            }
        },
        "attributes": {
            "objectType": "CustomerCompanyProfile"
        }
    },
    "billingProfile": {
        "id": "7079246e-7b62-56ef-7cbd-a819514b54b5",
        "email": "Gena@wingtiptoys.com",
        "culture": "en-US",
        "language": "En",
        "companyName": "Wingtip Toys",
        "defaultAddress": {
            "country": "US",
            "city": "Redmond",
            "state": "WA",
            "addressLine1": "One Microsoft Way",
            "postalCode": "98052",
            "firstName": "Gena",
            "lastName": "Soto",
            "phoneNumber": "4255550101"
        },
        "attributes": {
            "etag": "-8799889149591823008",
            "objectType": "CustomerBillingProfile"
        }
    },
    "relationshipToPartner": "reseller",
    "allowDelegatedAccess": true,
    "userCredentials": {
        "userName": "admin",
        "password": "0Krha*Io"
    },
    "associatedPartnerId": "484e548c-f5f3-4528-93a9-c16c6373cb59",
    "attributes": {
        "objectType": "Customer"
    }
}

Aracılığıyla paylaş