Freigeben über

TransferEntity-Ressourcen

  • Artikel

Ein Partner erstellt eine Übertragung an den aktuellen Partner eines Kunden. Der aktuelle Partner oder der Quellpartner akzeptiert die Übertragung und übermittelt sie, um die Übertragung abzuschließen.

TransferEntity

Beschreibt eine TransferEntity für neue Handelstransfers.

Eigenschaft Typ Beschreibung
id Zeichenfolge Ein transferEntity-Bezeichner, der bei erfolgreicher Erstellung der transferEntity bereitgestellt wird.
status Zeichenfolge Der Status der transferEntity. Mögliche Werte sind "Aktiv" (kann gelöscht/übermittelt werden) und "Abgeschlossen" (wurde bereits abgeschlossen). Auf erfolgreiche Erstellung der transferEntity angewendet.
transferType Zeichenfolge Eine Zahl, die den Übertragungstyp darstellt.
customerEmailId Zeichenfolge Identifiziert die für Benachrichtigungen verwendete Kunden-E-Mail.
createdTime DateTime Das Datum, an dem die transferEntity erstellt wurde, im Datums-/Uhrzeitformat. Auf erfolgreiche Erstellung der transferEntity angewendet.
lastModifiedTime DateTime Das Datum, an dem die transferEntity zuletzt aktualisiert wurde, im Datums-/Uhrzeitformat. Auf erfolgreiche Erstellung der transferEntity angewendet.
completedTime DateTime Das Datum, an dem die transferEntity abgeschlossen wurde, im Datums-/Uhrzeitformat. Anwendung nach erfolgreichem Abschluss der transferEntity.
customerName Zeichenfolge Optional. Der Name des Kunden, dessen Abonnements übertragen werden.
customerTenantId Zeichenfolge Eine guid formatierte Kunden-ID, die den Kunden identifiziert. Auf erfolgreiche Erstellung der transferEntity angewendet.
partnertenantid Zeichenfolge Eine guid formatierte Partner-ID, die den Partner identifiziert.
sourcePartnerName Zeichenfolge Optional. Der Name der Organisation des Partners, die die Übertragung initiiert.
targetPartnerName Zeichenfolge Optional. Der Name der Organisation des Partners, an die die Übertragung gerichtet ist.
targetPartnerTenantId Zeichenfolge Eine GUID-formatierte Partner-ID, die den Partner identifiziert, an den die Übertragung gerichtet ist.
targetPartnerEmailId Zeichenfolge Eine guid formatierte PID, die den Partner identifiziert, an den die Übertragung gerichtet ist. Diese ID ist identisch mit der targetPartnerTenantId
transferDirection Zeichenfolge Eine Zahl, die die Richtung der Übertragung darstellt.
ignoreEligibilityCheck Zeichenfolge Dieser Wert sollte falsch sein.
lastModifiedUser Zeichenfolge Eine GUID-formatierte Benutzer-ID, die den letzten Benutzer identifiziert, um die Übertragung zu ändern.
lineItems Array von Objekten Ein Array von TransferLineItem-Ressourcen .

TransferLineItem

Stellt ein Element dar, das in einer neuen Commerce transferEntity enthalten ist.

Eigenschaft Typ Beschreibung
id Zeichenfolge Ein eindeutiger Bezeichner für ein Übertragungszeilenelement. Auf erfolgreiche Erstellung der transferEntity angewendet.
subscriptionId Zeichenfolge Die Abonnement-ID.
Menge int Die Anzahl der Lizenzen oder Instanzen.
billingCycle Objekt Der Typ der Abrechnungszeitraum für den aktuellen Zeitraum festgelegt.
productType Zeichenfolge Eine Zeichenfolge, die den Typ des übertragenen Produkts darstellt.
status Zeichenfolge Der Status des Lineitem in der transferEntity.

TransferEntity für herkömmliche lizenzbasierte Übertragungen

Beschreibt eine transferEntity.

