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

Issue Policy

Issue a new insurance policy when quoting is managed outside Salesforce, by a third-party system. This process results in the creation of a policy record in Salesforce, formally establishing coverage for the customer.
Use the Rating API to generate a price-adjusted context. This price-adjusted context contains the calculated premium and other relevant details that are required to issue a policy. This process bypasses the need for a formal Salesforce Quote record for pricing.

This diagram outlines the sequence of issuing a policy without using Salesforce quote, rather by using the Rating API to generate a price-adjusted context that's used to issue a policy.

A flow diagram representing the user journey for issuing a policy by using the Rating API.
  1. (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.
  2. Generate Price-adjusted Context—Make a POST request on the Insurance Product Ratings Connect API.

    You must include additionalFields in the request payload with either a QuoteAccount or an Opportunity ID that's linked to an account to generate the context.

  3. Issue Policy—Use the price-adjusted context record to issue a policy either by:
    You can override the context data, such as policy name, policy number, effective-from date, effective-to date, and any other additional fields to provide the values for the custom fields during the API call. You can also specify a name for the transaction record that’s created as part of the policy issuance process. This transaction record is used to track an audit or as a financial marker.
    This request creates a new policy record.
Expected Results:
  • A new policy record is created and saved in Salesforce. The policy record includes the details, such as the policy name, number (if provided or created during the API call), policy start date, the coverage you chose, and the price.
  • Any custom field values that are provided during the API call are saved to the new policy record.
  • A transaction record is created and linked to the policy.