/
Multiple Risks tab

Multiple Risks tab

1. Introduction

This tab determines whether the product version will support Multiple Risks and specifies how these risks will be outlined.

By default, a newly created product version is configured to handle only one insured object (Enable Handling Of Multiple Risks = No).

2. Set up multiple risks for a product

To enable Multiple Risks, you need to select the “Enable Handling Of Multiple Risks” to Yes, then choose the Type of Multiple Risks

  1. Multiple risks with upload file without a custom period: This feature lets you easily input a list of insured objects into a spreadsheet, with the ability to establish a fleet policy covering up to 200 objects, all sharing the same policy period. Once you upload the file into the system, it will automatically import and process the details of your insured objects to calculate the premium.

  2. Multiple risks with uploading files with a custom period: This feature lets you easily input a list of insured objects into a spreadsheet, allowing you to specify different periods for varying risks. Moreover, it provides the capability to set up a fleet policy with up to 200 objects. Once you upload the file into the system, it will automatically import and process the details of your insured objects to calculate the premium.

  3. Multiple risks with repeating section: This feature enables you to input a list of insured objects using repeating sections. Each new section, containing the same set of questions to capture individual object details, will be added manually for each insured object.

3. Multiple risks with uploading files without a custom period

To establish multiple risk setups with the uploaded file, kindly reach out to Contemi for the initial configuration. Currently, refrain from making any modifications to this setting if it already exists.

image-20240223-131536.png

When you select “Multiple risks with upload file”, these fields will be shown up

Field

Description

Field

Description

UploadReference

Select the UploadReference Tag question. This is the question to select the upload file defined under the Questions tab.

Custom Period For Insured Object

Default is unchecked. See https://seamlessinsure.atlassian.net/wiki/spaces/SHC/pages/8307444

PremiumReportingColumn

Name of Premium reporting column

ErrorReportingColumn

Name of Error reporting column

MinNumberOfRows:

Minimum object (row) of a policy

  • Default value = 1. This means at least 1 insured object must be specified.

ErrorMessageForTableRows

An error message to be displayed when a user does not specify any insured object or tries to add more than 6 insured objects.

ErrorMessageForTableStructure

An error message to be displayed when there is a missing object question (column) caused by incorrect upload file setup.

Upload File Template

Upload Upload File Template to be used. This template will be displayed on a quote for a user to download and fill in the list of insured objects.

a. Upload File Template

  1. Example file: <TBD>

  2. Upload File Template file must be in the xlsx format.

  3. In the "Fleet" sheet, in the 1st row, it is mandatory to define all the questions related to insured objects as columns.

    1. The title (i.e., display name) of each question should match those defined in the Questions tab.

    2. The system will scan the first sheet and extract values from columns identified as insured object questions.

    3. Any columns not designated as insured object questions will be disregarded by the system.

  4. Each row (starting from row 2) should contain the details of an insured object.

    1. You can put examples of insured object data in the following rows (from row 2).

  5. For an insured object’s cover selector or cover premium columns: you need to define questions to include/exclude cover and define cover premium, then put those questions in SharedObjectModel or InsuredObjectModel section. See https://seamlessinsure.atlassian.net/wiki/spaces/SHC/pages/8292285

  6. You can use the Excel formula to look up or do calculations as normal.

  7. You can add comments or notes to each column name to provide a description or guide on how to input value correctly.

  8. You can add other sheets, following the 1st sheet to capture other information to store data for lookup.

  9. If you want to change the Upload Template, you need to clone a new product version and attach the new Upload Template.

b. Using Upload File Template in a quote

  1. When doing quotes, at the Questions step, you download the latest template from the link provided.

  2. Open the file and fill in each insured object details on each row (from row 2).

  3. Save the file.

  4. Upload the file to the quote.

  5. Click next to proceed with the quote.

c. Download and view the Result File

After you attach the Upload file containing a list of insured object details at the Quote - Questions step, Seamless will process the file to get insured object details for premium calculation. Then in the Review step of a quote or policy details, you can see and download the Result file under the section INSURED.

The Result file will contain all data specified in Upload file, including some more column data added by system after processing. For ex:

  1. StartDate: effective start date of an object.

  2. EndDate: end date of an object.

  3. Identifier: the identifier is auto generated if identity questions are specified in product Json.

  4. Reference: usually the same as Identifier.

  5. TotalPrice: total object period premium.

  6. TotalTax: total object period tax amount.

  7. AnnualPrice: object annual premium.

  8. AnnualTax: object annual tax amount.

  9. System_Errors: if there is any validation raised for the data row, it will show a message here. You can know what data is wrong and then can fix the error.

4. Multiple risks with uploading files with a custom period

  1. Open Seamless > Insurance > Product Builders

  2. Choose a product that you want to set up > Choose a product version

  3. Open the Multiple Risks tab > choose the custom period for the product

    1. Choose the option Custom Period For Insured Object (1)

    2. Choose the question tags for the Insured Object’s Start date (mandatory) and the Insured Object’s End date (optional) (2)

  1. Choose the questions to map to the termination effective date and termination reason field (3)

    1. These questions will help Seamless identify when an insured object is terminated

  2. Define the name of the column that shows the policy premium (4)

  3. Define the name of the column that shows the error message (5)

    1. Define the minimum number of rows for a fleet policy

    2. Define the error message for the number of row and the input of the file

  1. Upload the sample template Excel file

  1. Click the Save button to save the change

5. Multiple risks with repeating section

To setup multiple risks with repeating section, please contact Contemi to do the initial setup. At the moment, please do not modify anything in this setting if it’s existing.

