Ändern eines Kundenabonnements Abrechnungszeitraum

Artikel
06/13/2024

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

Tipp

Mit dieser API können Sie Ihre Abrechnungshäufigkeit nur für Ältere Abonnements ändern.

Um Ihre Abrechnungshäufigkeit für New Commerce Experience (NCE)-Abonnements und ältere Abonnements zu ändern, können Sie ein Abonnement nach ID – Partner-App-Entwickler | Microsoft Learn-API .

Aktualisiert eine Bestellung von monatlich auf jährliche Abrechnung oder von jährlicher bis monatlicher Abrechnung.

In Partner Center kann dieser Vorgang ausgeführt werden, indem er zur Abonnementdetailseite eines Kunden navigiert. Sobald sie vorhanden ist, wird eine Option zum Definieren der aktuellen Abrechnungszeitraum für das Abonnement mit der Möglichkeit angezeigt, es zu ändern und zu übermitteln.

Außerhalb des Umfangs für diesen Artikel:

Ändern der Abrechnungszeitraum für Testversionen
Ändern der Abrechnungszeitraum für nicht jährliche Laufzeitangebote (monatliche, sechsjährige) & Azure-Abonnements
Ändern der Abrechnungszeitraum für inaktive Abonnements
Ändern von Abrechnungszeitraum s für Microsoft Onlinedienste lizenzbasierte Abonnements

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 KUNDEN-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich "Kunden " und dann den Kunden aus der Kundenliste und dann "Konto" auswählen. 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).
Eine Auftrags-ID.

C#

Aktualisieren Sie die Order.BillingCycle-Eigenschaft, um die Häufigkeit des Abrechnungszeitraum zu ändern.

// IAggregatePartner partnerOperations;
// string customerId;
// string offerId;
// string orderId;

var order = new Order()
{
    ReferenceCustomerId = customerId,
    BillingCycle = BillingCycleType.Annual,
    LineItems = new List<OrderLineItem>()
    {
        new OrderLineItem()
        {
            LineItemNumber = 0,
            OfferId = offerId,
            SubscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
            Quantity = 1
        }
    }
};

var createdOrder = partnerOperations.Customers.ById(customerId).Orders.ById(orderId).Patch(order);

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
PATCH	{baseURL}/v1/customers/{customer-tenant-id}/orders/{order-id} HTTP/1.1

URI-Parameter

In dieser Tabelle ist der erforderliche Abfrageparameter aufgeführt, um die Anzahl des Abonnements zu ändern.

Name	Type	Erforderlich	Beschreibung
customer-tenant-id	GUID	Y	Eine guid formatierte Kundenmandanten-ID , die den Kunden identifiziert
order-id	GUID	Y	Der Bestellbezeichner

Anforderungsheader

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

Anforderungstext

In den folgenden Tabellen werden die Eigenschaften im Anforderungstext beschrieben.

Auftrag

Eigenschaft	Type	Erforderlich	Beschreibung
Kennung	Zeichenfolge	N	Ein Auftragsbezeichner, der bei erfolgreicher Erstellung des Auftrags bereitgestellt wird
ReferenceCustomerId	Zeichenfolge	J	Der Kundenbezeichner
BillingCycle	Zeichenfolge	J	Gibt die Häufigkeit an, mit der der Partner für diese Bestellung in Rechnung gestellt wird. Die unterstützten Werte sind die in BillingCycleType angegebenen Elementnamen.
LineItems	Array von Objekten	Y	Ein Array von OrderLineItem-Ressourcen
CreationDate	datetime	N	Das Datum, an dem die Reihenfolge erstellt wurde, im Datums-/Uhrzeitformat
Attribute	Objekt	N	Enthält "ObjectType": "OrderLineItem"

OrderLineItem

Eigenschaft	Type	Erforderlich	Beschreibung
lineitemnumber	Zahl	Y	Die Nummer der Zeile, beginnend mit 0
OfferId	Zeichenfolge	J	Die ID des Angebots
SubscriptionId	Zeichenfolge	J	Die ID des Abonnements
FriendlyName	Zeichenfolge	N	Der Anzeigename für das vom Partner definierte Abonnement, um mehrdeutig zu sein
Menge	Zahl	Y	Die Anzahl der Lizenzen oder Instanzen
PartnerIdOnRecord	Zeichenfolge	N	PartnerID des Datensatzpartners
Attribute	Objekt	N	Enthält "ObjectType": "OrderLineItem"

Anforderungsbeispiel

Aktualisierung auf jährliche Abrechnung

PATCH https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/orders/CF3B0E37-BE0B-4CDD-B584-D1A97D98A922 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 17a2658e-d2cc-439b-a2f0-2aefd9344fbc
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 414
Expect: 100-continue

{
    "Id": null,
    "ReferenceCustomerId": "4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04",
    "BillingCycle" : "Annual",
    "LineItems": [{
            "LineItemNumber": 0,
            "OfferId": "2828BE95-46BA-4F91-B2FD-0BEF192ECF60",
            "SubscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
            "FriendlyName": "Some friendly name",
            "Quantity": 2,
            "PartnerIdOnRecord": null,
            "Attributes": {
                "ObjectType": "OrderLineItem"
            }
        }
    ],
    "CreationDate": null,
    "Attributes": {
        "ObjectType": "Order"
    }
}

REST-Antwort

Bei erfolgreicher Ausführung gibt diese Methode die aktualisierte Abonnementreihenfolge im Antworttext zurück.

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: 1135
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 17a2658e-d2cc-439b-a2f0-2aefd9344fbc
MS-CV: WtFy3zI8V0u2lnT9.0
MS-ServerId: 020021921
Date: Wed, 25 Jan 2017 23:01:08 GMT

{
    "id": "cf3b0e37-be0b-4cdd-b584-d1a97d98a922",
    "referenceCustomerId": "4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04",
    "billingCycle": "Annual",
    "lineItems": [{
            "lineItemNumber": 0,
            "offerId": "195416C1-3447-423A-B37B-EE59A99A19C4",
            "subscriptionId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
            "friendlyName": "new offer purchase",
            "quantity": 5,
            "links": {
                "subscription": {
                    "uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/subscriptions/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
                    "method": "GET",
                    "headers": []
                }
            }
        },
        {
            "lineItemNumber": 1,
            "offerId": "2828BE95-46BA-4F91-B2FD-0BEF192ECF60",
            "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
            "friendlyName": "Some friendly name",
            "quantity": 2,
            "links": {
                "subscription": {
                    "uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
                    "method": "GET",
                    "headers": []
                }
            }
        }
    ],
    "creationDate": "2017-01-25T14:53:12.093-08:00",
    "links": {
        "self": {
            "uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/orders/cf3b0e37-be0b-4cdd-b584-d1a97d98a922",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "etag": "eyJpZCI6ImNmM2IwZTM3LWJlMGItNGNkZC1iNTg0LWQxYTk3ZDk4YTkyMiIsInZlcnNpb24iOjJ9",
        "objectType": "Order"
    }
}

Freigeben über