SplitPercentageApply

Description

The SplitPercentageApply assignment type, configured in transaction XML, is used to apply money removed from a contract by the SplitPercentageRemoval assignment type. The money removed is applied to a different contract as that from which money was removed using the SplitPercentageRemoval assignment. SplitPercentageApply can apply the money to either the same group of funds or a different group of funds as used by SplitPercentageRemoval.

The valuation records for the corresponding SplitPercentageRemoval assignment are used as the data source for the SplitPercentageApply assignment–the user configures SplitPercentageApply's attributes to link back to the valuation records created by SplitPercentageRemoval.

Data Storage

For both inception and Point-in-Time valuation, valuation records are created for each SplitPercentageApply with effective dates equal to the activity's effective date. However, these valuation records are stored differently depending on the valuation type:

For Inception valuation, SplitPercentageApply will create new AsValuation records upon processing, with values obtained from the corresponding SplitPercentageRemoval's Activity GUID.
For Point-in-Time valuation, processing works the same as with Inception valuation, except in the way that data is stored in the valuation tables. If deposit-level tracking is set to "Fund," Point-in-Time valuation records are created in the following tables, reflecting the amount applied by the SplitPercentageApply assignment:
- AsDepositValue
  - Beginning and End Value records are created for each deposit of each fund.
  - If the Apply is occurring on the same funds as the Removal, the Original Deposit Date is captured in the new column OriginalDepositDate. The values in this column are equal to the Effective Dates of the original deposits.
  - The Effective Date of the AsDepositValue is equal to the effective date of the activity that initiated the SplitPercentage Removal
- AsDepositValueField
- AsDepositValuationEffect
- AsFundValueField
- AsFundValuationEffect
- AsPolicyValue
  - Beginning and End Value records are created for each SplitPercentageRemoval processed.
- AsPolicyValueField
- AsPolicyValuationEffect
- AsPolicyValuesCalculation
- AsPolicyValuesCalculationField
For PIT valuation with fund-level tracking, the AsDeposit tables above are not populated, but the applicable percentage is deducted from each fund value.

SplitPercentageApply Assignment Type
Type	SplitPercentageApply
Attributes	SPLITPERCENTAGEREMOVALGUID	Required: This attribute's value should be a math variable that resolves to an Activity GUID of the corresponding removal
	SPLITPERCENTAGEREMOVALMONEYTYPE	Required: This attribute's value should be a typecode defined in AsCodeMoneyType. This typecode identifies the MoneyType of the corresponding removal valuation records. The MoneyType is needed to help identify the portion of the removal that needs to be applied to the new policy.
	SPLITPERCENTAGEAPPLYMONEYTYPE	Required: This attribute's value should be a typecode defined in AsCodeMoneyType. This type identifies the MoneyType of the source of the funds.
	CURRENTALLOCATIONCOLLECTION	Optional: This attribute's value should be a Collection math variable. The keys used are the GUIDs of the source funds from which money was removed with SplitPercentageRemoval, and the associated values are the GUIDs of the funds to which the money is being applied. This attribute only needs to be used if the Removal and Apply assignments use different funds. Note: If the Collection resolves to NULL, the system will attempt to process the Apply activity's assignment using the same funds that were used in the corresponding Removal. If any of the funds are not available to the Apply activity's plan, a system error will occur.
Element Value	None
Note: Unlike other assignment types, the SplitPercentageApply assignment's MoneyType is defined in the SPLITPERCENTAGEAPPLYMONEYTYPE attribute, rather than in the <MoneyType> element.
Used when	To apply money removed from a contract by the SplitPercentageRemoval assignment type.

XML Example

<Assignment TYPE=”SplitPercentageApply” SPLITPERCENTAGEREMOVALGUID="TransferAssetsOutActvitivyGUID"  SPLITPERCENTAGEAPPLYMONEYTYPE=”100” CURRENTALLOCATIONCOLLECTION=”FundList”>

</Assignment>