TransferEntity-Ressourcen
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. 3 löst in ModernAzure und 5 wird in NewCommerce aufgelöst. Partner, die Partner für neue E-Commerce-Übertragungen ausführen, können entweder entweder verwenden, sollten aber auf 5 standardisieren. |
| 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. 1 stellt eine eingehende Übertragung für den Partner dar, der die Übertragung akzeptiert. 2 stellt ausgehende Übertragung für den Partner dar, der die Übertragung erstellt. |
| 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. Quellpartner sehen Positionen für die Übertragung von Elementen, die sie übertragen möchten. Zielpartner sehen neu erstellte Zeilenelemente, nachdem sie abgeschlossen wurden. Zielpartner können die Zeilenelement-IDs verwenden, um neu erstellte Abonnements zu verstehen, die sich aus der Übertragung ergeben.
| 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. |