Loading
The online Trailblazer Community becomes read-only Oct 30, 2026Read More
Insurance
InsPolicyService:createMultiRootPolicy

InsPolicyService:createMultiRootPolicy

Use this service to issue a multi-root policy from a quote.

Class: InsPolicyService

Method: createMultiRootPolicy

How It Works

The service:

  1. Uses the quoteId and effectiveDate options to issue a multi-root policy.

  2. Generates child policies for each root product.

  3. Consolidates premiums, taxes, and fees from the child policies into the parent policy.

  4. Creates the necessary transactions if createTransaction is set to true.

  5. Consolidates these transactions into the parent multi-root policy.

Additional Fields

  • Users can override the policy field values by using the additionalFields option.

  • Additional fields are supported for both parent and child policies at the root-policy level.

  • The additionalFields option updates fields only at the Insurance Policy object level.

  • The child policy uses the product code as an identifier for the product in the additionalFields JSON structure.

  • The parent multi-root policy uses the MULTI_ROOT_PARENT_POLICY as an identifier in the additionalFields JSON structure.

Remote Options

Option

Description

quoteId

Required

The ID of the quote from which the policy is to be created.

effectiveDate

Required

The effective date of the policy.

endDate

Optional

The end date of the policy.

createTransaction

Optional

A Boolean flag to indicate if parent and child transactions must be created for the policy.

Default is False.

transactionType

Optional

Transaction name and type, applicable only when createTransaction is True.

Default is Sold Policy.

createContactForParticipants

Optional

A Boolean flag to determine if contact records must be created for the participant.

Default is True.

term

Optional

Term of the insurance policy.

Default is Annual.

ratingDate

Optional

The rating date that was used to price the input JSON.

additionalFields

Optional

A JSON structure that maps policy product codes to policy fields and their respective values.

refPolicyNumToPopulate

Optional

A Boolean flag to indicate if the reference policy number must be generated. This option is required when a reference policy number field is added to the additionalFields JSON structure.

Default is True.

Input JSON

This service doesn't take an input JSON.

Here’s a sample of the additionalFields JSON.

"additionalFields": {
      "MULTI_ROOT_PARENT_POLICY": {
        "name": "parent policy",
        "term": "Annual"
      },
      "AUTOROOT": {
        "name": "test",
        "year": "2024"
      },
      "COMMERCIAL": {
        "name": "Commercial",
        "type": "Comprehensive"
      }
    } 

Output

Option

Description

jobId

The ID of the asynchronous batch job.

Output JSON

Here's the sample output JSON:

{
 "jobId": "7073t0000BNGivxAQD"
}
 
Loading
Salesforce Help | Article