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

Endorse Policy

Policy endorsement, also known as a Mid-Term Adjustment (MTA), is a process where you change an active insurance policy. The endorsement process changes the policy version and the premiums. This user journey shows you how to endorse a policy when Salesforce's quoting capabilities aren't used.
Make sure you have these details.
  • Policy ID of the active insurance policy to be endorsed.
  • Details of the modifications to be made, such as changes to coverages, limits, and deductibles.

This diagram outlines the sequence of endorsing a policy, where any changes are initially processed through the Rating API to generate a price-adjusted context. The context contains the calculated premium and other relevant details that are required to endorse the policy. This process bypasses the need for a formal Salesforce Quote record for pricing.

A flow diagram representing the user journey for endorsing a policy by using the Rating API.
  1. Get Policy Context—Use the policy ID to get the policy context either by:
  2. Generate Price-adjusted Context—Use the context ID and make a PATCH request on the Insurance Product Ratings Connect API.
    The price-adjusted context record contains the premium impact of the proposed modifications.
  3. (Optional)Run Qualification Rules—If customers want to determine the policyholder’s eligibility for a product, run the qualification rules either by:
    Set the saveQuote parameter to false. It doesn't save the quote and returns an updated context with the eligibility details.
  4. Endorse Policy—Use the retrieved context to endorse a policy either by:
    You can change the context fields, such as the policy name or policy number, directly during the API call. You can also provide a name for the transaction record that's created along with the endorsement. This transaction record captures the financial details or the audit information related to the MTA.
    A new endorsed policy version is created.
Expected Results:
  • A new policy version record is created in Salesforce, which includes the endorsed changes.
  • A new policy version is created with an updated effective-from date. The effective-to date of the existing policy version is adjusted to an end date just before the new version begins, ensuring continuous but non-overlapping coverage.
  • The new policy version has the updated premium information, including the new standard premium and the prorated term premium, accurately calculated and stored.
  • A transaction record is created and linked to the endorsement activity.