Erstellen eines Kunden

Artikel
04/01/2024

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

Als Cloud Solution Provider (CSP)-Partner können Sie beim Erstellen eines Kunden Bestellungen im Auftrag des Kunden aufgeben. Wenn Sie einen Kunden erstellen, erstellen Sie auch Folgendes:

Ein Microsoft Entra-Mandantenobjekt für den Kunden
Eine Beziehung zwischen dem Vertriebspartner und dem Kunden (für delegierte Administratorrechte verwendet)
Benutzername und Kennwort für die Anmeldung als Administrator für den Kunden

Nachdem der Kunde erstellt wurde, speichern Sie die Kunden-ID und die Microsoft Entra-ID.

Wichtig

Wenn Sie ein indirekter Anbieter sind und einen Kunden für einen indirekten Händler erstellen möchten, lesen Sie " Erstellen eines Kunden für einen indirekten Händler".

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.

Wichtig

Um einen Kundenmandanten zu erstellen, müssen Sie während des Erstellungsprozesses eine gültige physische Adresse angeben. Eine Adresse kann überprüft werden, indem Sie die im Szenario "Adresse überprüfen" beschriebenen Schritte ausführen. Wenn Sie einen Kunden mithilfe einer ungültigen Adresse in der Sandkastenumgebung erstellen, können Sie diesen Kundenmandanten nicht löschen.

Wichtig

Wenn das Kennwort für Benutzeranmeldeinformationen nicht akzeptiert wird.

C#

So fügen Sie einen Kunden hinzu:

Instanziieren Sie ein neues Kunde-Objekt. Achten Sie darauf, das BillingProfile- und CompanyProfile-Formular auszufüllen.
Fügen Sie den neuen Kunden zu Ihrer IAggregatePartner.Customers-Auflistung hinzu, indem Sie Create oder CreateAsync aufrufen.

Beispiel für C#

// IAggregatePartner partnerOperations;

var partnerOperations = this.Context.UserPartnerOperations;

var customerToCreate = new Customer()
{
    CompanyProfile = new CustomerCompanyProfile()
    {
        Domain = string.Format(CultureInfo.InvariantCulture,
            "SampleApplication{0}.{1}",
            new Random().Next(),
            this.Context.Configuration.Scenario.CustomerDomainSuffix),
        //// OrganizationRegistrationNumber = "123456" // Please add if in specific country/region that requires
    },
    BillingProfile = new CustomerBillingProfile()
    {
        Culture = "EN-US",
        Email = "gena@wingtiptoys.com",
        Language = "En",
        CompanyName = "Wingtip Toys"
        DefaultAddress = new Address()
        {
            FirstName = "Gena",
            MiddleName = "Coralie",
            LastName = "Soto",
            AddressLine1 = "One Microsoft Way",
            City = "Redmond",
            State = "WA",
            Country = "US",
            PostalCode = "98052",
            PhoneNumber = ""
        }
    }
};

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

C#-Beispiel-App

Konsolentest-App. Projekt: Partner Center SDK Samples Class: CreateCustomer.cs

REST

Anforderungssyntax

Methode	Anforderungs-URI
POST	{baseURL}/v1/customers HTTP/1.1

Anforderungsheader

Diese API ist idempotent (sie führt nicht zu einem anderen Ergebnis, wenn Sie sie mehrmals aufrufen).
Eine Anforderungs-ID und Korrelations-ID sind erforderlich.
Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

In dieser Tabelle werden die erforderlichen Eigenschaften im Anforderungstext beschrieben.

Name	Typ	Beschreibung
BillingProfile	Objekt	Die Abrechnungsprofilinformationen des Kunden.
CompanyProfile	Objekt	Die Unternehmensprofilinformationen des Kunden.

Abrechnungsprofil

In dieser Tabelle werden die mindestens erforderlichen Felder aus der Ressource CustomerBillingProfile beschrieben, die zum Erstellen eines neuen Kunden erforderlich sind.

