Einkaufswagenressourcen

  • Artikel

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

Ein Partner platziert eine Bestellung, wenn ein Kunde ein Abonnement aus einer Liste von Angeboten kaufen möchte.

Warenkorb

Beschreibt einen Warenkorb.

Eigenschaft Type Beschreibung
id Zeichenfolge Ein Warenkorbbezeichner, der bei erfolgreicher Erstellung des Warenkorbs bereitgestellt wird.
creationTimeStamp DateTime Das Datum, an dem der Warenkorb erstellt wurde, im Datums-/Uhrzeitformat. Auf erfolgreiche Erstellung des Warenkorbs angewendet.
lastModifiedTimeStamp DateTime Das Datum, an dem der Warenkorb zuletzt im Datums-/Uhrzeitformat aktualisiert wurde. Auf erfolgreiche Erstellung des Warenkorbs angewendet.
expirationTimeStamp DateTime Das Datum, an dem der Warenkorb abläuft, im Datums-/Uhrzeitformat. Auf erfolgreiche Erstellung des Warenkorbs angewendet.
lastModifiedUser Zeichenfolge Der Benutzer, der den Warenkorb zuletzt aktualisiert hat. Auf erfolgreiche Erstellung des Warenkorbs angewendet.
lineItems Array von Objekten Ein Array von CartLineItem-Ressourcen .
status Zeichenfolge Der Status des Warenkorbs. Mögliche Werte sind "Aktiv" (kann aktualisiert/übermittelt werden) und "Bestellt" (wurde bereits übermittelt).

CartLineItem

Stellt ein Element dar, das in einem Warenkorb enthalten ist.

Eigenschaft Type Beschreibung
id Zeichenfolge Ein eindeutiger Bezeichner für einen Einkaufswagenartikel. Auf erfolgreiche Erstellung des Warenkorbs angewendet.
catalogItemId Zeichenfolge Der Katalogelementbezeichner.
friendlyName Zeichenfolge Optional. Der Anzeigename für das element, das vom Partner definiert wurde, um mehrdeutig zu sein.
Menge INT Die Anzahl der Lizenzen oder Instanzen.
currencyCode Zeichenfolge Der Währungscode.
billingCycle Object Der Typ der Abrechnungszeitraum für den aktuellen Zeitraum festgelegt.
termDuration Zeichenfolge Eine ISO 8601-Darstellung der Dauer des Begriffs. Die aktuellen unterstützten Werte sind P1M (ein Monat), P1Y (ein Jahr) und P3Y (drei Jahre).
participants Liste der Objektzeichenfolgenpaare Eine Sammlung von PartnerID on Record für den Kauf.
provisioningContext Wörterbuchzeichenfolge<, Zeichenfolge> Zusätzlicher Kontext, der beim Bereitstellen des gekauften Artikels verwendet wird. Um zu ermitteln, welche Werte für ein bestimmtes Element erforderlich sind, verweisen Sie auf die Eigenschaft "provisioningVariables" der SKU.
orderGroup Zeichenfolge Eine Gruppe, die angibt, welche Elemente in derselben Reihenfolge zusammen übermittelt werden können.
addonItems Liste der CartLineItem-Objekte Eine Sammlung von Einkaufswagenpositionen für Addons. Diese Artikel werden in Richtung des Basisabonnements erworben, das aus dem Kauf des Stammwagens resultiert.
error Object Angewendet nach dem Erstellen des Warenkorbs, wenn ein Fehler aufgetreten ist.
renewsTo Array von Objekten Ein Array von RenewsTo-Ressourcen .
AttestationAccepted bool Gibt die Vereinbarung zum Anbieten oder SKU-Bedingungen an. Nur für Angebote oder Skus erforderlich, bei denen SkuAttestationProperties oder OfferAttestationProperties enforceAttestation True ist.
promotionId Zeichenfolge Die Werbeaktions-ID, die auf den Einkaufswagenartikel angewendet werden soll.
customTermEndDate DateTime Das Enddatum der ersten Abrechnungsdauer des neuen Abonnements.

Preisberechnung

Stellt die Preisdetails dar. Preisbeträge werden vor steuern bereitgestellt.

