TransferEntity resources

A partner creates a transfer to a customer's current partner. The current or source partner accepts the transfer and submits it to complete the transfer.

TransferEntity

Describes a transferEntity for new commerce transfers.

Property	Type	Description
ID	string	A transferEntity identifier that is supplied upon successful creation of the transferEntity.
status	string	The status of the transferEntity. Possible values are "Active" (can be deleted/submitted) and "Completed" (has already been completed). Applied upon successful creation of the transferEntity.
transferType	string	A number representing the type of transfer. 3 resolves to ModernAzure and 5 resolves to NewCommerce. Partners executing partner to partner new commerce transfers can use either but should standardize on 5.
customerEmailId	string	Identifies the customer email Used for notifications.
createdTime	DateTime	The date the transferEntity was created, in date-time format. Applied upon successful creation of the transferEntity.
lastModifiedTime	DateTime	The date the transferEntity was last updated, in date-time format. Applied upon successful creation of the transferEntity.
completedTime	DateTime	The date the transferEntity was completed, in date-time format. Applied upon successful completion of the transferEntity.
customerName	string	Optional. The name of the customer whose subscriptions are being transferred.
customerTenantId	string	A GUID formatted customer ID that identifies the customer. Applied upon successful creation of the transferEntity.
partnertenantid	string	A GUID formatted partner ID that identifies the partner.
sourcePartnerName	string	Optional. The name of the partner's organization who is initiating the transfer.
targetPartnerName	string	Optional. The name of the partner's organization to whom the transfer is targeted.
partnerOnRecord	string	Optional. The partner of record indirect providers assign to the transfered line items.
targetProductTypes	string	Optional. A collection of strings that dictate the types of subscriptions that can be submitted for a transfer. Null is assumed all types. Values can include AzureSubscription, AzureReservation, AzureSavingsPlan, and OnlineServicesNCE.
targetPartnerTenantId	string	A GUID formatted partner ID that identifies the partner to whom the transfer is targeted.
targetPartnerEmailId	string	A GUID formatted partner ID that identifies the partner to whom the transfer is targeted. This ID is the same as the targetPartnerTenantId
transferDirection	string	A number representing the direction of the transfer. 1 represents an incoming transfer for the partner who accepts the transfer. 2 represents outgoing transfer for the partner who creates the transfer.
ignoreEligibilityCheck	string	This value should be false.
lastModifiedUser	string	A GUID formatted user ID that identifies the last user to modify the transfer
lineItems	Array of objects	An Array of TransferLineItem resources.

TransferLineItem

Represents one item contained in a new commerce transferEntity. Source partners see line items for the transfer of items they're attempting to transfer. Target partners see newly created line items after they're completed. Target partners can use the line item IDs to help understand newly created subscriptions that result from the transfer.

Property	Type	Description
ID	string	A unique identifier for a transfer line item. Applied upon successful creation of the transferEntity.
friendlyName	string	The name of the subscription.
subscriptionId	string	The subscription identifier.
quantity	int	The number of licenses or instances.
billingCycle	Object	The type of billing cycle set for the current period.
productType	string	A string representing the type of product transferred.
status	string	The status of the line item in the transferEntity.
sourceSubscriptionTermStartDate	dateTime	This value represents the creation date and time (in UTC) of the source subscription transfered to the target partner.
price	list of prices	A collection of pricing values for a completed transfer line item. Only applicable for new commerce license-based transfer line items.

Price

Price represents values that explain how much the line items cost. There are four values included in price.

Property	Type	Description
listPrice	floating point integer	The single unit price for the next billing period without applying any price modifiers. This amount is before taxation. In tax inclusive countries/regions, this price includes the tax; otherwise not. Unit Price per billing period. Only applicable for new commerce license-based transfer line items.
discountedPrice	floating point integer	The ListPrice after applying all applicable price modifiers. This amount is before taxation. In tax inclusive countries/regions, this price includes the tax; otherwise not. Only applicable for new commerce license-based transfer line items.
price	floating point integer	The prorated unit charge amount for the remaining billing cycle. The single quantity price in the target billing currency after all discounts have been applied and any proration has been performed. This amount is before taxation. In tax inclusive countries/regions, this price includes the tax; otherwise not. This is UnitPrice in the UX. Next unit bill amount. Only applicable for new commerce license-based transfer line items.
extendedPrice	floating point integer	The price of the line item with quantity, discounts and proration applied, in the target billing currency. For the remainder of the term. This amount is before taxation. In tax inclusive countries/regions, this price includes the tax; otherwise not. This is TotalPrice in the UX. Only applicable for new commerce license-based transfer line items.
currencyCode	string	The abbreviation for the pricing currency. Only applicable for new commerce license-based transfer line items.

