Vytvoření zákazníka pro nepřímého prodejce pomocí rozhraní API Partnerského centra

Článek
04/01/2024

Platí pro: Partnerské centrum

Nepřímý poskytovatel může vytvořit zákazníka pro nepřímého prodejce.

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pouze s přihlašovacími údaji aplikace a uživatele.
Identifikátor tenanta nepřímého prodejce.
Nepřímý prodejce musí mít partnerství s nepřímým poskytovatelem.

C#

Přidání nového zákazníka pro nepřímého prodejce:

Vytvořte instanci nového objektu Customer (Zákazník) a pak vytvořte instanci a naplňte BillingProfile a CompanyProfile. Nezapomeňte přiřadit ID nepřímého prodejce k vlastnosti AssociatedPartnerID .
Pomocí vlastnosti IAggregatePartner.Customers získejte rozhraní pro operace shromažďování zákazníků.
Zavolejte metodu Create nebo CreateAsync a vytvořte zákazníka.

Příklad jazyka C#

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

Ukázka: Konzolová testovací aplikace Projekt: Ukázková třída sady SDK v Partnerském centru: CreateCustomerforIndirectReseller.cs

Požadavek REST

Syntaxe požadavku

metoda	Identifikátor URI žádosti
POST	{baseURL}/v1/customers HTTP/1.1

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Tato tabulka popisuje požadované vlastnosti v textu požadavku.

Name	Type	Požadováno	Popis
BillingProfile	objekt	Ano	Informace o fakturačním profilu zákazníka.
CompanyProfile	objekt	Ano	Informace o profilu společnosti zákazníka.
AssociatedPartnerId	string	Ano	ID nepřímého prodejce. Nepřímý prodejce uvedený zde musí mít partnerství s nepřímým poskytovatelem nebo požadavek selže. Všimněte si také, že pokud není zadána hodnota AssociatedPartnerId, vytvoří se zákazník jako přímý zákazník nepřímého poskytovatele místo nepřímého prodejce.
Doména	String	Ano	Název domény zákazníka, například contoso.onmicrosoft.com.
organizationRegistrationNumber	string	Ano	Registrační číslo organizace zákazníka (označované také jako číslo INN v určitých zemích nebo oblastech). Vyžaduje se pouze pro společnost nebo organizaci zákazníka, která se nachází v následujících zemích/oblastech: Arménie(AM), Ázerbájdžán(AZ), Bělorusko(BY), Maďarsko(HU), Kazachstán(KZ), Kyrgyzstán(KG), Moldavsko(MD), Rusko(RU), Tajikistan(TJ), Uz), Ukrajina(UA), Indie, Brazílie, Jižní Afrika, Polsko, Spojené arabské emiráty, Saúdská Arábie, Türkiye, Thajsko, Vietnam, Myanmar, Irák, Jižní Súdán a Venezuela. V případě společnosti nebo organizace zákazníka, která se nachází v jiných zemích nebo oblastech, se jedná o volitelné pole.

Fakturační profil

Tato tabulka popisuje minimální požadovaná pole z prostředku CustomerBillingProfile potřebného k vytvoření nového zákazníka.

Name	Type	Požadováno	Popis
E-mail	string	Ano	E-mailová adresa zákazníka.
jazyková verze	string	Ano	Jejich upřednostňovaná kultura pro komunikaci a měnu, například `en-US`. Podporované jazyky a národní prostředí najdete v Partnerském centru.
jazyk	string	Ano	Výchozí jazyk. Podporují se dva kódy jazyka znaků (například `en` nebo `fr`).
Company_name	string	Ano	Název registrované společnosti nebo organizace.
default_address	Adresa	Ano	Registrovaná adresa společnosti nebo organizace zákazníka. Informace o jakýchkoli omezeních délky najdete v prostředku Adresa .

Profil společnosti

Tato tabulka popisuje minimální požadovaná pole z prostředku CustomerCompanyProfile potřebného k vytvoření nového zákazníka.

Name	Type	Požadováno	Popis
domain	string	Ano	Název domény zákazníka, například contoso.onmicrosoft.com.
organizationRegistrationNumber	string	Závisí na podmínce.	Registrační číslo organizace zákazníka (označované také jako číslo INN v určitých zemích/oblastech). Dokončení tohoto pole se vyžaduje jenom v případě, že se společnost nebo organizace zákazníka nachází v následujících zemích/oblastech: - Arménie (AM) – Ázerbájdžán (AZ) - Bělorusko (BY) - Maďarsko (HU) - Kazachstán (KZ) - Kyrgyzstán (KG) - Moldavsko (MD) - Rusko (RU) - Tajikistan (TJ) - Arábie (UZ) - Ukrajina (UA) -Indie -Brazílie -Jihoafrická republika -Polsko - Spojené arabské emiráty -Saúdská Arábie -Türkiye -Thajsko -Vietnamu -Myanmaru -Irák - Jižní Súdán -Venezuela - Čína Pro společnost nebo organizaci zákazníka, která se nachází v jiných zemích nebo oblastech, je to volitelné pole.

GDAP ve výchozím nastavení

Name	Typ	Popis
enableGDAPByDefault	bool	Logická hodnota označující, jestli chceme povolit GDAP ve výchozím nastavení nebo ne. Pokud ano, vytvoříme ve výchozím nastavení GDAP. Pokud je false, nevytvoříme GDAP. Mějte na paměti, že se to dodržuje jenom v cloudech, které podporují GDAP. Pokud se nepodporuje, daP se ve výchozím nastavení vytvoří.

Příklad požadavku

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

Důležité

Od června 2023 se teď archivuje nejnovější verze sady .NET SDK partnerského centra 3.4.0. Vydání sady SDK si můžete stáhnout z GitHubu spolu se souborem readme, který obsahuje užitečné informace.

Doporučujeme, aby partneři dál používali rozhraní REST API Partnerského centra.

Odpověď REST

V případě úspěchu odpověď obsahuje prostředek zákazníka pro nového zákazníka.

Kódy úspěšnosti a chyb odpovědi

Odpovědi se dodávají se stavovým kódem HTTP, který indikuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.

Příklad odpovědi

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