D&B Direct Data Primer

This Microsoft Exceltm spreadsheet identifies the business elements and data fields delivered by each D&B Data product, along with the data types and definitions. Also available is a chart showing what countries have data available for each D&B Data product.

Latest Edition

http://developer.dnb.com/docs/2.0/DNB-Data-Primer-v110.zip

Released: May 11, 2015.
Refreshed*: May 11, 2015.
Upgrades: SBRI v3.2 changes.

See April 2015 Release Notes for details on changes.

In an effort to improve efficiency and reduce redundancy, some data fields in the D&B Direct API deliver multiple business elements. When these scenarios occur, developers will need to inspect adjacent fields and/or attributes to identify specific business elements. Details...

Archived Editions

Please use the Latest Edition unless the business element and/or data field details are required for implementations using a deprecated service version.

http://developer.dnb.com/docs/2.0/DNB-Data-Primer-v109.zip

Released: March 13, 2015.
Refreshed*: April 24, 2015.
Upgrades: Firmographic v5.0, consistency cleanup.

See March 2015 Release Notes for details on changes.

http://developer.dnb.com/docs/2.0/DNB-Data-Primer-v108.zip

Released: January 23, 2015.
Refreshed*: January 30, 2015.
Upgrades: Assessment v5.0.

See January 2015 Release Notes for details on changes.

http://developer.dnb.com/docs/2.0/DNB-Data-Primer-v107.zip

Released: December 12, 2014.
Refreshed*: December 12, 2014.
Upgrades: EntityList v4.1.

See December 2014 Release Notes for details on changes.

http://developer.dnb.com/docs/2.0/DNB-Data-Primer-v106.zip

Released: October 3, 2014.
Refreshed*: November 17, 2014.
Upgrades: Data Exchange v1.0.
Additions: Data Exchange tab. Data Layer tab (replaces "Products"), Parameters tab renamed to "Product Request", Data Fields tab renamed to "Product Response". Data Layers included in Quick Search.

See October 2014 Release Notes and September 2014 Release Notes for details on changes.

http://developer.dnb.com/docs/2.0/DNB-Data-Primer-v105.zip

Released: August 22, 2014.
Refreshed*: September 15, 2014.
Upgrades: Firmographic v3.2 (SDMR).
Additions: Quick Search, (Product) Parameters, (Feature) Request, Response tabs. Type/Length/Cardinality columns and Possible Values/Geographic Limitation columns (Data Fields tab).

See August 2014 Release Notes for details on changes.

http://developer.dnb.com/docs/2.0/DNB-Data-Primer-v104.zip

Released: March 7, 2014. Revised: March 28, 2014.
Refreshed*: July 30, 2014.
Upgrades: Firmographic v3.2, Contact 4.0.
Additions: Management Responsibility Code (MRC) to Hoover's Job List tab.

See March 2014 Release Notes for details on changes.

http://developer.dnb.com/docs/2.0/DNB-Data-Primer-v103.zip

Released: January 3, 2014.
Refreshed*: March 5, 2014.
Upgrades: Assessment v4.0, TradeDetail v4.0.

See January 2014 Release Notes for details on changes.

http://developer.dnb.com/docs/2.0/DNB-Data-Primer-v102.zip

Released: December 11, 2013.
Refreshed*: March 3, 2014.
Upgrades: Firmographic v3.0.

See December 2013 Release Notes for details on changes.

http://developer.dnb.com/docs/2.0/DNB-Data-Primer-v101.zip

Released: October 28, 2013.
Refreshed*: January 15, 2014.
Upgrades: Firmographic v2.1; SBRI v3.2.

See October 2013 Release Notes for details on changes.

http://developer.dnb.com/docs/2.0/DNB-Data-Primer-v100.zip

Released: October 8, 2013.
Refreshed*: January 15, 2014.
Includes: Assessment v3.0; Contact v3.0; Financial v3.0; Firmographic v2.0; Industry v3.0; Linkage v3.1; News and Media v3.0; Public Record v3.0; SBRI v3.1; Trade Detail v3.0

*These files are periodically refreshed with the latest business element definitions, and to incorporate any adjustments/minor corrections made to the services.

What's Included

Data Layers Tab (was "Products")

This tab lists D&B Direct product codes, along with the data layer name, level and service (required for SOAP implementations). The table also maps the products to similar offerings from D&B Direct 1.x and the D&B Data Integration Toolkit.

Business Elements Tab

D&B Direct API services supply information in standardized Data Fields, each of which may deliver multiple Business Elements. This tab lists business element names and the product packages that they are included in, along with the corresponding data field (a.k.a. XPATH). The column headings are D&B Direct product codes (refer to the Products tab for product names). See also explanation of standard elements.

In an effort to improve efficiency and reduce redundancy, some data fields in the D&B Direct API deliver multiple business elements. When these scenarios occur, developers will need to inspect adjacent fields and/or attributes to identify specific business elements.  Details...

Product Request Tab (was "Parameters")

A table listing input parameters across the product data layers.

Product Response Tab (was "Data Fields")

A table listing XPATH's referenced by D&B Direct products, along with the data type, occurrences, and definition. Each data field is identified as either an aggregate, attribute or element.

Feature Request Tab

A table listing input parameters across the match, search, investigation and other features.

Feature Response Tab

A table listing response fields across the match, search, investigation and other features.

Data Exchange Tab

A table listing response fields from partners participating in the D&B Data Exchange.

Country Chart Tab

A table listing available country names and codes mapped to each D&B Direct product and report. The column headings are D&B Direct product codes (refer to the Products tab for product names). Included is a mapping to the country codes used by D&B Direct 1.x and the D&B Worldbase-based products.

Documentation vs. Data Primer

While we make every effort to ensure the contents of the Data Primer are reflected in the online documentation, there may be times when a lag occurs. The Data Primer is ALWAYS updated prior to the field listings on documentation pages.

There are also some intentional differences between the Data Primer and product overview pages (a.k.a. "business element" pages), where the following types of items will NOT appear:

Back to Top