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 business rules are established in the system, the applications that meet these requirements are automatically committed and their policy status is set to Active. Applications that don’t meet these requirements are set to Submitted, pending underwriter review and approval.

If applications don’t meet the business requirements and STP fails, then the reasons for failure are displayed. In the quote wizard, the agent must select Request Review to submit the application for underwriter review.

Straight-through processing rules

Processing the rules associated with STP takes place in the rule_engine.py. To access the rule engine, go to rules/{client}/straight_through_processing. These directories contain rules defined in Python and the outcomes of the evaluation of those rules. For example, the rule below will return True as long as the value of Number of Mortgagees is less than 3. If the value is 3 or more, then the rule will return False and the application will fail.

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

Set up straight-through processing

To set up STP:

  1. In the Provider Administrator portal, navigate to Settings > Advanced.
  2. In the Search for a Setting box, type straight-through-processing. Press Enter/Return on your keyboard or select Search.
  3. In the Setting Value box, replace the URL with the URL from devops:
    • 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-stg

Straight-through processing 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.

Configure emails

After you replace the URL for straight-through-processing, you can add text to the Setting Value box to configure STP emails for the following scenarios:

  • Review Requested
  • Review Declined
  • Review Approved

You can use the following fields within the Setting Value box to configure STP emails:

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

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.

If you want to configure the STP email for Review Declined, then you would type review_declined_email_subject, the subject line, review_declined_email_message, the body of the email, and {policy.policy_number} in the Setting Value box directly after the URL. See the example below:

“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 <Phone Number>. Thank you.”}

Underwriter emails

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

Method 1

  1. In the Provider Administrator portal, navigate to Settings > System Wide > Administrative Alerts > Policies.
  2. Navigate to the Emails to be notified upon Straight Through Processing results box and type the email address(es) of the recipients.
  3. Select Save.

Method 2

  1. In the Provider Administrator portal, navigate to Settings > Advanced.
  2. In the Search for a Setting box, type stpresult. Press Enter/Return on your keyboard or select Search.
  3. In the the stpresult box, in the Setting Value box, type the email address(es) of the recipients.

Agent emails

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

Method 1

  1. In the Provider Administrator portal, navigate to Settings > System Wide > Administrative Alerts > Policies.
  2. Select the Email Straight Through Processing result to Agent checkbox.
  3. Select Save.

Method 2

  1. In the Provider Administrator portal, navigate to Settings > Advanced.
  2. In the Search for a Setting box, type stpemailagent. Press Enter/Return on your keyboard or select Search.
  3. In the stpemailagent box, select True.

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. In the Provider Administrator portal, navigate to Settings > Advanced.
  2. In the Search for a Setting box, type use-new-state-for-uw-approval. Press Enter/Return on your keyboard or select Search.
  3. Select True.

View Review Status

The show-review-state-column advanced setting determines if the Review State column is visible on the Policy Search screen.

Note: This setting doesn’t affect the legacy Policy Search screen.

To enable this setting:

  1. In the Provider Administrator portal, navigate to Settings > Advanced.
  2. In the Search for a Setting box, type show-review-state-column. Press Enter/Return on your keyboard or select Search.
  3. In the show-review-state-column box, select True.

Filter search by Review Status

The enable-review-state-filter advanced setting allows users to filter results by review state in the new Policy Search screen.

To enable:

  1. In the Provider Administrator portal, navigate to Settings > Advanced.
  2. In the Search for a Setting box, type enable-review-state-filter. Press Enter/Return on your keyboard or select Search.
  3. In the enable-review-state-filter box, select True.

Setting the filter above to True creates a new filter, Review State, on the Policy Search screen 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

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. In the Provider Administrator portal, navigate to Settings > Advanced.
  2. In the Search for a Setting box, type custom-labels-review-state-filter-options. Press Enter/Return on your keyboard or select Search.
  3. In the Setting Value box, type the custom labels you want to add.
    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 isn’t 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 – quote approved without review

When a quote passes STP rules and is automatically approved, the following message will appear on the screen beneath Underwriting Review:

This quote passes all the rules for quick processing.

You can select Continue to Bind to continue processing the policy, or you can select Discard Quote.

2. STP – review required and accepted

When an agent submits a quote that fails one or more STP rules, it will require underwriter review.

  1. Select the Request Review button and the following screen will show the application is pending underwriter review. Beneath Underwriting Review, the following message will display:

    This quote has been sent to underwriting review for the following reasons:

    <List of reasons the quote is sent to underwriting review>

  2. The underwriter will be notified via email that there is a new application review required.
  3. When the underwriter opens the quote the system provides two options: Accept Review or Decline Review.
  4. If the underwriter selects Accept Review, the quote is approved. In the quote wizard, the following message will appear:

    Quote Approved!

    Congratulations! Underwriting reviewed your quote and approved it for binding.

  5. Select Continue to Bind to bind the application and make it Active.

3. STP – review required and declined

When an agent submits a quote that fails one or more STP rules, it will require underwriter review.

  1. Select the Request Review button and the following screen will show the application is pending underwriter review. Beneath Underwriting Review, the following message will display:

    This quote has been sent to underwriting review for the following reasons:

    <List of reasons the quote is sent to underwriting review>

  2. The underwriter will be notified via email that there is a new application review required.
  3. When the underwriter opens the quote, the system provides two options: Accept Review or Decline Review.
  4. If the underwriter selects Decline Review, a pop-up will appear. In the pop-up the underwriter can write a message regarding the decision to decline the review. The message will appear on the Notes screen and in the STP email.
  5. When an underwriter declines the quote, an email will be sent notifying the agent that the quote was declined. In the quote wizard, the following message will appear:

    Quote Rejected

    We’re sorry, underwriting reviewed your quote and rejected it for binding.

Policy rejected when review declined

The review_should_trigger_policy_state advanced 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. In the Provider Administrator portal, navigate to Settings > Advanced.
  2. In the Search for a Setting box, type review_should_trigger_policy_state. Press Enter/Return on your keyboard or select Search.
  3. In the review_should_trigger_policy_state box, select True.