Erstellen eines Kunden für einen indirekten Händler mithilfe von Partner Center-APIs
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 |
|---|---|---|---|
| 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 . ) frwerden 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: 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"
}
}
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: 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"
}
}
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für