Insurance Developer Guide

Get Started with Insurance Developer Resources
Insurance Brokerage
Insurance Claims Management
Insurance Group Benefits
Insurance Policy Administration
Insurance Policy Business APIs
Insurance Policy Standard Invocable Actions
Insurance Policy Administration Metadata API Types
Insurance Policy Standard Objects
Insurance Policy Administration Apex Reference
Insurance Policy Developer Journey
Create and Manage Insurance Policies by Using Salesforce Quoting
Create and Manage Insurance Policies Without Using Salesforce Quoting
Endorse Policy
Issue Policy
Renew Policy
Create Out of Sequence Policy Endorsement
Issue Multi-Root Policy
Endorse Multi-Root Policy
Renew Multi-Root Policy
Cancel Policy
Insurance Product Administration
Insurance Quoting
Insurance Apex Reference
Error Codes and Responses
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Renew Multi-Root Policy

Creates a new policy term for a multi-root policy when pricing is handled through the Rating API instead of a quote. This process bypasses the creation of a quote record while generating new parent and child policy records for the renewed term.

Make sure you have these details before renewing a multi-root policy:

  • The Policy ID of the active parent insurance policy to be renewed.
  1. Get Policy Context—Retrieve the policy context by using the policy ID through one of the following methods:
    Returns the context required to price and renew the policy.
  2. Generate Price-Adjusted Context—Generate a priced context for the new term by making a PATCH request to the Insurance Product Rating Connect API using the context ID.
    Returns a price-adjusted context that contains the premium calculation for the renewed term.
  3. (Optional) Run Qualification Rules—Determine eligibility for renewal by making a POST request to the CreateUpdateQuote Connect API with saveQuote=false.
    Returns an updated context containing eligibility results without saving a Quote record.
  4. Renew Multi-Root Policy—Use the updated context to renew the policy by using one of the following methods:
  • Returns an Async Request ID in the response to track the job status.
  • Creates new parent and child policy records asynchronously for the new term.
  • Creates a corresponding transaction record for each child policy. In addition, creates a parent policy transaction that represents the rolled-up premium from all associated child policy transactions.
  • Creates transaction records associated with the renewed policy term.