When you select “Multiple risks with repeating section”, these fields will be shown up:

  1. RepeatingObjectReference: question tag name to be used for the object identifier/reference. It’s usually the Insured object name.

  2. MinNumberOfRows: default value = 1. This means at least 1 insured object must be specified.

  3. MaxNumberOfRows: the maximum number of objects that user can add to the quote.

  4. ErrorMessageForTableRows: error message to be displayed when user does not specify any insured object or tries to add more than 6 insured objects.

  5. ErrorMessageForTableStructure: error message to be displayed when there is a missing object question caused by incorrect product JSON setup.

6. Understand product JSON (Advanced users)

For multiple-risks product setup, there are three important JSON code blocks that you need to configure:

  1. SharedObjectModel: define the Questions, IdentifyQuestions, PurchaseConstraints, CustomValidations that will be for policy level information.

  2. InsuredObjectModel: define the Questions, IdentifyQuestions, PurchaseConstraints, CustomValidations that will be for insured object level information.

  3. InsuredObjectModelStrategy: define the insured object model strategy. Use this InsuredObjectModel.CompositeInsuredObjectModelStrategy for multiple-risks product.

Example 1: JSON code block for Multiple Risks with Upload file

"InsuredObjectModel": { "Questions": [ { "$id": "VehicleRegistrationNumberTag", "$type": "InsuredObjectModel.TextQuestionDefinition", "TagName": "VehicleRegistrationNumberTag", "DisplayName": "Registration Number", "MaxLength": 30, "IsRequired": true }, { "$id": "MakeTag", "$type": "InsuredObjectModel.TextQuestionDefinition", "TagName": "MakeTag", "DisplayName": "Make", "IsRequired": true }, { "$id": "ModelTag", "$type": "InsuredObjectModel.TextQuestionDefinition", "TagName": "ModelTag", "DisplayName": "Model", "IsRequired": true }, { "$id": "TPLSelectorTag", "$type": "InsuredObjectModel.TextQuestionDefinition", "TagName": "TPLSelectorTag", "DisplayName": "Third party liability" }, { "$id": "TPLPremiumTag", "$type": "InsuredObjectModel.DecimalQuestionDefinition", "TagName": "TPLPremiumTag", "DisplayName": "TPLPremium" } ], "IdentityQuestions": [ { "$ref": "MakeTag" }, { "$ref": "VehicleRegistrationNumberTag" } ], "PurchaseConstraints": [], "CustomValidations": [] }, "SharedObjectModel": { "Questions": [ { "$id": "PolicyholderNameTag", "$type": "InsuredObjectModel.TextQuestionDefinition", "TagName": "PolicyholderNameTag", "IsRequired": true }, { "$id": "UploadReferenceTag", "$type": "InsuredObjectModel.UploadFileQuestionDefinition", "TagName": "UploadReferenceTag", "MaxSize": 100, "AllowedExtensions": [ ".xlsx" ], "IsRequired": true, "IsRequiredForPriceCalculation": true } ], "IdentityQuestions": [ { "$ref": "PolicyholderNameTag" } ], "PurchaseConstraints": [], "CustomValidations": [] }, "InsuredObjectModelStrategy": { "$type": "InsuredObjectModel.CompositeInsuredObjectModelStrategy", "UploadReference": { "$ref": "UploadReferenceTag" }, "PremiumReportingColumn": "Premium", "ErrorReportingColumn": "Errors", "MinNumberOfRows": 2, "ErrorMessageForTableRows": "Number of insured objects should be 2 at least.", "ErrorMessageForTableStructure": "Missing '{0}' Column for {1}", "EnableCustomPeriod": true, "ProrataType": { "$type": "ProrataType.Annual365DistributionStrategy" }

Example 2: JSON code block for Multiple Risks with Repeating section

"InsuredObjectModel": { "Questions": [ { "$id": "CommodityTypeTag", "$type": "InsuredObjectModel.LookupChoiceQuestionDefinition", "TagName": "CommodityTypeTag", "SourceLookup": { "$ref": "CommodityType" }, "IsRequired": true }, { "$id": "SumInsuredTag", "$type": "InsuredObjectModel.DecimalQuestionDefinition", "TagName": "SumInsuredTag", "IsRequired": true }, { "$id": "PremiumTag", "$type": "InsuredObjectModel.DecimalQuestionDefinition", "TagName": "PremiumTag", "IsRequired": true } ], "IdentityQuestions": [ { "$ref": "CommodityTypeTag" } ], "PurchaseConstraints": [], "CustomValidations": [] }, "SharedObjectModel": { "Questions": [ { "$id": "TypeOfTransitTag", "$type": "InsuredObjectModel.LookupChoiceQuestionDefinition", "TagName": "TypeOfTransitTag", "IsRequired": true, "SourceLookup": { "$ref": "TypeOfTransit" } }, { "$id": "VoyageExpectedDateTag", "$type": "InsuredObjectModel.DateQuestionDefinition", "TagName": "VoyageExpectedDateTag", "IsRequired": true }, { "$id": "InsuredInfoTag", "$type": "InsuredObjectModel.RepeatingQuestionDefinition", "TagName": "InsuredInfoTag", "IsRequired": true } ], "IdentityQuestions": [ { "$ref": "TypeOfTransitTag" } ], "PurchaseConstraints": [], "CustomValidations": [] }, "InsuredObjectModelStrategy": { "$type": "InsuredObjectModel.CompositeInsuredObjectModelStrategy", "RepeatingObjectReference": { "$ref": "InsuredInfoTag" }, "MinNumberOfRows": 1, "MaxNumberOfRows": 6, "ErrorMessageForTableRows": "At least one insured objects, up to a maximum of 6", "ErrorMessageForTableStructure": "Error in Product Setup" }

Related content

If you would like to request an article, drop us a mail at seamless.support@seamless.insure

Seamless Help Center