TransferEntity for traditional license-based transfers

Describes a transferEntity.

Property	Type	Description
ID	string	A transferEntity identifier that is supplied upon successful creation of the transferEntity.
createdTime	DateTime	The date the transferEntity was created, in date-time format. Applied upon successful creation of the transferEntity.
lastModifiedTime	DateTime	The date the transferEntity was last updated, in date-time format. Applied upon successful creation of the transferEntity.
lastModifiedUser	string	The user who last updated the transferEntity. Applied upon successful creation of transferEntity.
customerName	string	Optional. The name of the customer whose subscriptions are being transferred.
customerTenantId	string	A GUID formatted customer ID that identifies the customer. Applied upon successful creation of the transferEntity.
partnertenantid	string	A GUID formatted partner ID that identifies the partner.
sourcePartnerName	string	Optional. The name of the partner's organization who is initiating the transfer.
sourcePartnerTenantId	string	A GUID formatted partner ID that identifies the partner initiating the transfer.
targetPartnerName	string	Optional. The name of the partner's organization to whom the transfer is targeted.
targetPartnerTenantId	string	A GUID formatted partner ID that identifies the partner to whom the transfer is targeted.
lineItems	Array of objects	An Array of TransferLineItem resources.
status	string	The status of the transferEntity. Possible values are "Active" (can be deleted/submitted) and "Completed" (has already been completed). Applied upon successful creation of the transferEntity.

TransferLineItem for traditional license-based transfers

Represents one item contained in a transferEntity.

Property	Type	Description
ID	string	A unique identifier for a transfer line item. Applied upon successful creation of the transferEntity.
subscriptionId	string	The subscription identifier.
quantity	int	The number of licenses or instances.
billingCycle	Object	The type of billing cycle set for the current period.
friendlyName	string	Optional. The friendly name for the item defined by the partner to help disambiguate.
partnerIdOnRecord	string	PartnerId on Record on the purchase that happens when the transfer is accepted.
offerId	string	The offer identifier.
addonItems	List of TransferLineItem objects	A collection of transferEntity line items for addons that are transferred along with the base subscription that is being transferred. Applied upon successful creation of the transferEntity.
transferError	string	Applied after transferEntity is accepted in case there's an error.
status	string	The status of the line item in the transferEntity.

TransferSubmitResult

Represents the result of a transfer accept for traditional license-based transfers.

Property	Type	Description
orders	List of Order objects.	The collection of orders.
transferErrors	List of TransferError objects.	The collection of transfer errors.

TransferError

Represents an error that occurs when a traditional license-based transfer is accepted.

Property	Type	Description
transferGroupId	string	The order group ID of the order with the error.
code	int	The error code.
description	string	The description of the error.
lineItems	List of TransferLineItem objects	A collection of transferEntity line items that are part of the transfer error.

TransferErrorCode

An [Enum/dotnet/api/system.enum) with values that indicate a type of order error for traditional license-based transfers.

Value	Position	Description
PartnerTokenMissing	800001	Partner Token missing in request context.
InvalidInput	800002	Invalid request input.
ServiceException	800003	Unexpected service error.
InvalidOfferId	800004	Invalid offer ID.
CreateOrderError	800005	Create order isn't successful.
MpnIdNotFound	800015	PartnerID isn't found.
NotValidIndirectResellerMpnId	800016	PartnerID isn't a valid Indirect Reseller.
TransferIdNotFound	900100	Transfer request not found.
TransferNotAllowedIfStatusIsInProgress	900101	The transfer request is already in progress.
TransferNotAllowedIfStatusIsCompleted	900102	The transfer request is already complete.
TransferCreateOrderError	900103	The transfer order isn't successful.
TransferProcessedByAnotherRequest	900104	The transfer is being processed by another request.