Add Update Arrangements API EFT

Request/Response & Json Schema

Overview

This interface in Accenture Life Insurance Platform (ALIP) provides the ability to an Agent or an customer to add/update a customer’s recurring deposits Arrangement information.

The following options are presented for data of the transaction:Frequency of the Payment (once, monthly, quarterly, semiannual, annual), Method of Payment (Dollar or Percentage), Amount (Total Amount as well as the Amount to be invested in individual funds) and the Payment Method (EFT, Cards or Digital).

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

Technical Requirements

TR ID# Technical Requirements
TR1 ACORDv2.36 shall be used to communicate.
TR2 ACORD Tx 107 “Holding Transaction tc=107” will be used for scheduling the ETF Draw event to support the business use cases
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 success the response will be sent for confirming the process.
TR5 A response time of 3 seconds or less is expected.
TR6 Q-switch needs to be run while processing any event
TR7 Any changes made by this interface will be associated with the Service User ID (provided in the service request)

Business Requirements

BR ID# Business Requirements
BR1 Client requires the ability to invoke a service within ALIP to add or update an ETF Draw Event
BR2 Future and expired events will not be available in the response even if it is processed. Only the current events as of current system date will be returned in response
BR3 Service should return a success or failure message depending on the outcome of processing.

Process Flow

• The external system would fire the REST URL with the JSON message containing the arrangements information to be retrieved/updated/deleted 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 arrangement information, existence of the contract id in ALIP etc.

• Post the necessary validations, it would invoke the necessary ALIP APIs/workflows to create/update/delete or retrieve the necessary arrangements information from the database.

• The arrangement information in case of a “GET” request, or the status information incase of a create/update/delete (POST/DELETE), 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.

Withholding information is available for Owner and Primary roles as part of response based on enabling configurable property in ALIP.

Impact on ALIP system (applicable for add/update operations)

• The transaction generated from this arrangement, is for recurring deposits.

• 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 deposited into specified accounts and the net face value of the contract will be updated by amount specified in the request. ALIP system will show a status of “Completed” for the transaction. The value of subaccounts will go up to reflect the amount deposited.

• Based on the method of Payment (EFT, Cards or Digital) the request is forwarded to appropriate workflow and a request is created to deposit 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”.

Assumptions

None

Dependencies

It is assumed that the incoming message from the calling system, will contain the required the RequestType, TransType, TransSubType within the request header provided by the external system to ALIP.

Request Data Elements

Response Data Elements

NA

Error Handling

Error Error Scenario Description Message Code Message Description Message Type Additional Comments
#1 The ETF Draw Event Add/Update call was successful with details being returned in the output 1 Success Informational TXLife/TXLifeResponse/TransResult/ResultCode/@tc =1
#2 The ETF Draw Event Add/Update interface could not find any matching contract id record in ALIP. 5 Internal Error Informational TXLife/TXLifeResponse/TransResult/ResultCode/@tc =5