Withdrawal interface supports one time Withdrawal event on a contract. There are two methods of withdrawal allowed. Only Specified Dollar Amount method is supported.
Check
EFT
The effective date of the transaction will default to the current system date.
The below list of products are in scope for this operation.
Deferred Annuity
Immediate Annuity
Term Life Insurance
Universal Life
Whole Life Insurance
| TR ID# | Technical Requirements |
| TR1 | ACORDv2.36 shall be used to communicate. |
| TR2 | ACORD Tx 105 “ Withdrawal Transaction tc=105” should be used for executing Withdrawals. |
| TR3 | Interface must always return an error code and desc in the event of a processing failure in addition to HTTP response code. |
| TR4 | For a successful transaction a return code of 200 is returned. |
| BR ID# | Business Requirements |
| BR1 | Withdrawal is one time only transaction. There are 2 methods available Check and EFT. Only Dollar amount option is supported. |
| BR2 | Withdrawal amount should be greater than zero. |
| BR3 | The contract needs to be present in ALIP for the data to be returned. |
| BR4 | The Contract should be in the below status to support this transaction.ActiveAnnuitized |
The external system would fire the REST URL with the JSON message containing the transaction information to be created or retrieved on the request queue.
ALIP webadapters would pick up, process the message, convert it into XML format, and posts it onto the ALIP request queue.
ALIP process server will pick up the message, convert from ACORD to the canonical format, perform the necessary XSD validations, and other basic validations on the completeness of the transaction information, existence of the contract id in ALIP etc.
Post the necessary validations, it would invoke the necessary ALIP APIs/workflows to create or retrieve the necessary transaction information from the database.
The transaction information in case of a “GET” request, or the status information in case of a create, would be generated in XML format, converted to ACORD format, and sent back to the REST layer.
Here, it would be further converted back into the final JSON output format and returned back to the external system.
This interface provides the ability for one time Withdrawal, where funds are requested from a single subaccount or a combination of subaccounts.
For the funds where date tracking is enabled at product level, Fund Name is expected to be accompained with tracking date. Refer to Rest and soap request section for Sample Request .
Upon receiving the request, ALIP system checks if any pending requirements for the transaction needs to be generated based on the rules specified in Business Configuration.
If there are Pending requirements, they will have to be satisfied or waived before the next steps in the workflow are executed.
If there are no pending requirements or when the requirements have been satisfied or waived off the transaction is placed in the “Pending” status.
During the next nightly batch cycle next steps in workflow are executed to validate and perform the required actions on the contract.
If the validations are successful money will be be withdrawn from specified accounts and the net face value of the contract will be reduced by amount specified in the request. ALIP system will show a status of “Completed” for the transaction. The value of subaccounts will go down to reflect the amount withdrawn.
Based on the method of Disbursement the request is forwarded to appropriate workflow and a request is created to transfer the money.
If the validations fail the appropriate error messages will be displayed on ALIP system next to the transaction request. The status of transaction will reflect the same as in “Error”.
N/A
N/A
NA
| Success | Success Scenario Description | Message Code | Message Description | Message Type | Additional Comments |
| #1 | The Withdrawaltransactionforcontract call was successful with details being returned in the output | 1 | Success | Informational | TXLife/TXLifeResponse/TransResult/ResultCode/@tc =1 |
| Error | Error Scenario Description | Message Code | Message Description | Message Type | Additional Comments |
| #1 | The Withdrawaltransactionforcontract call was NOT successful due to a technical error or contract not found. | 5 | Internal Error | Informational | TXLife/TXLifeResponse/TransResult/ResultCode/@tc =5 |