Skapa en kund för en indirekt återförsäljare med hjälp av Api:er för Partnercenter

Artikel
04/01/2024

Gäller för: Partnercenter

En indirekt leverantör kan skapa en kund för en indirekt återförsäljare.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder endast autentisering med App+User-autentiseringsuppgifter.
Klientidentifieraren för den indirekta återförsäljaren.
Den indirekta återförsäljaren måste ha ett partnerskap med den indirekta leverantören.

C#

Så här lägger du till en ny kund för en indirekt återförsäljare:

Instansiera ett nytt kundobjekt och instansiera och fyll sedan i BillingProfile och CompanyProfile. Se till att tilldela det indirekta reseller-ID:t till egenskapen AssociatedPartnerID.
Använd egenskapen IAggregatePartner.Customers för att få ett gränssnitt för kundinsamlingsåtgärder.
Anropa metoden Skapa eller SkapaAsync för att skapa kunden.

C#-exempel

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

Exempel: Konsoltestapp. Projekt: SDK-exempelklass för Partnercenter: CreateCustomerforIndirectReseller.cs

REST-begäran

Syntax för begäran

Metod	URI för förfrågan
POST	{baseURL}/v1/customers HTTP/1.1

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

I den här tabellen beskrivs de nödvändiga egenskaperna i begärandetexten.

Namn	Typ	Obligatoriskt	Beskrivning
BillingProfile	objekt	Ja	Kundens faktureringsprofilinformation.
CompanyProfile	objekt	Ja	Kundens företagsprofilinformation.
AssociatedPartnerId	sträng	Ja	Det indirekta reseller-ID:t. Den indirekta återförsäljare som anges av det ID som anges här måste ha ett partnerskap med den indirekta leverantören, annars misslyckas begäran. Observera också att om värdet AssociatedPartnerId inte tillhandahålls skapas kunden som en direkt kund till den indirekta providern i stället för den indirekta återförsäljaren.
Domain	String	Ja	Kundens domännamn, till exempel contoso.onmicrosoft.com.
organizationRegistrationNumber	sträng	Ja	Kundens organisationsregistreringsnummer (kallas även INN-nummer i vissa länder/regioner). Krävs endast för kundens företag/organisation i följande länder/regioner: Armenien(AM), Azerbajdzjan(AZ), Vitryssland(BY), Ungern(HU), Kazakstan(KZ), Kirgizistan(KG), Moldavien(MD), Ryssland(RU), Tadzjikistan(TJ), Uzbekistan(UZ), Ukraina(UA), Indien, Brasilien, Sydafrika, Polen, Förenade Arabemiraten, Saudiarabien, Türkiye, Thailand, Vietnam, Myanmar, Irak, Sydsudan och Venezuela. För kundens företag/organisation som finns i andra länder/regioner är detta ett valfritt fält.

Faktureringsprofil

I den här tabellen beskrivs de minsta obligatoriska fälten från den CustomerBillingProfile-resurs som behövs för att skapa en ny kund.

Namn	Typ	Obligatoriskt	Beskrivning
E-post	sträng	Ja	Kundens e-postadress.
Kultur	sträng	Ja	Deras föredragna kultur för kommunikation och valuta, till exempel `en-US`. Se Språk och nationella inställningar som stöds i Partnercenter för de kulturer som stöds.
språk	string	Ja	Standardspråket. Två teckenspråkkoder (till exempel `en` ) `fr`stöds.
company_name	sträng	Ja	Det registrerade företags-/organisationsnamnet.
default_address	Address	Ja	Den registrerade adressen för kundens företag/organisation. Se Adressresursen för information om eventuella längdbegränsningar.

Företagsprofil

Den här tabellen beskriver de minsta obligatoriska fälten från customercompanyProfile-resursen som behövs för att skapa en ny kund.

Namn	Typ	Obligatoriskt	Beskrivning
domain	sträng	Ja	Kundens domännamn, till exempel contoso.onmicrosoft.com.
organizationRegistrationNumber	sträng	Beror på villkor	Kundens organisationsregistreringsnummer (kallas även INN-nummer i vissa länder/regioner). Att slutföra det här fältet krävs endast om en kunds företag/organisation finns i följande länder/regioner: - Armenien (AM) - Azerbajdzjan (AZ) - Vitryssland (BY) – Ungern (HU) - Kazakstan (KZ) - Kirgizistan (KG) - Moldavien (MD) - Ryssland (RU) - Tadzjikistan (TJ) - Uzbekistan (UZ) - Ukraina (UA) -Indien -Brasilien -Sydafrika -Polen - Förenade Arabemiraten -Saudiarabien -Türkiye -Thailand -Vietnam -Myanmar -Irak - Sydsudan -Venezuela - Kina För kundens företag/organisation som finns i andra länder/regioner är detta ett valfritt fält.

GDAP som standard

Namn	Type	Beskrivning
enableGDAPByDefault	bool	Booleskt värde för att ange om vi vill aktivera GDAP som standard eller inte. Om sant skapar vi GDAP som standard. Om det är falskt skapar vi inte GDAP. Observera att detta endast respekteras i moln som stöder GDAP. Om inget stöds skapas DAP som standard.

Exempel på begäran

POST https://api.partnercenter.microsoft.com/v1/customers HTTP/1.1
Authorization: Bearer <token>
MS-RequestId: d628adbe-b7ee-412e-ac55-58f22b4ba2f4
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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"
    }
}

Viktigt!

Från och med juni 2023 arkiveras nu den senaste Partner Center .NET SDK-versionen 3.4.0. Du kan ladda ned SDK-versionen från GitHub tillsammans med en readme-fil som innehåller användbar information.

Partner uppmanas att fortsätta att använda REST-API:er för Partnercenter.

REST-svar

Om det lyckas innehåller svaret en kundresurs för den nya kunden.

Svarsframgång och felkoder

Svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Rest-felkoder för Partnercenter.

Svarsexempel

HTTP/1.1 201 Created
Content-Length: 1085
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "commerceId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "companyProfile": {
        "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "domain": "WingtipToys678152504.onmicrosoft.com",
        "companyName": "Wingtip Toys",
        "links": {
            "self": {
                "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/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"
    }
}

Dela via