Erstellen eines Kunden für einen indirekten Händler mithilfe von Partner Center-APIs

Artikel
03/28/2024

Gilt für: Partner Center

Ein indirekter Anbieter kann einen Kunden für einen indirekten Wiederverkäufer erstellen.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.
Der Mandantenbezeichner des indirekten Wiederverkäufers.
Der indirekte Wiederverkäufer muss über eine Partnerschaft mit dem indirekten Anbieter verfügen.

C#

So fügen Sie einen neuen Kunden für einen indirekten Wiederverkäufer hinzu:

Instanziieren Sie ein neues Customer-Objekt und instanziieren Sie dann das BillingProfile- und CompanyProfile-Objekt. Stellen Sie sicher, dass Sie der AssociatedPartnerID-Eigenschaft die indirekte Händler-ID zuweisen.
Verwenden Sie die Eigenschaft "IAggregatePartner.Customers ", um eine Schnittstelle zu Kundensammlungsvorgängen abzurufen.
Rufen Sie die Create- oder CreateAsync-Methode auf, um den Kunden zu erstellen.

Beispiel für 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);

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

REST-Anforderung

Anforderungssyntax

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

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

In dieser Tabelle werden die erforderlichen Eigenschaften im Anforderungstext beschrieben.

Name	Type	Erforderlich	Beschreibung
BillingProfile	Objekt	Ja	Die Abrechnungsprofilinformationen des Kunden.
CompanyProfile	Objekt	Ja	Die Unternehmensprofilinformationen des Kunden.
AssociatedPartnerId	Zeichenfolge	Ja	Die indirekte Händler-ID. Der indirekte Wiederverkäufer gemäß der hier angegebenen ID muss über eine Partnerschaft mit dem indirekten Anbieter verfügen, oder die Anforderung schlägt fehl. Beachten Sie außerdem, dass der Kunde, wenn der Wert "AssociatedPartnerId" nicht angegeben wird, als direkter Kunde des indirekten Anbieters und nicht als indirekter Wiederverkäufer erstellt wird.
Domäne	String	Ja	Der Domänenname des Kunden, z.B. contoso.onmicrosoft.com.
organizationRegistrationNumber	Zeichenfolge	Ja	Die Organisationsregistrierungsnummer des Kunden (auch als INN-Nummer in bestimmten Ländern/Regionen bezeichnet). Nur erforderlich für die Firma/Organisation des Kunden in den folgenden Ländern/Regionen: Armenien(AM), Aserbaidschan(AZ), Belarus(BY), Ungarn(HU), Kasachstan(KZ), Kirgisistan(KG), Moldawien(MD), Russland(RU), Tadschikistan(TJ), Usbekistan(UZ), Ukraine(UA), Indien, Brasilien, Südafrika, Polen, Vereinigte Arabische Emirate, Saudi-Arabien, Türkiya, Thailand, Vietnam, Myanmar, Irak, Südsudan und Venezuela. 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.

Abrechnungsprofil

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

Name	Type	Erforderlich	Beschreibung
email	Zeichenfolge	Ja	Wählen Sie die E-Mail-Adresse des Kunden aus.
culture	Zeichenfolge	Ja	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	string	Ja	Die Standardsprache. Zwei Zeichensprachencodes (z. B `en` . ) `fr`werden unterstützt.
company_name	Zeichenfolge	Ja	Der name der registrierten Firma/Organisation.
default_address	Adresse	Ja	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	Type	Erforderlich	Beschreibung
Domäne	Zeichenfolge	Ja	Der Domänenname des Kunden, z.B. contoso.onmicrosoft.com.
organizationRegistrationNumber	Zeichenfolge	Hängt von der Bedingung ab	Die Organisationsregistrierungsnummer des Kunden (auch als INN-Nummer in bestimmten Ländern/Regionen bezeichnet). Das Ausfüllen dieses Felds ist nur erforderlich, wenn sich das Unternehmen/die Organisation eines Kunden in den folgenden Ländern/Regionen befindet: - Armenien (AM) - Aserbaidschan (AZ) - Belarus (BY) - Ungarn (HU) - Kasachstan (KZ) - Kirgisistan (KG) - Moldawien (MD) - Russland (RU) - Tadschikistan (TJ) - Usbekistan (UZ) - Ukraine (UA) -Indien -Brazilien -Südafrika -Polen - Vereinigte Arabische Emirate -Saudi-Arabien -Türkiye -Thailand -Vietnam -Myanmar -Irak -Südsudan -Venezuela - 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>
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"
    }
}

Wichtig

Ab Juni 2023 ist jetzt die neueste Partner Center .NET SDK-Version 3.4.0 archiviert. Sie können das SDK-Release von GitHub zusammen mit einer Infodatei herunterladen, die nützliche Informationen enthält.

Partnern wird empfohlen, weiterhin die Partner Center-REST-APIs zu verwenden.

REST-Antwort

Wenn die Antwort erfolgreich verläuft, enthält die Antwort eine Kundenressource für den neuen Kunden.

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

Freigeben über