Ügyfél létrehozása közvetett viszonteladóhoz Partnerközpont API-k használatával

Cikk
04/01/2024

A következőre vonatkozik: Partnerközpont

A közvetett szolgáltató létrehozhat egy ügyfelet egy közvetett viszonteladó számára.

Előfeltételek

Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv csak app+felhasználói hitelesítő adatokkal támogatja a hitelesítést.
A közvetett viszonteladó bérlőazonosítója.
A közvetett viszonteladónak partneri viszonyban kell lennie a közvetett szolgáltatóval.

C#

Új ügyfél hozzáadása közvetett viszonteladóhoz:

Új ügyfélobjektum példányosítása, majd a BillingProfile és a CompanyProfile példányosítása és feltöltése. Mindenképpen rendelje hozzá a közvetett viszonteladó azonosítóját az AssociatedPartnerID tulajdonsághoz.
Az IAggregatePartner.Customers tulajdonság használatával kap egy felületet az ügyfélgyűjtési műveletekhez.
Hívja meg a Create vagy a CreateAsync metódust az ügyfél létrehozásához.

C# példa

// 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);

Példa: Konzoltesztelő alkalmazás. Projekt: Partnerközpont SDK-mintaosztály: CreateCustomerforIndirectReseller.cs

REST-kérés

Kérés szintaxisa

Metódus	Kérés URI-ja
POST	{baseURL}/v1/customers HTTP/1.1

Kérésfejlécek

További információ: Partnerközpont – REST fejlécek.

Kérés törzse

Ez a táblázat a kérelem törzsében található szükséges tulajdonságokat ismerteti.

Név	Típus	Kötelező	Leírás
BillingProfile	object	Igen	Az ügyfél számlázási profiladatai.
CompanyProfile	object	Igen	Az ügyfél céges profiladatai.
AssociatedPartnerId	sztring	Igen	A közvetett viszonteladó azonosítója. A közvetett viszonteladónak az itt megadott azonosító alapján partnerséget kell létesítenie a közvetett szolgáltatóval, vagy a kérés sikertelen lesz. Azt is vegye figyelembe, hogy ha nem adja meg az AssociatedPartnerId értéket, az ügyfél a közvetett szolgáltató közvetlen ügyfeleként jön létre a közvetett viszonteladó helyett.
Tartomány	Sztring	Igen	Az ügyfél tartományneve, például contoso.onmicrosoft.com.
organizationRegistrationNumber	sztring	Igen	Az ügyfél szervezetregisztrációs száma (más néven INN-szám bizonyos országokban/régiókban). Csak a következő országokban/régiókban található ügyfél cégéhez/szervezetéhez szükséges: Örményország (AM), Azerbajdzsán(AZ), Belarusz(BY), Magyarország(HU), Kazahsztán(KZ), Kirgizisztán(KG), Moldova(MD), Oroszország(RU), Tádzsikisztán(TJ), Üzbegisztán(UZ), Ukrajna(UA), India, Brazília, Dél-Afrika, Lengyelország, Egyesült Arab Emírségek, Szaúd-Arábia, Türkiye, Thaiföld, Vietnam, Mianmar, Irak, Dél-Szudán és Venezuela. Az ügyfél más országokban/régiókban található vállalata/szervezete számára ez nem kötelező mező.

Számlázási profil

Ez a táblázat az új ügyfél létrehozásához szükséges Minimálisan szükséges mezőket ismerteti a CustomerBillingProfile erőforrásból.

Név	Típus	Kötelező	Leírás
e-mail	sztring	Igen	Az ügyfél e-mail-címe.
Kultúra	sztring	Igen	A kommunikáció és a pénznem előnyben részesített kultúrája, például `en-US`. A támogatott kultúrákhoz lásd a Partnerközpont által támogatott nyelveket és területi beállításokat .
language	sztring	Igen	Az alapértelmezett nyelv. Két karakternyelvi kód (például `en` vagy `fr`) támogatott.
company_name	sztring	Igen	A regisztrált vállalat/szervezet neve.
default_address	Cím	Igen	Az ügyfél cégének/szervezetének regisztrált címe. A hosszkorlátozásokról további információt a Cím erőforrásban talál.

Vállalati profil

Ez a táblázat az új ügyfél létrehozásához szükséges Minimálisan szükséges mezőket ismerteti a CustomerCompanyProfile erőforrásból.

Név	Típus	Kötelező	Leírás
domain	sztring	Igen	Az ügyfél tartományneve, például contoso.onmicrosoft.com.
organizationRegistrationNumber	húr	A feltételtől függ	Az ügyfél szervezetregisztrációs száma (más néven inn szám bizonyos országokban/régiókban). A mező kitöltése csak akkor szükséges, ha az ügyfél vállalata/szervezete a következő országokban/régiókban található: - Örményország (AM) - Azerbajdzsán (AZ) - Fehéroroszország (BY) - Magyarország (HU) - Kazahsztán (KZ) - Kirgizisztán (KG) - Moldova (MD) - Oroszország (RU) - Tádzsikisztán (TJ) - Üzbegisztán (UZ) - Ukrajna (UA) -India -Brazília -Dél-Afrika -Lengyelország - Egyesült Arab Emírségek -Szaúd-Arábia - Türkiye -Thaiföld -Vietnam -Mianmar -Irak - Dél-Szudán -Venezuela -Kína Az ügyfél más országokban/régiókban található vállalata/szervezete számára ez egy nem kötelező mező.

GDAP alapértelmezés szerint

Név	Típus	Leírás
enableGDAPByDefault	logikai	Logikai érték, amely jelzi, hogy alapértelmezés szerint engedélyezni szeretnénk-e a GDAP-t. Ha igaz, alapértelmezés szerint létrehozzuk a GDAP-t. Ha hamis, nem hozunk létre GDAP-t. Vegye figyelembe, hogy ezt csak a GDAP-t támogató felhőkben tartják tiszteletben. Ha nem támogatott, a DAP alapértelmezés szerint létrejön.

Példa kérése

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

Fontos

2023 júniusától a partnerközpont .NET SDK legújabb, 3.4.0-s kiadását archiváljuk. Az SDK-kiadást letöltheti a GitHubról, valamint egy hasznos információkat tartalmazó olvasófájlt.

A partnereket arra ösztönzik, hogy továbbra is használják a Partnerközpont REST API-jait.

REST-válasz

Ha sikeres, a válasz tartalmaz egy ügyfélerőforrást az új ügyfélhez.

Válasz sikeresség és hibakódok

A válaszokhoz egy HTTP-állapotkód is jár, amely jelzi a sikerességet vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Partnerközpont REST-hibakódjaiban találja.

Példa válaszra

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