Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

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.

1. Get Policy Context—Use the policy ID to get the policy context either by:
   • Making a GET request on the Insurance Policy Details Connect API, or
   • Using the Get Insurance Policy invocable action.
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:
   • Making a POST request on the Insurance Quote Connect API, or
   • Using the Create Insurance Quote invocable action.
   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:
   • Making a POST request on the Endorse Insurance Policy Connect API, or
   • Using the Endorse Insurance Policy invocable action.
   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.