Skip to main content
Version: 17

Graydon Creditsafe party provider

What's new​

  • Every stored credit report field is configured in metadataMappings. The credit score, fraud risk score, company status, equity, capital, financial statement currency and additional NACE codes are no longer separate settings. They are now entries in the map: CREDIT_SCORE, FRAUD_RISK_SCORE, COMPANY_ACTIVE, TOTAL_SHAREHOLDERS_EQUITY, CALLED_UP_SHARE_CAPITAL, FINANCIAL_STATEMENT_CURRENCY and ADDITIONAL_NACE_CODES.
  • Same data on the party. Each entry reads the same value and keeps the same write conditions as the V9 setting it replaces.
  • Unchanged: company search, UBO retrieval, legalEventDescriptions and maxEquityFinancialStatementAgeInYears.

🎯 Functional documentation​

This provider can be used to enrich

  • international company party data
  • financial metadata (equity, capital, currency where available)
  • with Fraud Risk Score and Credit Score (BE only)
  • international related parties
  • UBO data

Input data points​

Companies can be searched by name, company number or VAT number (in addition to the required country). The Creditsafe identifier (Connect ID) will be stored in the party's external reference field, unless a specific metadata key is defined in the settings.

⚙️ Configuration​

Required authorization settings​

  • clientId
  • clientSecret
  • resourceUri: https://connect.creditsafe.com/v1/

Implementation class​

CreditsafeV10PartyProvider

Unchanged from V9: only the criteria Creditsafe accepts for the chosen country are sent, a criterion that cannot work is skipped so the next one is tried, a search that cannot work at all is refused with an error naming the field to correct, and where Creditsafe does not offer exact name matching the results are narrowed locally.

UBO retrieval​

The provider supports retrieval of Ultimate Beneficial Owner (UBO) profiles. The Creditsafe Connect company identifier associated with the selected company is reused to retrieve the corresponding UBO information.

Metadata mappings​

metadataMappings lists every Company Credit Report field that is stored on the party and the metadata key each one is stored under. Only the fields present in the map are mapped.

Where V9 configured the credit score, fraud risk score, company status, equity, capital, financial statement currency and additional NACE codes through a setting of their own, V10 configures them through that same map — as CREDIT_SCORE, FRAUD_RISK_SCORE, COMPANY_ACTIVE, TOTAL_SHAREHOLDERS_EQUITY, CALLED_UP_SHARE_CAPITAL, FINANCIAL_STATEMENT_CURRENCY and ADDITIONAL_NACE_CODES. Each reads exactly the same value as the setting it replaces, including the equity, capital and currency that come from the global financial statement for every country, so a configuration moved from V9 stores the same data on the party.

Each field also keeps the write conditions of the setting it replaces. CREDIT_SCORE, FRAUD_RISK_SCORE, COMPANY_ACTIVE and ADDITIONAL_NACE_CODES leave their metadata key untouched when Creditsafe reports no usable value, so refreshing a party does not overwrite what is stored with an empty value. FINANCIAL_STATEMENT_CURRENCY, TOTAL_SHAREHOLDERS_EQUITY and CALLED_UP_SHARE_CAPITAL are written as long as there is a financial statement, with an empty value when the figure is missing — and the equity is left empty when its financial year falls outside maxEquityFinancialStatementAgeInYears — so a refresh clears a value that no longer applies.

maxEquityFinancialStatementAgeInYears remains a setting of its own: it limits the equity mapping rather than naming a metadata key, in the same way legalEventDescriptions drives the legal event mappings. The additional NACE codes are stored as a list, so the key can be a multi-autocomplete field on a NACE code list.

⤴️ Migration guide: V9 to V10​

V10 enriches the same data as V9 and searches the same way; only the settings change. Seven V9 settings are removed and move into metadataMappings under the key they already use:

V9 settingV10 metadataMappings entry
metadataKeyCreditScoreCREDIT_SCORE
metadataKeyFraudRiskScoreFRAUD_RISK_SCORE
metadataKeyCompanyActiveCOMPANY_ACTIVE
metadataKeyEquityTOTAL_SHAREHOLDERS_EQUITY
metadataKeyCapitalCALLED_UP_SHARE_CAPITAL
metadataKeyCurrencyFINANCIAL_STATEMENT_CURRENCY
metadataAdditionalNaceCodesADDITIONAL_NACE_CODES

Settings​

Settings Configuration

Examples