Last updated

Special Event Rules

This page provides guidance on setting up a collection of rules that can be applied to monitoring. Each rule includes specific parameters that allow you to customise notifications based on changes in credit scores, credit limits, company statuses, and other key metrics.

NOTE: This is not a complete list of the available rules, please see the two following endpoints:

  • All Event Rules
  • Filtered Event Rules (By Country Code)

Rules Requiring Extra Parameters

The following rules require additional parameters (Param 0, Param 1, Param 2) to configure notifications:


Global Rules

These rules apply globally and are not specific to any country.

Rule 101 - International Score Banding Change (A-E)

  • Param 0: Enter a number (1, 2, 3, 4, or "") indicating how many bands the change must reduce by to receive a notification.
  • Param 1: Enter a string value (A, B, C, D, or Any) to specify the band under which any changes should be notified. Use "Any" to receive notifications for any band changes.

Example Settings:
To receive notifications for any changes within any band:

  • Param 0: Enter "".
  • Param 1: Enter Any.

Rule 102 - Credit Limit Value Change

  • Param 0: Set this parameter to "true" or "false" to override other parameters and receive notifications for any credit limit changes.
  • Param 1: Enter a numeric value indicating the percentage by which a credit limit must reduce to trigger a notification.
  • Param 2: Enter a numeric value to set the threshold for the credit limit. Notifications will be triggered when the credit limit falls below this value.

Country-Specific Rules

These rules are specific to certain countries, as indicated by their abbreviations (e.g., US, DE, FI, NL).


Belgium (BE)

Rule 1703 - BE - Credit Score

  • Param 0: Enter a percentage value indicating the drop in credit score that will trigger a notification.
    For example, if the score decreases by 20%, you will receive a notification.

Germany (DE)

Rule 2000 - DE - Credit Limit

  • Param 0: Enter a percentage value indicating the change in the credit limit of a DE-registered company that will trigger a notification.
    For example, if the credit limit increases or decreases by 20%, you will be notified.

Rule 2001 - DE - International Credit Score

  • Param 0: Enter a percentage value indicating the change in the credit score of a DE-registered company that will trigger a notification.
    For example, if the credit score increases or decreases by 20%, you will be notified.

Rule 2009 - DE - Non-Reg Credit Limit

  • Param 0: Enter a percentage value indicating the change in the credit limit of a DE non-registered company that will trigger a notification.
    For example, if the credit limit increases or decreases by 20%, you will be notified.

Rule 2010 - DE - Non-Reg Credit Score

  • Param 0: Enter a percentage value indicating the change in the credit score of a DE non-registered company that will trigger a notification.
    For example, if the credit score increases or decreases by 20%, you will be notified.

Finland (FI)

Rule 801 - FI Local Rating Score Change

  • Param 0: Enter a numeric value indicating the amount by which the rating score must increase or decrease to trigger a notification.
    For example, if Param 0 = 20, you will be notified if the rating score increases by at least 20 or decreases by 20 or more.

Netherlands (NL)

Rule 1503 - NL - Credit Score

  • Param 0: Enter a percentage value indicating the drop in credit score that will trigger a notification.
    For example, if the score decreases by 20%, you will receive a notification.

Norway (NO)

Rule 901 - NO Local Rating Score Change

  • Param 0: Enter a numeric value indicating the amount by which the rating score must increase or decrease to trigger a notification.
    For example, if Param 0 = 20, you will be notified if the rating score increases by at least 20 or decreases by 20 or more.

Spain (ES)

Rule 2201 - ES - New Accounts Field

This rule monitors event changes and does not require additional parameters.

  • Set the "isActive" parameter to 1 to enable notifications for these events.

Rule 2202 - ES - Company Status

This rule monitors event changes and does not require additional parameters.

  • Set the "isActive" parameter to 1 to enable notifications for these events.

Rule 2203 - ES - Judicial Event

This rule monitors event changes and does not require additional parameters.

  • Set the "isActive" parameter to 1 to enable notifications for these events.

United States (US)

Rule 1601 - US - Rating Change (Increases or Decreases)

  • Param 0: Enter a percentage value indicating the minimum percentage by which a rating must change to trigger a notification.
  • Param 1: Enter a value indicating the minimum increase or decrease in the rating score to trigger a notification.
    For example, if the rating increases or decreases by 10% or the value change is greater than 20, you will receive a notification.

Rule 1604 - US - DBT (Days Beyond Terms) Change

This rule is similar to Rule 1601, but instead of monitoring rating changes, it monitors changes in the value of DBT (Days Beyond Terms).


Rule 1606 - US - Derogatory Filing Count

  • Param 0: Enter a percentage value indicating the increase or decrease in the filing count that will trigger a notification.
  • Param 1: Enter a value indicating the minimum change (increase or decrease) in the filing count that will trigger a notification.
    For example, you can set it to get notified if the change is greater than 10% or exceeds 20.

Rule 1607 - US - Derogatory Filing Outstanding Amount

  • Param 0: Enter a percentage value indicating the increase or decrease in the outstanding amount that will trigger a notification.
  • Param 1: Enter a value indicating the minimum change (increase or decrease) in the outstanding amount that will trigger a notification.
    Use this parameter in the same way as Rule 1606.

Notes

These rules provide flexibility to monitor various changes in credit scores, credit limits, company statuses, and other metrics. Customize the parameters as needed to align with your business requirements.