Configuring Bureau van Dijk Orbis

Bureau van Dijk Orbis is a data provider you can use to run these checks:

  • Company data check
  • Company ownership check
  • Company registry check

Company data check

How it works

This is the default behaviour for a variant of the Company data check with Bureau van Dijk Orbis as the data provider.

The check is performed by sending the company's name, country of incorporation, and company number or Bureau van Dijk Orbis ID number to Bureau van Dijk Orbis and requesting a report.

The check passes when all of the following are true:

  1. The company name is found in the registry.
  2. The company status in the registry is active.
  3. The country of incorporation from the profile matches the data in the registry.
  4. The company number or Bureau van Dijk Orbis ID number from the profile match the data in the registry.

When the check passes, the basic company information is imported into the check results. The information is displayed differently for each task. See the description of the Company data check for more information.

The check returns a partial match when the company name is found in the registry but one of the following is true:

  1. Any of the required profile data is missing.
  2. Any of the profile data does not match.
  3. The company status is inactive.
  4. The company status is unknown.
See Required and optional profile fields to learn which profile fields are required.

The check fails if the company name cannot be found.

An error is displayed when the company's country of incorporation isn't covered by the Bureau van Dijk Orbis agreement.

Contact your Bureau van Dijk Orbis account manager to learn what countries your agreement covers.
If multiple results are discovered for the same company, they're ordered by the best match for the name, as determined by Bureau van Dijk Orbis.
This check cannot be used to monitor financial data.
When the results are displayed on the Verify company details task, the Nature of business shows any of the following codes that apply: SIC (US SIC), NACE (NACE Rev. 2) and/or NAICS (NAICS 2017). Note that the UK SIC code is not displayed. Bureau van Dijk Orbis maps the NACE code into the UK SIC code and recommends using NACE because it has international coverage.

Configuration options

You can choose three configuration options, which all relate to ongoing monitoring:

  • Enable monitoring for Identify officers: When this option is selected, data related to the Identify officers task is monitored.
  • Enable monitoring for Identify shareholders: When this option is selected, data related to the Identify shareholders task is monitored.
  • Enable monitoring for Verify company details: When this option is selected, data related to the Verify company details task is monitored.

When new/updated data is discovered, a new task version is created for the relevant task(s) and the old task version expires. The check results are displayed in full on the new version(s).

When ongoing monitoring is enabled, any new results are updated and displayed in PassFort once per week.
After you run a search, monitoring is free for the first 12 months. After that point, you'll be charged when new/updated data is returned. If multiple tasks were updated from the same check result, you'll only be charged once.
This check is used on the Identify officers and Identify shareholders tasks, which include configuration options to control how the officers and shareholders returned by Bureau van Dijk Orbis are verified. Learn about task configuration options.

What we'll need

Let us know that you'd like to add a variant of the Company data check with Bureau van Dijk Orbis and we'll set it up.

If you'd like to use any of the configuration options for the Identify officers or Identify shareholders tasks, please let us know which ones you'd like to use.

We'll also need your Bureau van Dijk Orbis API key. For help getting your username and password, please speak to your Bureau van Dijk Orbis account manager.

Additionally, we recommend that you contact your Bureau van Dijk Orbis account manager and request that they raise the number of concurrent sessions that can be used by your account to 25 sessions. This will enable search to work properly in PassFort, meaning that when you create a new profile via the PassFort portal, you will be able to find companies by typing a company name or number into the search box provided.

If the number of concurrent sessions is not raised, you may see an error message when you type the company name or number into the search box that's displayed when you create a new profile via the PassFort portal. You will still be able to find a company by pasting a full name or number into the search box.
Ongoing monitoring is tied to your Bureau van Dijk Orbis account. If you switch accounts, ongoing monitoring for existing profiles will be stopped because the connection between PassFort and your Bureau van Dijk Orbis account will be broken. To restart ongoing monitoring, re-run the Company data check on your profiles.

Testing your configuration

Once the check variant is configured, follow these steps in your demo environment to test whether it's working as expected.

  • Are results returned from Bureau van Dijk Orbis? Create any company profile and run the check variant. If the check passes and the check results display several officers on the Identify officers task, several shareholders on the Identify shareholders task, and company information on the Verify company details task, the check variant is working as expected.
  • Is a Partial match returned when the company name is found in Bureau van Dijk Orbis's sources but the profile data does not match? Create a company profile with "partial" in the name and run the check variant. If the check returns a partial match and an incorrect company name is displayed in the results of the Verify company details task, the check variant is working as expected.
  • Does the check fail when the company name cannot be found in Bureau van Dijk Orbis's sources? Create a company profile with "fail" in the name and run the check variant. If the check fails and no results are returned, the check variant is working as expected.
The company name and number auto fill feature that's displayed when you create a company profile via the portal displays demo data in the demo environment. Real data will be displayed in the live environment.
Test words are not case sensitive.

Required and optional profile fields

These are the profile details searched in Bureau van Dijk Orbis's sources:

Name

Description

Country of incorporation (metadata.country_of_incorporation)

Required

The country in which the company is incorporated.

Company name (metadata.name)

Required

If not included, a Partial match is returned

The legal name of the company.