Eigenschaft Type Erforderlich Beschreibung
Listprice double Nein Im Katalog aufgeführter Preis ohne Angewendete Preismodifizierer.
Ermäßigter Preis double Nein Preis nach Anwendung aller anwendbaren Preismodifizierer.
Anteilspreis double Nein Ermäßigter Preis nach Der Anteil wurde durchgeführt.
Preis double Nein Preis in der anwendbaren Abrechnungswährung, nachdem alle Rabatte angewendet und Anteil vorgenommen wurden.
extendedPrice double Nein Der Preis der Position mit Menge, Rabatten und Anteilen wird in der anwendbaren Abrechnungswährung angewendet.

RenewsTo

Stellt einen Artikel dar, der in einem Einkaufswagenartikel enthalten ist.

Eigenschaft Type Erforderlich Beschreibung
termDuration Zeichenfolge Nein Eine ISO 8601-Darstellung der Dauer der Verlängerung. Die aktuellen unterstützten Werte sind P1M (ein Monat) und P1Y (ein Jahr).

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 finden Sie unter Partner Center-Fehlercodes.

CartError

Stellt einen Fehler dar, der auftritt, nachdem ein Warenkorb erstellt wurde.

Eigenschaft Type Beschreibung
errorCode CartErrorCode Der Typ des Einkaufswagenfehlers.
errorDescription Zeichenfolge Die Fehlerbeschreibung, einschließlich aller Hinweise zu unterstützten Werten, Standardwerten oder Grenzwerten.
additionalInformation AdditionalInformation Zusätzliche Informationen für den Fehler.

AdditionalInformation

Zusätzliche Informationen zum Fehler.

Eigenschaft Type Beschreibung
verfügbare Menge INT Die Anzahl der neu Standard Lizenzen, die für die angegebene Produkt-SKU erworben werden können.
gekaufte Menge INT Die Anzahl der erworbenen Lizenzen.

CartErrorCode

Arten von Einkaufswagenfehlern.

Name ErrorCode Beschreibung
CurrencyIsNotSupported 10000 Währung wird für einen bestimmten Markt nicht unterstützt
CatalogItemIdIsNotValid 10001 Die Katalogelement-ID ist ungültig.
QuotaNotAvailable 10002 Nicht genügend Kontingent verfügbar
InventoryNotAvailable 10003 Lagerbestand ist für ausgewähltes Angebot nicht verfügbar
ParticipantsIsNotSupportedForPartner 10004 Das Festlegen von Teilnehmern wird für Partner nicht unterstützt.
UnableToProcessCartLineItem 10006 Artikel der Einkaufswagenposition kann nicht verarbeitet werden.
SubscriptionIsNotValid 10007 Das Abonnement ist ungültig.
SubscriptionIsNotEnabledForRI 10008 Das Abonnement ist für Reservierungskäufe nicht aktiviert.
SandboxLimitExceeded 10009 Der Sandkastengrenzwert wurde überschritten.
InvalidInput 10010 Generische Eingabe ist ungültig.
SubscriptionNotRegistered 10011 Das Abonnement ist ungültig.
AttestationNotAccepted 10012 Der Nachweis wurde nicht akzeptiert.
MaxAllowedSeatsPerSubscriptionExceeded 10015 Die angeforderte Anzahl von Arbeitsplätzen überschreitet den Grenzwert.
Unbekannt 0 Standardwert

CartCheckoutResult

Stellt das Ergebnis eines Einkaufswagencheckvorgangs dar.

Eigenschaft Type Beschreibung
Aufträge Liste der Order-Objekte . Die Sammlung von Bestellungen.
orderErrors Liste der OrderError-Objekte . Die Auflistung von Bestellfehlern.

OrderError

Stellt einen Fehler dar, der während eines Einkaufswagencheckvorgangs auftritt, wenn eine Bestellung erstellt wird.

Eigenschaft Type Beschreibung
orderGroupId Zeichenfolge Die Auftragsgruppen-ID der Bestellung mit dem Fehler.
code INT Der Fehlercode.
Beschreibung string Die Beschreibung des Fehlers.