Method: splitBulkEntitlement

Description

The splitBulkEntitlement operation assigns a specified number of unredeemed web register keys to a related account in a different distribution tier. The web register keys that are split can be transfered to:

• A compatible existing bulk entitlement (transfers the web register keys to that bulk entitlement).

• An existing line item that has been redeemed from a compatible web register key (adds the counts from the transferred web register keys to the count of the line item).

• A new bulk entitlement.

Only publisher users, or channel partner users with sufficient privileges in the account that is the current owner, can perform a splitBulkEntitlement operation.

Note: You cannot control the specific web register keys that splitBulkEntitlement transfers.

Parameters

Name	Type	Direction	Description
msgparameters	splitBulkEntitlementRequestType	Input

Returns

A splitBulkEntitlementResponse element having the structure defined by the following table.

Name	Type	Description
statusInfo	StatusInfoType	Element  Data Type  Description  status StatusType Returns one of the following: SUCCESS—All items in the request were processed. PARTIAL_FAILURE—Some, but not all items in the request were processed. The getCount and getQuery operations never return PARTIAL_FAILURE. FAILURE—None of the items in the request were processed. reason string Gives reason for partial failure or failure.
responseData	splitBulkEntitlementResponseListType	Information about the bulk entitlement that was split, and optionally the bulk entitlement to which the split web register keys went, is listed in the responseData element. See splitBulkEntitlementResponseListType.
failedData	failedSplitBulkEntitlementListType	Information about an entitlement line item that was not split is listed in the failedData element. See failedSplitBulkEntitlementListType.