Name	Typ	Beschreibung
email	Zeichenfolge	Wählen Sie die E-Mail-Adresse des Kunden aus.
culture	Zeichenfolge	Ihre bevorzugte Kultur für Kommunikation und Währung, z `en-US`. B. . Siehe Partner Center unterstützte Sprachen und Gebietsschemas für die unterstützten Kulturen.
language	Zeichenfolge	Die Standardsprache. Zwei Zeichensprachencodes (z. B `en` . ) `fr`werden unterstützt.
companyName	Zeichenfolge	Der name der registrierten Firma/Organisation.
defaultAddress	Adresse	Die registrierte Adresse des Unternehmens/der Organisation des Kunden. Informationen zu längenbeschränkungen finden Sie in der Adresse-Ressource .

Unternehmensprofil

In dieser Tabelle werden die mindestens erforderlichen Felder aus der Ressource "CustomerCompanyProfile" beschrieben, die zum Erstellen eines neuen Kunden erforderlich sind.

Name	Typ	Beschreibung
Domäne	Zeichenfolge	Der Domänenname des Kunden, z.B. contoso.onmicrosoft.com.
organizationRegistrationNumber	String	Die Organisationsregistrierungsnummer des Kunden (auch als INN-Nummer in bestimmten Ländern/Regionen bezeichnet). Nur für unternehmen/organisation des Kunden in den folgenden Ländern/Regionen erforderlich: Armenien(AM), Aserbaidschan(AZ), Belarus(BY), Ungarn(HU), Kasachstan(KZ), Kirgisistan(KG), Moldawien(MD), Russland(RU), Tadschikistan(TJ), Usbekistan(UZ), Ukraine(UA), Brasilien(BR), Indien, Südafrika, Polen, Vereinigte Arabische Emirate, Saudi-Arabien, Türkija, Thailand, Vietnam, Myanmar, Irak, Südsudan, Venezuela und China. Für unternehmen/organisation des Kunden in anderen Ländern/Regionen ist dies ein optionales Feld.For customer's company/organization located in other countries/regions, this is an optional field.

GDAP standardmäßig

Name	Typ	Beschreibung
enableGDAPByDefault	bool	Boolean to indicate if we want to enable GDAP by default or not. If true we will create GDAP by default. Wenn "false" lautet, wird kein GDAP erstellt. Beachten Sie, dass dies nur in Clouds berücksichtigt wird, die GDAP unterstützen. Wenn keine Unterstützung vorhanden ist, wird DAP standardmäßig erstellt.

Anforderungsbeispiel

POST https://api.partnercenter.microsoft.com/v1/customers HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 789
Expect: 100-continue
Connection: Keep-Alive

{
    "enableGDAPByDefault": false,
    "CompanyProfile": {
        "Domain": "xyz.onmicrosoft.com"
    },
    "BillingProfile": {
        "Culture": "EN-US",
        "Email": "gena@wingtiptoys.com",
        "Language": "en",
        "CompanyName": "Wingtip Toys",
        "DefaultAddress": {
            "FirstName": "Gena",
            "LastName": "Soto",
            "AddressLine1": "One Microsoft Way",
            "City": "Redmond",
            "State": "WA",
            "PostalCode": "98052",
            "Country": "US"
        }
    }
}

REST-Antwort

Bei erfolgreicher Ausführung gibt diese API eine Kundenressource für den neuen Kunden zurück. Speichern Sie die Kunden-ID und die Microsoft Entra-ID für die zukünftige Verwendung mit dem Partner Center SDK. Sie benötigen sie beispielsweise für die Kontoverwaltung.

Erfolgs- und Fehlercodes der Antwort

Antworten enthalten einen HTTP-Statuscode, der Erfolg oder Fehler und zusätzliche Debuginformationen angibt. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Beispielantwort

HTTP/1.1 201 Created
Content-Length: 834
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CV: ObwhuhD2tUKJoM+Z.0
MS-ServerId: 202010223
Date: Tue, 14 Feb 2017 20:06:02 GMT

