Straight-through processing (STP)

Straight-through processing (STP) allows agents to automate the submission and review process for applications that meet underwriting requirements and conditions. When engineers code rules, applications that meet requirements are automatically committed and their policy status is set to Active. Otherwise, the policy status is set to Submitted, pending underwriter review and approval.

In the policy wizard, STP is evaluated during the Get a Quote step. If STP fails, the reasons for failure are displayed. Then, the agent must select Request Review to submit the policy for underwriter review. See images of the Review Status section below. This section appears at the bottom of the Get a Quote page in the Agent Portal.

PR7900_reviewrejected.png

PR7900_reviewapproved.png

STP Rules

The rule_engine.py is where the actual processing takes place. There is no need to access this file other than for debugging.

  • rules/{client}/straight_through_processing: these directories contain rules defined in python, and the outcomes of the evaluation of those rules.
    Ex:

@dynamic_defaults
def rule_number_of_mortgagees(number=”{{bc::Property::Mortgagees::Number Of Mortgagees}}”):
return number < 3

    • This will return “true” as long as the value of “Number of Mortgagees” is less than 3. If it is 3 or more, this rule would return “false” and fail the mortgage application.

Rule:

  • Total TIV > $5,000,000 = FAIL
  • Max. Building Age > 50 = FAIL
  • Protection Class of 8, 9 or 10 = FAIL
  • Loss Amount >= $25,000 = FAIL

Set Up STP

  • Launch BriteCore
  • Sign in as Administrator
  • Navigate to Settings > Advanced
  • Replace URL {“url, “} within the Setting Value with URL from devops:

image2018-8-7_12-51-37.png

    • dev: arn:aws:lambda:us-east-1:446620020195:function:stp-development-dev
    • prod: arn:aws:lambda:us-east-1:313750358190:function:stp-production-prd
    • stg: arn:aws:lambda:us-east-1:313750358190:function:stp-staging-stgEx:

{“url”: “arn:aws:lambda:us-east-1:313750358190:function:stp-staging-stg”, “review_declined_email_subject”: “Policy {policy.policy_number} Declined”,”review_declined_email_message” : “The following policy, {policy.policy_number}, was reviewed by the Underwriter; however, it has been declined. You may view this quote in the BriteCore system for additional details. After review, should you have additional questions or concerns, please call our underwriting support team at 844-878-1267. Thank you.”}

The examples below are the new fields accepted to configure STP email sending:

      • review_requested_email_subject
      • review_requested_email_message
      • review_declined_email_subject
      • review_declined_email_message
      • review_approved_email_subject
      • review_approved_email_message

Note: To refer to attributes of the respective policy, use {policy.policy_number} notation. This example will pull the policy number dynamically when building the message.

STP Emails

When an application is processed using STP, the underwriter and agent can receive an email that notifies them if the application was successfully committed through STP or if the application needs underwriter review.

If the application is successfully committed through STP, the Declaration will be attached to the email. If the application needs underwriter review, the application will be attached to the email.

Underwriter Emails

There are two methods for adding the email addresses of underwriters who should receive STP notifications.

Method 1

  1. Navigate to Settings > System Wide > Administrative Alerts
  2. In the Policies section, add underwriter email addresses to the Emails to be notified upon Straight Through Processing results
  3. Select Save

Method 2 (IWS Only)

  1. Navigate to Settings > Advanced
  2. Search stpresult
  3. Add underwriter email addresses

Agent Emails

There are two methods for sending the STP notifications to the agent who submitted the application.

Method 1

  1. Navigate to Settings > System Wide > Administrative Alerts
  2. In the Policies section, check the Email Straight Through Processing result to Agent. checkbox
  3. Select Save

Method 2 (IWS Only)

  1. Navigate to Settings > Advanced
  2. Search stpemailagent
  3. Select True

Engineers can read PR 6474 and PR 6526 for more information.

Use Approved by Underwriter Review State

BriteCore will apply the Approved by Underwriter review state when a quote is approved by an underwriter during STP if the use-new-state-for-uw-approval advanced setting is enabled. To enable the use-new-state-for-uw-approval setting:

  1. Navigate to Settings > Advanced
  2. Search: use-new-state-for-uw-approval
  3. Select True

View Review Status

The show-review-state-column setting determines if the Review State column is visible in the new policy search screen. This setting does not affect the legacy policy search screen. To enable:

  1. Navigate to Settings > Advanced
  2. Search: show-review-state-column
  3. Select True or False