Eigenschaft Typ Beschreibung
id Zeichenfolge Ein transferEntity-Bezeichner, der bei erfolgreicher Erstellung der transferEntity bereitgestellt wird.
createdTime DateTime Das Datum, an dem die transferEntity erstellt wurde, im Datums-/Uhrzeitformat. Auf erfolgreiche Erstellung der transferEntity angewendet.
lastModifiedTime DateTime Das Datum, an dem die transferEntity zuletzt aktualisiert wurde, im Datums-/Uhrzeitformat. Auf erfolgreiche Erstellung der transferEntity angewendet.
lastModifiedUser Zeichenfolge Der Benutzer, der die transferEntity zuletzt aktualisiert hat. Angewendet auf erfolgreiche Erstellung von transferEntity.
customerName Zeichenfolge Optional. Der Name des Kunden, dessen Abonnements übertragen werden.
customerTenantId Zeichenfolge Eine guid formatierte Kunden-ID, die den Kunden identifiziert. Auf erfolgreiche Erstellung der transferEntity angewendet.
partnertenantid Zeichenfolge Eine guid formatierte Partner-ID, die den Partner identifiziert.
sourcePartnerName Zeichenfolge Optional. Der Name der Organisation des Partners, die die Übertragung initiiert.
sourcePartnerTenantId Zeichenfolge Eine guid formatierte Partner-ID, die den Partner identifiziert, der die Übertragung initiiert.
targetPartnerName Zeichenfolge Optional. Der Name der Organisation des Partners, an die die Übertragung gerichtet ist.
targetPartnerTenantId Zeichenfolge Eine GUID-formatierte Partner-ID, die den Partner identifiziert, an den die Übertragung gerichtet ist.
lineItems Array von Objekten Ein Array von TransferLineItem-Ressourcen .
status Zeichenfolge Der Status der transferEntity. Mögliche Werte sind "Aktiv" (kann gelöscht/übermittelt werden) und "Abgeschlossen" (wurde bereits abgeschlossen). Auf erfolgreiche Erstellung der transferEntity angewendet.

TransferLineItem für herkömmliche lizenzbasierte Übertragungen

Stellt ein Element dar, das in einer transferEntity enthalten ist.

Eigenschaft Typ Beschreibung
id Zeichenfolge Ein eindeutiger Bezeichner für ein Übertragungszeilenelement. Auf erfolgreiche Erstellung der transferEntity angewendet.
subscriptionId Zeichenfolge Die Abonnement-ID.
Menge int Die Anzahl der Lizenzen oder Instanzen.
billingCycle Objekt Der Typ der Abrechnungszeitraum für den aktuellen Zeitraum festgelegt.
friendlyName Zeichenfolge Optional. Der Anzeigename für das element, das vom Partner definiert wurde, um mehrdeutig zu sein.
partnerIdOnRecord Zeichenfolge PartnerId on Record on the purchase that happens when the transfer is accepted.
offerId Zeichenfolge Die Angebots-ID
addonItems Liste der TransferLineItem-Objekte Eine Sammlung von transferEntity-Positionen für Addons, die zusammen mit dem übertragenen Basisabonnement übertragen werden. Auf erfolgreiche Erstellung der transferEntity angewendet.
transferError Zeichenfolge Wird angewendet, nachdem transferEntity akzeptiert wurde, falls ein Fehler auftritt.
status Zeichenfolge Der Status des Lineitem in der transferEntity.

TransferSubmitResult

Stellt das Ergebnis einer Übertragung für herkömmliche lizenzbasierte Übertragungen dar.

Eigenschaft Typ Beschreibung
Aufträge Liste der Order-Objekte . Die Sammlung von Bestellungen.
transferErrors Liste der TransferError-Objekte . Die Sammlung von Übertragungsfehlern.

TransferError

Stellt einen Fehler dar, der auftritt, wenn eine herkömmliche lizenzbasierte Übertragung akzeptiert wird.

Eigenschaft Typ Beschreibung
transferGroupId Zeichenfolge Die Auftragsgruppen-ID der Bestellung mit dem Fehler.
code int Der Fehlercode.
Beschreibung string Die Beschreibung des Fehlers.
lineItems Liste der TransferLineItem-Objekte Eine Sammlung von transferEntity-Zeilenelementen, die Teil des Übertragungsfehlers sind.

TransferErrorCode

Eine [Enum/dotnet/api/system.enum) mit Werten, die einen Auftragsfehlertyp für herkömmliche lizenzbasierte Übertragungen angeben.

Wert Position Beschreibung
PartnerTokenMissing 800001 Partnertoken fehlt im Anforderungskontext.
InvalidInput 800002 Ungültige Anforderungseingabe.
ServiceException 800003 Unerwarteter Dienstfehler.
InvalidOfferId 800004 Ungültige Angebots-ID.
CreateOrderError 800005 Die Reihenfolge zum Erstellen ist nicht erfolgreich.
MpnIdNotFound 800015 PartnerID wurde nicht gefunden.
NotValidIndirectResellerMpnId 800016 PartnerID ist kein gültiger indirekter Wiederverkäufer.
TransferIdNotFound 900100 Die Übertragungsanforderung wurde nicht gefunden.
TransferNotAllowedIfStatusIsInProgress 900101 Die Übertragungsanforderung wird bereits ausgeführt.
TransferNotAllowedIfStatusIsCompleted 900102 Die Übertragungsanforderung ist bereits abgeschlossen.
TransferCreateOrderError 900103 Der Überweisungsauftrag ist nicht erfolgreich.
TransferProcessedByAnotherRequest 900104 Die Übertragung wird von einer anderen Anforderung verarbeitet.