Renew a policy
In an agent portal, agents can renew an existing policy.
Based on product configuration, agents can directly renew a policy with a Renewal transaction. Or, they can renew a policy with a Renewal Start and Renewal Activate transaction.
- Identify the policy transaction code.
- Submit and process the renewal.
Identify the policy transaction code
Initiating a renewal starts with an agent deciding to create a Renewal transaction on a policy. Then, agent portal calls an API to determine the types of transactions that are valid for a policy.
Once an agent selects a Renewal transaction, the agent portal must note the code value of the transaction as it is required to request the transaction in a later step.
- View the policy details:
- The portal submits the following API
call:
GET /policies/systemid
- The portal displays the policy details provided in the response.
- The portal submits the following API
call:
- View the list of available transactions:
- The portal submits the following API call:
GET /policies/systemid/availableTransactions
- The portal provides the user a list of available transactions based on the API response.
- The agent selects the Renewal transaction.
- From the API response, the portal notes the value of the
Renewal
option.
... "value": "Non-Renewal", "name": "Non-Renewal" }, { "value": "Renewal", "name": "Renewal" }, { "value": "Rewrite-New", "name": "Rewrite-New" }, ...
- The portal submits the following API call:
Submit and process the renewal
Submitting and processing the renewal starts with the agent portal calling an API to initiate the renewal. Then, the system creates an application and the agent processes the application.
- Start the Renewal transaction request:
- The portal gathers renewal details from the agent.
- The portal executes the following API call:
Endpoint POST /policies/systemId/startTransactionRequest
Example Request Body { "effectiveDate": "YYYY-MM-DD", "transactionCd": "Renewal", "description": "Renewing for another year" }
Note: The values will differ based on agent input. - From the API response header, note the systemID of the
application in the location
field:
... location: https://hostname/coreapi/v5/applications/systemID ...
- View the new application
- The portal executes the following API
call:
GET /applications/systemid
- The portal displays the application details provided in the API response.
- The agent completes the application.
- The portal executes the following API
call: