TransferEntity resources

บทความ
10/17/2024

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.
targetPartnerTenantId	string	A GUID formatted partner-id that identifies the partner to whom the transfer is targeted.
targetPartnerEmailId	string	A GUID formatted pid 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 are attempting to transfer. Target partners see newly created line items after they are 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.
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 lineitem in the transferEntity.

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

แชร์ผ่าน