Aktualisieren des Abrechnungsprofils eines Kunden

Artikel
02/07/2024

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

Aktualisiert das Abrechnungsprofil eines Kunden, einschließlich der adresse, die dem Profil zugeordnet ist.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
Eine Kunden-ID (customer-tenant-id). Wenn Sie die ID des Kunden nicht kennen, können Sie sie im Partner Center nachschlagen. Wählen Sie "Kunden " auf der Startseite aus, und wählen Sie dann den Kunden aus der Kundenliste und dann " Konto" aus. Suchen Sie auf der Seite "Konto" des Kunden im Abschnitt "Kundenkontoinformationen" nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).

C#

Um das Abrechnungsprofil eines Kunden zu aktualisieren, rufen Sie das Abrechnungsprofil ab, und aktualisieren Sie die Eigenschaften nach Bedarf. Rufen Sie dann Ihre IPartner.Customers-Auflistung ab, und rufen Sie dann die ById()-Methode auf. Rufen Sie dann die Profiles-Eigenschaft auf, gefolgt von der Billing-Eigenschaft. Rufen Sie anschließend die Methoden Update() oder UpdateAsync() auf.

// IAggregatePartner partnerOperations;
// var selectedCustomerId as string;

var billingProfile = partnerOperations.Customers.ById(selectedCustomerId).Profiles.Billing.Get();

// Apply changes to profile;

billingProfile = partnerOperations.Customers.ById(selectedCustomerId).Profiles.Billing.Update(billingProfile);

Beispiel: Konsolentest-App. Projekt: PartnerSDK.FeatureSamples-Klasse: UpdateCustomerBillingProfile.cs

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
PUT	{baseURL}/v1/customers/{customer-tenant-id}/profiles/billing HTTP/1.1

URI-Parameter

Verwenden Sie den folgenden Abfrageparameter, um das Abrechnungsprofil zu aktualisieren.

Name	Type	Erforderlich	Beschreibung
customer-tenant-id	guid	J	Der Wert ist eine GUID-formatierte Kundenmandanten-ID , die es dem Händler ermöglicht, die Ergebnisse für einen bestimmten Kunden zu filtern, der zum Händler gehört.

Anforderungsheader

If-Match: "<ETag>" ist für die Parallelitätserkennung erforderlich. Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Die vollständige Ressource.

Beispiel für eine Anfrage

PUT https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/profiles/billing HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: ff85f13a-eb65-4b8e-9b67-05beb0565410
MS-CorrelationId: ff1b757d-cfaf-463a-b48b-0f96d05e95d7
Content-Type: application/json
Content-Length: 639
Expect: 100-continue

{
    "Id": "a58ceba5-60ac-48e4-a0bc-2a855811807a",
    "FirstName": "FirstName",
    "LastName": "LastName",
    "Email": "email@sample.com",
    "Culture": "en-US",
    "Language": "en",
    "CompanyName": "CompanyName",
    "DefaultAddress": {
        "Country": "US",
        "Region": null,
        "City": "Redmond",
        "State": "WA",
        "AddressLine1": "One Microsoft Way",
        "AddressLine2": null,
        "PostalCode": "98052",
        "FirstName": "FirstName",
        "LastName": "LastName",
        "PhoneNumber": "4255555555"
    },
    "Links": {
        "Self": {
            "Uri": "/v1/customers/<customer-tenant-id>/profiles/billing",
            "Method": "GET",
            "Headers": []
        }
    },
    "Attributes": {
        "Etag": "<etag>",
        "ObjectType": "CustomerBillingProfile"
    }
}

REST-Antwort

Wenn die Methode erfolgreich verläuft, werden aktualisierte Profilressourceneigenschaften im Antworttext zurückgegeben. Für diesen Aufruf ist ein ETag zur Parallelitätserkennung erforderlich.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.

Beispielantwort

HTTP/1.1 200 OK
Content-Length: 1210
Content-Type: application/json
MS-CorrelationId: ff1b757d-cfaf-463a-b48b-0f96d05e95d7
MS-RequestId: ff85f13a-eb65-4b8e-9b67-05beb0565410
Date: Mon, 23 Nov 2015 18:20:43 GMT

{
    "id": "a58ceba5-60ac-48e4-a0bc-2a855811807a",
    "firstName": "FirstName",
    "lastName": "LastName",
    "email": "email@sample.com",
    "culture": "en-US",
    "language": "en",
    "companyName": "companyName",
    "defaultAddress": {
        "country": "US",
        "city": "Redmond",
        "state": "WA",
        "addressLine1": "One Microsoft Way",
        "postalCode": "98052",
        "firstName": "FirstName",
        "lastName": "LastName",
        "phoneNumber": "4255555555"
    },
    "links": {
        "self": {
            "uri": "/v1/customers/<customer-tenant-id>/profiles/billing",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "etag": "<etag>",
        "objectType": "CustomerBillingProfile"
    }
}

Share via