Rebalance

Request/Response & Json Schema

Overview

The Rebalance transaction interface supports Rebalance event on a contract. Both Dollar Amount and Percentage options are supported.

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

Technical Requirements

TR ID# Technical Requirements
TR1 ACORDv2.36 shall be used to communicate.
TR2 ACORD Tx 509 “ Loan Processing tc=509” should be used for executing Loan Requests.
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.

Business Requirements

BR ID# Business Requirements
BR1 Rebalance is a one time only transaction..
BR2 Dollar Amount and Percentage both are supported.
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

Process Flow

Same as section 3.1.4

Impact on ALIP system

This transaction is for one time Rebalance, where the transfer of funds is requested between the specified subaccounts.

Upon receiving 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,the 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 transferred between specified accounts. The face value of the contract is not impacted by this transaction ALIP system will show transactions in Processed section.

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

Assumptions

API will not do any validation against the funds which are allocated for a particular product. If the request is run with invalid fund or fund which is not bound to a particular product. Then, API will not observe any failure, but it will fail to process the transaction from UI.

If UI is supporting current/past/future transaction effective date, then API will also support the same.

Dependencies

N/A

Request Data Elements

Response Data Elements

Success/ Error Handling

Success Success Scenario Description Message Code Message Description Message Type Additional Comments
#1 The Rebalancetransactioncall 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 Rebalance transaction call was NOT successful due to a technical error or contract not found. 5 Error Informational TXLife/TXLifeResponse/TransResult/ResultCode/@tc =5TXLife/TXLifeResponse/TransResult/ResultInfo/ ResultInfoCode/@tc =100 General Error
#2 The Rebalance transaction call was NOT successful due to validation errors (Request not conforming to the XSD). 5 Error Informational TXLife/TXLifeResponse/TransResult/ResultCode/@tc =5TXLife/TXLifeResponse/TransResult/ResultInfo/ ResultInfoCode/@tc =100 TXLife/TXLifeResponse/TransResult/ResultInfo/ ResultInfoDescValidation Error Occurred
#3 The Rebalance transaction call was NOT successful due to invalid TransType code provided in Request. 5 Error Informational TXLife/TXLifeResponse/TransResult/ResultCode/@tc =5TXLife/TXLifeResponse/TransResult/ResultInfo/ ResultInfoCode/@tc =100 General Error
#4 The Rebalance transaction call was NOT successful due to invalid total percent provided in request (sum not equal to 100). 5 Error Informational TXLife/TXLifeResponse/TransResult/ResultCode/@tc =5TXLife/TXLifeResponse/TransResult/ResultInfo/ ResultInfoCode/@tc =004General Error
#5 The Rebalance transaction call was NOT successful due to Transaction Effective date less than last processed transaction date 5 Error Informational TXLife/TXLifeResponse/TransResult/ResultCode/@tc =5TXLife/TXLifeResponse/TransResult/ResultInfo/ ResultInfoCode/@tc =100General ErrorTXLife/TXLifeResponse/TransResult/ResultInfo/ ResultInfoDescProcess failed :No matching trans summary data record found