DNBConnect – setup and use
DNBConnect brings data from Dun & Bradstreet Direct+ onto customers and vendors in Business Central: DUNS number, company information, financial statements, risk scores and credit recommendation. Monitoring retrieves changes from D&B daily via the job queue and creates warnings. All calls to D&B are written to the communication log.
Prerequisites
-
Business Central online, version 26 or later
-
A Dun & Bradstreet Direct+ subscription with an API key and secret from D&B's invitation email. D&B issues keys per domain (D&B for Enterprise Master Data and D&B for Finance) and per environment (production and development)
-
The permission set SMIDNB (Dun and Bradstreet - full access) for the users who set up the app, search for DUNS numbers and retrieve data
-
The permission set SMIDNBVIEW (Dun and Bradstreet - read access) for the users who only need to see D&B data. Users with neither of them see no D&B fields or actions
-
For monitoring: one or more monitoring registrations, which D&B creates for you, with delivery API_PULL
Getting started
-
Search for Dun and Bradstreet Setup and open the page. The first time, a 14-day trial licence is inserted automatically and the standard data blocks are created.
-
Enter the API key and secret for the domains and environments you have keys for. Select Environment = Production or Test.
-
Select Test connection. The page shows for each domain whether a token could be retrieved.
-
Select Check D&B entitlements. Data blocks and levels that the keys do not cover are marked.
-
Open a customer or vendor, select Find DUNS No. and choose the right company among the candidates.
-
Select the D&B data scope on the card: Company info (company information) or Financial info (also financial statements and risk).
-
Select Update from D&B. Data is shown in the fact box and under D&B information.
-
If you want to use monitoring: open Monitoring registrations, select Get registrations from D&B, and then select Create job queue entry on the setup page.
The setup page
Connection
The base URL, token path and data path are filled in in advance (https://plus.dnb.com). The timeout is specified in milliseconds.
Environment – Production uses the production keys, Test uses the development keys (for non-commercial use only). Both use the same URL.
API keys
There is one set of fields per domain: Enterprise Master Data keys are used for company information, Find DUNS No. and usage; Finance keys are used for financial information. The key determines which D&B quota the lookup counts against. The values are stored in isolated storage and are only shown as asterisks. Clear the field to remove a key.
Data blocks
The list shows the D&B data blocks that are retrieved: block code, level, version, scope (company or financial) and entitlement status. The standard blocks are companyinfo, companyfinancials, financialstrengthinsight and eventfilings. Switch off blocks that your subscription does not cover. All data from D&B can be seen under All D&B data, including for blocks without their own view.
Lookup settings
Switch to head office – retrieve data for the head office instead of a branch.
Order reason – only required for German companies, e.g. 6332.
Customer reference – sent with every lookup so that it can be reconciled with D&B's invoicing.
Identity resolution (Find DUNS No.)
Min. confidence code – the lowest D&B confidence code (1-10) that a candidate must have. D&B's default is 4.
Max. number of candidates – at most 25.
Cost control
Skip confirmation of billable lookups – when the field is switched off, Find DUNS No. and Update from D&B ask first. The job queue never asks.
Monitoring
Notifications per retrieval – how many notifications are retrieved per call. Retrieval continues until there are no more.
Warn after days without a run – D&B deletes notifications that are not retrieved within 14 days. The latest monitoring run is shown in red when the run is delayed.
Log
Keep log entries (days) – older entries are deleted with Delete old log entries. 0 keeps all entries. The latest response for each D&B company is always kept.
Log level – All calls, Errors only or None. Successful data responses are always stored, because they contain the raw data behind the stored values.
Licence
Licence key – select Click to request licence to start a trial licence or request a full licence. Status/expiry shows whether the licence is valid. Without a valid licence no calls are sent to D&B; the stored data can still be viewed.
Customers and vendors
The customer and vendor card has the fields DUNS No. and D&B data scope and the actions Find DUNS No., D&B information and Update from D&B. The Dun & Bradstreet fact box on cards and lists shows name, update time, open warnings, risk indicators, failure and delinquency score, D&B rating, credit recommendation and the latest financial statement.
Find DUNS No. searches first on the VAT registration number (without country code) and then on name, address and phone. The country code is taken from the customer or vendor, otherwise from the company information.
The D&B data scope controls what is retrieved: empty = nothing, Company info = the company blocks with the Enterprise Master Data key, Financial info = all blocks with the Finance key. A DUNS number counts once per period against the quota of the domain that is used.
D&B companies
The Dun and Bradstreet companies list shows all retrieved DUNS numbers across companies. The company card shows all retrieved fields and financial statements. Reload stored response reads the data again from the stored response without a new (billable) call.
Monitoring
A monitoring registration is created by D&B and belongs to one API key. Get registrations from D&B retrieves your registrations and their details. On each registration, specify which D&B data scope it monitors and switch it on.
Synchronise pool adds DUNS numbers from customers and vendors in all companies with the corresponding data scope and removes those that no longer need to be monitored. Get notifications retrieves the changes and updates the stored D&B data.
Create job queue entry on the setup page creates a daily job queue entry at 06:00 with status On Hold (codeunit 6240042, SMIDNBMonitoringJob). It synchronises the pool and retrieves notifications. Set it to Ready when the time and category have been checked.
Warnings
Warnings are created when data changes – both through monitoring and manual updates: falling credit recommendation, worse failure or delinquency score, changed D&B rating, new risk indicator, changed operating status, and when D&B transfers, deletes or reviews a DUNS number. Warning rules control which changes give a warning and how much the credit recommendation must fall. Acknowledge the warning when it has been dealt with.
Communication log
All calls to D&B are logged with date/time, user, company, type, domain, environment, DUNS No., customer or vendor, background or manual, HTTP method and status, duration, D&B transaction ID and error message. Select Show request or Show response for the full content. API keys, secrets and tokens are never part of the log.
Troubleshooting
Test connection fails with HTTP 401 – the key or secret is wrong, or the key belongs to the other environment.
No valid licence – request a licence on the setup page.
Find DUNS No. finds no candidates – check the VAT number and country, or lower Min. confidence code.
Blocks are missing in the response – see Block status on the D&B company and select Check D&B entitlements.
Monitoring retrieves nothing – the registration must be switched on, have delivery API_PULL and belong to the selected environment.
Support
Contact: sc@systemconnect.dk
© 2026 SystemConnect