{
    "id": "dfd8cc0a-c592-468c-8461-869a38d24738",
    "commerceId": "0a4ce58a-6f96-4273-8035-d9c7d31b9ba4",
    "companyProfile": {
        "tenantId": "dfd8cc0a-c592-468c-8461-869a38d24738",
        "domain": "xyz.onmicrosoft.com",
        "attributes": {
            "objectType": "CustomerCompanyProfile"
        }
    },
    "billingProfile": {
        "id": "d17c0275-da92-5c33-9032-782ef1d0b69b",
        "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": ""
        },
        "attributes": {
            "etag": "5920358838484612121",
            "objectType": "CustomerBillingProfile"
        }
    },
    "enableGDAPByDefault": false,
    "relationshipToPartner": "none",
    "userCredentials": {
        "userName": "admin",
        "password": "=;;n.=s9Z"
    },
    "attributes": {
        "objectType": "Customer"
    }
}

Java

Hinweis

Das Partner Center SDK für Java ist ein Open-Source-Projekt Standard von der Partnercommunity unterstützt.

Führen Sie die folgenden Schritte aus, um einen neuen Kunden zu erstellen.

Erstellen Sie eine neue Instanz der Objekte CustomerBillingProfile und CustomerCompanyProfile. Achten Sie darauf, die erforderlichen Felder aufzufüllen.
Erstellen Sie den Kunden, indem Sie die Funktion "IAggregatePartner.getCustomers().create " aufrufen.

Java-Beispiel

// IAggregatePartner partnerOperations;

Address address = new Address();

address.setFirstName( "Gena" );
address.setLastName( "Soto" );
address.setAddressLine1( "One Microsoft Way" );
address.setCity( "Redmond" );
address.setState( "WA" );
address.setCountry( "US" );
address.setPostalCode( "98052" );
address.setPhoneNumber( "4255550101" );

CustomerBillingProfile billingProfile = new CustomerBillingProfile();

billingProfile.setCulture( "en-US" );
billingProfile.setEmail( "gena@wingtiptoys.com" );
billingProfile.setLanguage( "en" );
billingProfile.setCompanyName( "Wingtip Toys" );
billingProfile.setDefaultAddress( address );

CustomerCompanyProfile companyProfile = new CustomerCompanyProfile();

companyProfile.setDomain( "WingtipToys" + Math.abs( new Random().nextInt() ) + ".onmicrosoft.com" );

Customer customerToCreate = new Customer();

customerToCreate.setBillingProfile( billingProfile );
customerToCreate.setCompanyProfile( companyProfile );

Customer newCustomer = partnerOperations.getCustomers().create( customerToCreate );

PowerShell

Hinweis

Das Partner Center SDK für PowerShell ist ein Open Source-Projekt, das von der Partnercommunity Standard unterstützt wird.

Führen Sie zum Erstellen eines Kunden den Befehl "New-PartnerCustomer " wie im folgenden Beispiel aus.

New-PartnerCustomer -BillingAddressLine1 '1 Microsoft Way' -BillingAddressCity 'Redmond' -BillingAddressCountry 'US' -BillingAddressPostalCode '98052' -BillingAddressState 'WA' -ContactEmail 'gena@wingtiptoys.com' -ContactFirstName 'Gena' -ContactLastName 'Soto' -Culture 'en-US' -Domain 'newcustomer.onmicrosoft.com' -Language 'en' -Name 'New Customer'

Erstellen eines Kunden

Voraussetzungen

C#

Beispiel für C#

C#-Beispiel-App

REST

Anforderungssyntax

Anforderungsheader

Anforderungstext

Abrechnungsprofil

Unternehmensprofil

GDAP standardmäßig

Anforderungsbeispiel

REST-Antwort

Erfolgs- und Fehlercodes der Antwort

Beispielantwort

Java

Java-Beispiel

PowerShell

Feedback

Feedback

Zusätzliche Ressourcen