Einkaufswagenressourcen
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. |