GrossFullWithdrawalWithAllocations
The GrossFullWithdrawalWithAllocations assignment type, located in the transaction XML, is used to withdraw money from funds. Allocations on the activity at the time of assignment are used to reduce the contract value first. Any remaining amount that must be assigned is distributed among the remaining funds on the contract at a ratio of the fund value to the total remaining fund value %. This is similar to GrossFullWithdrawal.
Type= GrossFullWithdrawalWithAllocations | ||||
---|---|---|---|---|
Allocations needed? |
Yes |
|||
Element | Parent Element | Attributes | Definition | Element/Attribute Value and Description |
<Assignment> | Required: Opening and closing tag for an Assignment | |||
<Assignment> | TYPE |
Required: The GrossFullWithdrawalWithAllocations assignment defines a withdrawal using a set of allocation instructions. When a fund does not have sufficient cash value to meet the allocated amount, the excess is accumulated in an overflow. The overflow will later be taken from the remaining fund cash value on a pro rata basis using no allocation instructions. Values:GrossFullWithdrawalWithAllocations |
||
<Assignment> | IGNORENEGATIVECASHVALUES |
|
Optional: Values: Yes, No Yes: Funds with a negative cash value are dropped during the pro rata calculation and dropped from the fund removal. No: Allows funds with negative cash value to be included in the pro rata calculation. The absolute value of the funds is used in the pro rata formula. The default is No |
|
<MoneyType> | <Assignment> | Required, Repeatable: Identifies the money type code for the money change records. This money type code applies while the fund's or deposit's cash value is 0 or positive. | Values: money type code | |
<MoneyType> | NAME |
Required: The attribute provides the name of the math variable holding the amount of change for this money type code. Values: A math variable containing an amount |
||
<MoneyType> | BUCKET |
Optional: This attribute identifies the bucket from which to pull the money from funds where buckets are part of the fund hierarchy. The bucket is identified by the integer value provided by this attribute. Note: For funds where a bucket has not been established, the bucket value is ignored. Values: A math variable containing an integer |
||
<MoneyType> | EXCLUDEFUNDTYPES |
Optional: Comma-separated list of fund types. Allows funds to be excluded from the allocations that are moving money into a fund, based on the type of fund. Values: list of fund types |
||
<MoneyType> | MVACHARGE |
Optional: Indicates whether there is an MVA Charge. Values: Yes, No, literal, field, or a math variable |
||
<MoneyType> | MVAMONEYTYPE |
Optional: Provides the money type code for MVA charge values. Values: money type code |
||
<MoneyType> |
REDEMPTIONFEE |
|
Optional: Indicates whether there is a Redemption Fee. Values: Yes, No, literal, field, or a math variable |
|
<MoneyType> |
REDEMPTIONMONEYTYPE |
Optional: Provides the money type code for Redemption fees. Values: money type code |
||
<MoneyType> | FUNDOVERFLOWMONEYTYPE |
Optional: Specifies the money type code of the fund overflow. Values: money type code |
||
Element Value |
Assignment fields must be negative (removals). The allocation records should be positive and must match the total money-out in Percentage(100%). This is similar to PartialWithdrawal, but the charges are applied within the removal amount. |
|||
Note: Assignment fields must be negative (removals). Allocations on the activity at the time of assignment are used to reduce the contract value first. Any remaining amount that must be assigned is distributed among the remaining funds on the contract at a ratio of the fund value to the total remaining fund value percent. This is similar to GrossFullWithdrawal. |
||||
Used when |
Total Money-out |
|||
Examples |
FreeLook |
XML Schema
<Assignment TYPE="GrossFullWithdrawalWithAllocations" IGNORENEGATIVECASHVALUES="[Yes|No]"> <MoneyType NAME="[math variable]" BUCKET="[integer]" EXCLUDEFUNDTYPES="[fund types]" MVACHARGE="[Yes|No]" MVAMONEYTYPE="[money type code]" REDEMPTIONFEE="[Yes|No]" REDEMPTIONMONEYTYPE="[money type code]" FUNDOVERFLOWMONEYTYPE="[money type code]">[money type code]</MoneyType> <MoneyType>...</MoneyType> </Assignment>
XML Example
<Assignment TYPE="GrossFullWithdrawalWithAllocations"
MVACHARGE="Yes" MVAMONEYTYPE="3"FUNDOVERFLOWMONEYTYPE="16" >
<MoneyType NAME="GMDBChargeDueRemoved">95</MoneyType>
<MoneyType NAME="GMWBChargeDueRemoved">94</MoneyType>
</Assignment>