Bureau van Dijk Orbis ID number (metadata.bvd_id)

Optional if the Company number is included. Otherwise, required.

A unique identifier issued by Bureau van Dijk Orbis.

Company number (metadata.number)

Optional if the Bureau van Dijk Orbis ID number is included. Otherwise, required.

The company’s registration number.

State of incorporation (metadata.state_of_incorporation)

Optional

The state, province, or territory of the address.

The format follows the state code of the ISO-3166-2 standard.

Note that a UK county should not go here.

Company ownership check

How it works

This is the default behaviour for a variant of the Company ownership check with Bureau van Dijk Orbis as the data provider.

The check is performed by searching the company’s country of incorporation, state of incorporation (US and Canada only), and registration number in Bureau van Dijk Orbis’s sources to find the company’s shareholders.

If the company is found and at least one shareholder is discovered, the check passes and the shareholder’s details are imported into PassFort.

If the company is found but no shareholders can be discovered, the check returns a Partial match.

If the company cannot be found, the check fails.

If the company’s country of incorporation isn’t covered by Bureau van Dijk Orbis, an error is displayed.

Configuration options

There are no additional configuration options for the Company ownership check variant with Bureau van Dijk Orbis.

However, this check is used on the Identify owners task, which includes configuration options to control how the shareholders returned by Bureau van Dijk Orbis are verified. Learn more about task configuration options.

What we’ll need

Let us know that you’d like to add a variant of the Company ownership check with Bureau van Dijk Orbis and we’ll set it up.

If you’d like to use any of the configuration options for the Identify owners task, please let us know which ones you’d like to use.

We’ll also need your Bureau van Dijk Orbis API key. For help getting your API key, please speak to your Bureau van Dijk Orbis account manager.

Testing your configuration

Once the check variant is configured, follow these steps in your demo environment to test whether it's working as expected:

  • Are shareholder results returned from Bureau van Dijk Orbis? Create any company profile and run the check variant. If the check passes and the check results show Ocado Holdings Limited as a shareholder with ownership of 100% of the company’s shares, the check variant is working as expected.
The data returned is demo data only.
In the live environment, an error is displayed when the check variant is run on a profile with a country of address that isn’t covered by Bureau van Dijk Orbis. This error is not displayed in the demo environment.

Required and optional profile fields

These are the profile details searched in Bureau van Dijk Orbis’s sources:

Name

Description

Country of incorporation (metadata.country_of_incorporation)

Required

The country in which the company is incorporated.

State of incorporation (metadata.state_of_incorporation)

Required (US, Canada, Australia)

Optional (all other countries)

The state, province, or territory of the address.

The format follows the state code of the ISO-3166-2 standard.

Note that a UK county should not go here.

Company number (metadata.number)

Required

The company’s registration number.

Company registry check

How it works

This is the default behaviour for a variant of the Company registry check with Bureau van Dijk Orbis as the data provider.

The check is performed by searching the company’s country of incorporation, state of incorporation (US and Canada only), and registration number in the registry that Bureau van Dijk Orbis is using for the jurisdiction in which the company was incorporated.

The check passes when all of the following are true:

  1. The company name is found in the registry.
  2. The company status in the registry is active.
  3. The company number and country of incorporation from the company’s profile match the data found in the registry.

When the check passes, the basic company information (e.g. name, company number, incorporation date) as well as a list of all the company officers found in the registry is imported into the check results.

If the company name is found, but any of the other data is missing or does not match, the check returns a Partial match.

If the company name cannot be found, the check fails.

If the company’s country of incorporation isn’t covered by Bureau van Dijk Orbis, an error is displayed.

Configuration options

There are no additional configuration options for the Company registry check variant with Bureau van Dijk Orbis.

However, this check is used on the Identify officers task, which includes configuration options to control how the officers returned by Bureau van Dijk Orbis are verified. Learn more about task configuration options.

What we’ll need

Let us know that you’d like to add a variant of the Company registry check with Bureau van Dijk Orbis and we’ll set it up.

If you’d like to use any of the configuration options for the Identify officers task, please let us know which ones you’d like to use.

We’ll also need your Bureau van Dijk Orbis API key. For help getting your API key, please speak to your Bureau van Dijk Orbis account manager.

Testing your configuration

Once the check variant is configured, follow these steps in your demo environment to test whether it's working as expected.

  • Are company officer results returned from Bureau van Dijk Orbis? Create any company profile and run the check variant. If the check passes and the check results display several officers, the check variant is working as expected.
The data returned is demo data only.
In the live environment, an error is displayed when the check variant is run on a profile with a country of address that isn’t covered by Bureau van Dijk Orbis. This error is not displayed in the demo environment.

Required and optional profile fields

These are the profile details searched in Bureau van Dijk Orbis’s sources:

Name

Description

Country of incorporation (metadata.country_of_incorporation)

Required

The country in which the company is incorporated.

State of incorporation (metadata.state_of_incorporation)

Required (US, Canada, Australia)

Optional (all other countries)

The state, province, or territory of the address.

The format follows the state code of the ISO-3166-2 standard.

Note that a UK county should not go here.

Company number (metadata.number)

Required

The company’s registration number.


How did we do?


Powered by HelpDocs (opens in a new tab)