Skip to main content

Blocking Reasons

Amanda de Bruyn avatar
Written by Amanda de Bruyn
Updated over a month ago

A Blocking Reason indicates "the reason for a product being blocked from linking."

Where to find Blocking Reasons:

  1. Via the Statements tab:

    1. Go to the Statements tab

    2. Add filter

    3. Choose "Item - Blocking Reason"

    4. Choose the blocking reason you would like to look at

    5. Edit any statement

    6. Click on statement items

    7. The Blocking Reason description can be found to the right of each unlinked product:

      (If you do not see Blocking Reason as a column, select the option under the Manage Columns)

  2. Via an unlinked report:

    To generate a complete list of products with their respective Blocking Reasons:

    1. Go to Reports

    2. Select Unlinked Items

    3. Select the Date Range

    4. Configure the report as needed, including the field "Blocking Reason"

    5. Click on Download


Summary

Standard blocking reasons:

Reason

Meaning

Product not found

The provider & product number does not exist on Commspace.

Product agreement not found

The provider & product number exist on Commspace, but has no product agreement.

Agreement Version not found

The product is linked to an agreement that has no active version on or before the statement date.

Product agreement for statement date not found

The product is linked to a product agreement that has a valid from date later than the statement date.

Product for provider not found

The product number exists, but the provider linked to the product number does not match the provider used for the statement.

Responsible Partner Match blocking reasons:

Partner code or name not found

  1. The system requires a valid partner provider code on the statement to link, but the Statement Partner Provider Code has not been loaded as a partner code under settings.

  2. The system requires a valid partner provider code on the statement to link, but the Statement Partner Provider Code does not match a partner code that has been loaded under the Responsible Partner currently stipulated in the product agreement.

Partner code and name on statement is blank

The system requires a valid partner provider code on the statement to link, but none was found and the partner provider code is therefore blank.

Blocking Reason descriptions, their meaning, and how to resolve each:

  1. Product not found

    1. What does this mean

      The provider & product number does not exist on Commspace.

    2. How to resolve

      i. Follow the normal linking process.

      ii. In the case of Elite Wealth integration, the product must be troubleshooted on Elite Wealth to check why it has not pulled through to Commspace.

  2. Product agreement not found

    1. What does this mean

      The provider & product number exist on Commspace, but has no product agreement.

    2. How to resolve

      Add product agreement

  3. Agreement Version not found

    1. What does this mean

      The product is linked to an agreement that has no active version on or before the statement date.

    2. How to resolve

      Add a version to the applicable agreement with a valid from date on or before the statement date.

  4. Product agreement for statement date not found

    1. What does this mean

      The product is linked to a product agreement that has a valid from date later than the statement date.

    2. How to resolve

      Change the valid from date of the current product agreement or add a new product agreement with a valid from date on or before the statement date.

  5. Product for provider not found

    1. What does this mean

      The product number exists, but the provider linked to the product number does not match the provider used for the statement.

    2. How to resolve

      1. Check if the statement was imported under the correct provider. If correct, implement step 2 below.

      2. Search the product number under the Product tab, and change the provider to the statement provider.


    The following Blocking reasons are only applicable if the Responsible Partner Match feature is enabled:

    1. Partner code or name not found

    1. What does this mean

      The provider & product number exist on Commspace, with a valid product agreement. The responsible partner code match tick is enabled on the product agreement. The system thus requires a valid partner provider code on the statement to link, but the Statement Partner Provider Code has not been loaded as a partner code under settings.
      ​OR

      The provider & product number may already exist on Commspace, with a valid product agreement. The responsible partner code match tick is enabled on the product agreement. The system thus requires a valid partner provider code on the statement to link, but the Statement Partner Provider Code does not match a partner code that has been loaded under the Responsible Partner currently stipulated in the product agreement.

    2. How to resolve:

      Load the Statement Partner Provider Code as a partner code under the applicable responsible partner. Once done, relink the product. The product should now link, or reflect another blocking reason.

      OR
      Follow normal linking process. Make sure to enable the responsible partner code match tick for the new product agreement.

    2. Partner code and name on statement is blank

    1. What does this mean

      The provider & product number exists on Commspace, with a valid product agreement. The responsible partner code match tick is enabled on the product agreement. The system thus requires a valid partner provider code on the statement to link, but none was found and the partner provider code is therefore BLANK.

    2. How to resolve

      1. Check statement for available fields. If Statement Partner Name / Statement Partner Provider Code is available, request support to map. If only Statement Partner Name is available, Statement Partner Provider Code must be read.

      2. If the entire statement only has ONE applicable Statement Partner Provider Code, reimport the statement and use bulk set actions on statement import.

      3. If the statement has multiple Statement Partner Provider Codes, use the bulk set action under statement items, selecting applicable product numbers and setting applicable Statement Partner Provider Code.

Did this answer your question?