Filter Search by Review Status

The enable-review-state-filter setting allows users to filter results by review state in the new policy search screen. To enable:

  1. Navigate to Settings > Advanced
  2. Search: enable-review-state-filter
  3. Select True or False

Setting the filter above to True creates a new filter Review State on the Policy Search Page with the Options:

  • Approved by Underwriter
    • Note: This option will appear if the use-new-state-for-uw-approval advanced setting is enabled.
  • Pending Agent Changes
  • Pending Underwriter Review
  • Ready To Apply

filter by review status.png

image2018-8-7_13-0-18.png

image2018-8-7_13-1-14.png

Customize Review State Labels

The custom-labels-review-state-filter-options setting allows users to customize the labels that appear in the Review State column and are used to filter policies by Review State. The default values are {“PENDING_UNDERWRITER_REVIEW”: “”,”PENDING_AGENT_CHANGES”: “”,”READY_TO_APPLY”: “”} or {“PENDING_UNDERWRITER_REVIEW”: “”,”PENDING_AGENT_CHANGES”: “”,”READY_TO_APPLY”: “”, “APPROVED_BY_UW”: “”}.

To customize the Review State labels:

  1. Navigate to Settings > Advanced
  2. Search: custom-labels-review-state-filter-options
  3. Insert custom labels
    1. If the use-new-state-for-uw-approval advanced setting is enabled, use the following value input:
      {“PENDING_UNDERWRITER_REVIEW”: “Insert Custom Label Here“,”PENDING_AGENT_CHANGES”: “Insert Custom Label Here“,”READY_TO_APPLY”: “Insert Custom Label Here“, “APPROVED_BY_UW”: “Insert Custom Label Here“}

Note: If the use-new-state-for-uw-approval advanced setting is enabled, you must update the value input for the custom-labels-review-state-filter-options advanced setting. If you don’t update the value, the custom labels won’t function.

    1. If the use-new-state-for-uw-approval advanced setting is not enabled, use the following value input:
      {“PENDING_UNDERWRITER_REVIEW”: “Insert Custom Label Here“,”PENDING_AGENT_CHANGES”: “Insert Custom Label Here“,”READY_TO_APPLY”: “Insert Custom Label Here“}

Conditions

1. STP – Straight Through Without a Stop

Get a Quote: Show STP rules passed when approved by STP mechanism

image2018-8-7_13-15-44.png

2. STP – Review Required and Accepted

When an Agent submits a quote that fails one of the STP rules, the following message will display:

image2018-8-7_13-18-52.png

  1. Select the Request Review button and the following screen will show the application is Pending Underwriting Review:

image2018-8-7_14-20-33.png

  1. Select the Back to Quote Details button while in the Pending Review screen to return to the Upsell Matrix page. The following message will be displayed (toward the bottom of the screen):

image2018-8-7_14-11-42.png

  1. The Underwriter will be notified via Email that there is a New Application Review Required

image2018-8-7_14-26-9.png

  1. Opening the Quote offers two options to Accept or Decline the Quote. If the underwriter selects Decline Review, a popup will appear that allows the underwriter to write an additional message. This message will appear in the Notes tab and in the STP email.
    • Underwriter’s Quote View:

image2018-8-7_14-44-7.png

  1. When underwriting Approves the Quote the message changes to:

image2018-8-7_14-45-14.png

  1. Get a Quote. Select on Back to Quote Details. The message below will be displayed on the Upsel_Matrix page (toward the bottom):

image2018-8-7_15-12-3.png

  1. Select Continue to Bind to Bind the Application and make it Active (without further interaction with Underwriter)

image2018-8-7_15-18-0.png

 

3. STP – Review Required and Declined

If an Underwriter declines the Quote, notify the agent via an email similar to the following example:

image2018-8-7_15-20-50.png

When the Agent Opens the Quote they’ll receive the following message:

image2018-8-7_15-22-38.png

Policy Rejected When Review Declined

The review_should_trigger_policy_state setting causes the policy status to automatically update to Rejected when the underwriter declines the review. If the policy status is returned to Unsubmitted, this setting also resets the review status and requires the underwriter to review the policy again. To enable:

  1. Navigate to Settings > Advanced
  2. Search: review_should_trigger_policy_state
  3. Select True