Cookies Settings

Loading

dnb-logo
Direct 2.0
Collapse

Ordering Custom Products

D&B Direct allows the creation of custom collections of data elements per customer account. Custom collections are configured by D&B Sales Associates, and then made available through API calls.

Update History

  • November 1, 2024 (ALL SOAP & REST):Mapping update of Legal Event Indicators for Spain, Norway, Australia, Indonesia, Philippines, Thailand, Egypt, Pakistan, Bangladesh, Sri Lanka, Maldives, Mauritius, Belgium and Luxembourg markets.
  • October 11, 2024 (ALL SOAP & REST): Financial statements data improvements in overview elements for Myanmar, Cambodia, Laos, Brunei and Vietnam markets.
  • October 11, 2024 (ALL SOAP & REST): Registration Number mapping update for France market.
  • October 11, 2024 (ALL SOAP & REST): Updated Primary Address (Territory and Country) mapping for Russia market.
  • October 11, 2024 (ALL SOAP & REST): Updated Primary Address (Territory and Country) mapping for Armenia, Azerbaijan, Belarus, Georgia, Kazakhstan, Kyrgyzstan, Moldova, Russia, Tajikistan, Turkmenistan and Uzbekistan markets.
  • October 11, 2024 (ALL SOAP & REST): Legal Form Mapping Update (Non-Corporate Entity) for Japan market.
  • October 11, 2024 (ALL SOAP & REST): Updated Primary Address (Territory and Country) mapping for Paraguay and Uruguay markets.
  • October 11, 2024 (ALL SOAP & REST): Updated Legal Event mapping for Poland market.
  • October 11, 2024 (ALL SOAP & REST): New Registration Identification number to identify the companies within the same group for Hungary market.
  • October 11, 2024 (ALL SOAP & REST): Added 27 new Legal event codes for Hungary market.
  • October 11, 2024 (ALL SOAP & REST): Mapping update of 'Significant Events' as the 'Legal Events' with a new or existing Legal Event SCoTS code associated with each of them for Hungary market.
  • September 20, 2024 (ALL SOAP & REST): LegalForm mapping update for Australia market.
  • March 22, 2024 (ALL SOAP & REST): Financial Data improvements in Statements for Egypt, Philippines and United Arab Emirate Markets
  • March 01, 2024 (ALL SOAP & REST): Mapping update of Financial Embarrassment Indicator for Austria market.
  • March 01, 2024 (ALL SOAP & REST): Mapping update to populate CountryISOAlpha2Code as ‘US’ in the response for ‘PR’ and ‘VI’ markets .
  • March 01, 2024 (ALL SOAP & REST): Mapping update to change the priority order of Business Registration Number for Hong Kong market.
  • February 09, 2024 (ALL SOAP & REST): Mapping update of Financial Embarrassment Indicator for Austria market.
  • February 09, 2024 (ALL SOAP & REST): Mapping update of Financial Statement Overview for Greece, Romania, Bulgaria, Turkey and Turkish Republic of Northern Cyprus markets.
  • January 05, 2024 (ALL SOAP & REST): Mapping update of Legal Event Indicators for Switzerland, Liechtenstein and Romania markets.
  • January 05, 2024 (ALL SOAP & REST): Mapping update of Financial Embarrassment Indicator for Poland market.
  • December 08, 2023 (ALL SOAP & REST): Mapping update of Legal Event Indicators for Serbia and Montenegro markets.
  • December 08, 2023 (ALL SOAP & REST): Financial statements data improvements in overview elements for Brazil, Thailand, Australia, New Zealand, Paraguay, Portugal, Luxembourg, Belgium, Spain, Andorra, Netherlands, Argentina, Uruguay markets.
  • December 08, 2023 (ALL SOAP & REST): Financial statements data improvements in overview elements for China, Korea, Mexico, Colombia, France, Switzerland, Liechtenstein, Sweden, Norway, Austria, Germany markets.
  • December 08, 2023 (ALL SOAP & REST): Suspension of trade licenses, Addition of Liens, Addition of Primary Address and mapping of Minor Post Town for Czech Republic, Slovakia markets.
  • December 08, 2023 (ALL SOAP & REST): Granular Legal Form codes addition for Hungary market.
  • December 08, 2023 (ALL SOAP & REST): Mapping update of Legal Event indicators for Bulgaria and Poland markets.
  • December 08, 2023 (ALL SOAP & REST): Fix mapping of Legal Event indicators for Serbia and Montenegro markets.
  • November 03, 2023 (ALL SOAP & REST): Mapping update of Legal Event Indicators for Poland, Hungary, Bulgaria, Greece, Romania, Belgium, Netherlands, Luxembourg, Slovenia, Croatia, Bosnia, Serbia, Montenegro, Albania, Kosovo & Macedonia markets.
  • October 13, 2023 (ALL SOAP & REST): Financial statements data improvements in overview elements for Brazil, Thailand, Australia, Newzeland, Paraguay, Portugal, Luxembourg, Belgium, Spain, Andorra, Netherlands, Argentina, Uruguay markets.
  • October 13, 2023 (ALL SOAP & REST): Mapping update of Legal Event Indicators.
  • October 13, 2023 (ALL SOAP & REST): Enable Paydex and Trade elements for Singapore and Argentina markets.
  • August 11, 2023 (ALL SOAP & REST): Update Commercial Credit Score and commentaries for UK market.
  • August 11, 2023 (ALL SOAP & REST): Legal event indicators mapping update for Japan, Korea, Singapore & Argentina markets.
  • August 11, 2023 (ALL SOAP & REST): Replace existing Hoovers Industry Code 25838 with 35912 (new version).
  • July 21, 2023 (ALL SOAP & REST): Financial Data improvements in Statements for Netherlands, Belgium, Ireland, United Kingdom, Singapore, Japan, Malaysia, Luxembourg, Czech Republic, Slovakia markets.
  • July 21, 2023 (ALL SOAP & REST): Addition of New Insolvency Proceeding Law to comply with legislation for Spain market.
  • July 21, 2023 (ALL SOAP & REST): Addition of Legal event for Appointment of Restructuring Practitioner for Australia market.
  • July 21, 2023 (ALL SOAP & REST): Adding Distraints on ownership share data (Addition of Legal Events) for Czech Republic, Slovakia markets.
  • July 21, 2023 (ALL SOAP & REST): Legal Form Addition and Expansion for Poland market.
  • May 12, 2023 (ALL SOAP & REST): VAT related information & VAT payment details: Significant Events for CZ and SK markets.
  • May 12, 2023 (ALL SOAP & REST): Insolvencies: Addition of Legal Event for CZ and SK markets.
  • May 12, 2023 (ALL SOAP & REST): Financial Data Remapping in Overview Section (only for European template - 20597) for Italy and San Marino markets.
  • May 12, 2023 (ALL SOAP & REST): Financial Data Remapping in Overview Section for India markets.
  • May 12, 2023 (ALL SOAP & REST): Financial Data Remapping in Overview Section for Taiwan markets.
  • May 12, 2023 (ALL SOAP & REST): Financial Data Remapping in Overview Section for Hong Kong markets.
  • May 12, 2023 (ALL SOAP & REST): Financial Data Remapping in Overview Section for Poland markets.
  • May 12, 2023 (ALL SOAP & REST): Financial Data Remapping in Overview Section for Denmark markets.
  • May 12, 2023 (ALL SOAP & REST): Financial Data Remapping in Overview Section for Finland markets.
  • May 12, 2023 (ALL SOAP & REST): Legal Event indicators mapping update for India, Hong Kong, Taiwan and China markets.
  • April 21, 2023 (ALL SOAP & REST): Upgrade Financial Stress Score & SER for India market.
  • March 10, 2023 (ALL SOAP & REST): VAT Registration Number addition for Sweden, Finland and Norway markets.
  • March 10, 2023 (ALL SOAP & REST): Number of Employees and Financial Statement mapping update for Japan market.
  • March 10, 2023 (ALL SOAP & REST): Primary Country Subdivision mapping update for Spain market.
  • March 10, 2023 (ALL SOAP & REST): Financial Data Remapping in Overview Section for Canada market.
  • March 10, 2023 (ALL SOAP & REST): Addition of new legal event Type Illegal employment details for Slovakia market.
  • March 10, 2023 (ALL SOAP & REST): Addition of Industry Code SIC8 and NACE Rev2 for Albania, Kosovo and Macedonia markets.
  • March 10, 2023 (ALL SOAP & REST): Addition of new legal event Type - Tax certificates data for Brazil market.
  • January 27, 2023 (ALL SOAP & REST): Mapping update of Legal Events Indicator for India market.
  • January 06, 2023 (ALL SOAP & REST):Mapping update of Legal Events Indicator to use updated Scots Code for Greenland, Faroe Islands markets.
  • Decemeber 09, 2022 (ALL SOAP & REST): Upgrade Delinquency score and commentaries for UK market.
  • Decemeber 09, 2022 (ALL SOAP & REST): Legal Events Court detailed data, Adding role players and updating end ind/date for Hong Kong Market.
  • Decemeber 09, 2022 (ALL SOAP & REST): Additional Postal Office Addressing Information for Serbia market.
  • Decemeber 09, 2022 (ALL SOAP & REST): Debt Recovery Tribunals India Negative Events data for India market.
  • Decemeber 09, 2022 (ALL SOAP & REST): Legal Events - NCLT / IBBI - India Negative data for India market.
  • Decemeber 09, 2022 (ALL SOAP & REST): New Bankruptcy Law - New Measure and Proceedings, early indicator for bankruptcy & new principal positions [41145 - Finanacial Crisis Expert] for Italy Market
  • Decemeber 09, 2022 (ALL SOAP & REST): Legal Event new information about court decision – orders to pay for Slovakia market.
  • Decemeber 09, 2022 (ALL SOAP & REST): Addition of NICE Industry Type Code : Korea Standard Industry Code (KSIC)
  • Decemeber 09, 2022 (ALL SOAP & REST): ICAP- Local Legal Forms for Greece market.
  • Decemeber 09, 2022 (ALL SOAP & REST): New Legal Event Code which is called the notice of intention to deregister for Australia Market.
  • Decemeber 09, 2022 (ALL SOAP & REST): Legal Events to populate Event Result Date Under Event Results in GSRL7 for Portugal market
  • Decemeber 09, 2022 (ALL SOAP & REST): Addition of Statement From Date in Financial Statement for Portugal market
  • Decemeber 09, 2022 (ALL SOAP & REST): Addition of 5 new subject commentaries for companies from Guernsey and Isle of Man - United Kingdom markets.
  • October 21, 2022 (ALL SOAP & REST): Mapping update of Legal Events Indicator to use updated Scots Code for NORDIC markets (Denmark, Sweden, Norway, Finland, Greenland, Faroe Islands).
  • October 07, 2022 (ALL SOAP & REST): Registered Business Address changes of companies from Jersey, Guernsey and Isle of Man (currently populated in text line, will be changed to structured format) - United Kingdom markets.
  • October 07, 2022 (ALL SOAP & REST): Addition of new registration numbers and removal of Company House UK registration numbers for companies from Jersey, Guernsey and Isle of Man - United Kingdom markets.
  • October 07, 2022 (ALL SOAP & REST): Addition of new Legal Form codes for companies from Jersey, Guernsey and Isle of Man- United markets.
  • October 07, 2022 (ALL SOAP & REST): Addition of new Legal Events for companies from Jersey, Guernsey and Isle of Man- United Kingdom markets.
  • September 16, 2022 (ALL SOAP & REST): Upgrade Financial Stress Score & SER for Ireland market.
  • August 05, 2022 (ALL SOAP & REST): Defect fix to update mapping of Legal Events Indicator to use end date & end indicator data for Nordic markets.
  • August 05, 2022 (ALL SOAP & REST): Mapping update of Legal Events Indicator to use updated Scots Code for US/CA/BR/MX/JP/ZW markets.
  • July 15, 2022 (ALL SOAP & REST): Addition of Russia OKVED Local Activity code.
  • July 15, 2022 (ALL SOAP & REST): Addition of Mexico SCIAN Local activity code.
  • July 15, 2022 (ALL SOAP & REST): Addition of SIC Code 6 & TSR Industry code 4,5,6 for Japan.
  • July 15, 2022 (ALL SOAP & REST): Addition of companies start year, month and day in Subject Details for Spain, Andorra market.
  • July 15, 2022 (ALL SOAP & REST): Addition of new Principal position codes Executive Officer, Representative Director, Non-Executive Director (Only Director were coming earlier) for Japan.
  • June 17, 2022 (ALL SOAP & REST): Defect fix to update mapping of OrganizationIdentificationNumber in case of multiple occurrences.
  • May 13, 2022 (ALL SOAP & REST): Mapping update of Legal Event Indicators to use updated Scots Code for UK market.
  • April 22, 2022 (ALL SOAP & REST): Mapping update of Financial Embarrassment Indicator to use updated Scots Code for UK,AT/PT/DE/CH/LI/CZ & SK markets.
  • April 22, 2022 (ALL SOAP & REST): Mapping update of Claims Indicator to use updated Scots Code for AT/PT/CH/CZ & SK markets.
  • April 22, 2022 (ALL SOAP & REST): Mapping update of Suit, Judgments Indicator to use updated Scots Code for DE/CH/LI/AU & NZ markets.
  • April 22, 2022 (ALL SOAP & REST): Mapping update of Financial/Legal Special Events Indicator to use updated Scots Code for AT/PT/DE/CH/LI/CZ/SK/AU & NZ markets.
  • April 22, 2022 (ALL SOAP & REST): Mapping update of Operational Special Events Indicator to use updated Scots Code for AT/PT/DE markets.
  • April 22, 2022 (ALL SOAP & REST): Mapping update of Other Special Events Indicator to use updated Scots Code for AT, DE, CZ & SK markets.
  • April 01, 2022 (ALL SOAP & REST): Adding new VAT number and cancellation of VAT identification for Slovenia market
  • April 01, 2022 (ALL SOAP & REST): Additional Information on Banking(For Individual accounts), Legal Event(All accounts Frozen) for four countries
  • April 01, 2022 (ALL SOAP & REST): Adding the details of Stolen/Lost and Bounced Cheques for Brazil market.
  • April 01, 2022 (ALL SOAP & REST): Addition of Protested Bills quantity and Employment Suit details for Brazil market
  • April 01, 2022 (ALL SOAP & REST): Registered company name data population fix for Italy, San Marino market.
  • April 01, 2022 (ALL SOAP & REST): Addition of End Indicator, End Date and Published date for Italy, San Marino market.
  • April 01, 2022 (ALL SOAP & REST): Addition details of GST signal Data like active/inactive/cancelled status of GST number for India market.
  • April 01, 2022 (ALL SOAP & REST): Addition of Local business identifier for San Marino market.
  • February 18, 2022 (ALL SOAP & REST): Adding Consolidated financial statement item and new elements like Financial Statement Item, Consolidation Method Code, Display Sequence for France market.
  • February 18, 2022 (ALL SOAP & REST): Adding new Business Identification Number-“MSME UDYAM Registration Number” (Organization ID) for India market.
  • January 07, 2022 (ALL SOAP & REST): Defect fix to resolve failure response for Congo countries.
  • December 10, 2021 (ALL SOAP & REST): Enable Failure Score for Finland country.
  • December 10, 2021 (ALL SOAP & REST): Mapping update for Incorporation year (UK/Ireland).
  • December 10, 2021 (ALL SOAP & REST): Defect Fix for CSS and FSS mapping update (Canada).
  • October 22, 2021 (ALL SOAP & REST): Mapping update for Legal events indicators to use updated Scots Code.
  • October 08, 2021 (ALL SOAP & REST): Defect fix to suppress principal information of non-English Principal name to avoid incomplete Principal and Management section in the response.
  • August 18, 2017 (v3.1 SOAP & REST): Upgraded Custom Product service to version 3.1.
  • August 18, 2017 (v3.0 SOAP & REST): Updated monitoring paths in response elements specification.
  • July 15, 2016 (v3.0 SOAP & REST): Monitoring for GBO product has been enabled for the following countries; Austria, Belgium, Germany, Italy, Ireland, Luxembourg, Netherlands, Portugal, Spain, Switzerland, and United Kingdom.
  • July 15, 2016 (v3.0 SOAP & REST): SR_GLB and SR_SLJ data layers released as part of D&B Direct 2.0 API.
  • July 15, 2016 (v3.0 SOAP & REST): SMPL_OWNSHP, GBO and KYC data layers released as part of D&B Direct 2.0 API.
  • July 15, 2016 (v3.0 SOAP & REST): CMP_VRF_ID and CMP_VRF_RPT data layers released as part of D&B Direct Onboard API.
  • March 21, 2016, (v3.0 SOAP & REST): CountryGroupName, LastUpdateDate, CountryOfficialName, RegistrationIssuerName, RegistrationLocationName, TelecommunicationAddress, ActiveSanctionsIndicator, MatchedSubjectName, MatchedEntityTypeText, MatchKeywordText, MatchedIndicator, SanctionListName, SanctionsAuthorityWebPageAddress, ChildrenQuantity, ChildrenTypeText, GlobalUltimateFamilyTreeLinkageCount, and SubjectFamilyTreeLinkageCount are added.
  • January 29, 2016 (v3.0 SOAP & REST): The element OperatingStatusFromDate is available for CST_PRD 1 to 6.
  • December 11, 2015 (v3.0 SOAP & REST): United Nations Standard Products and Services Code is now available for CST_PRD 1 to 6; D-U-N-S Transfer data is available for CST_PRD 1 to 6.
  • August 21, 2015 (v3.0 SOAP & REST): OrganizationEndDate will now return a value in "yyyy-mm-dd" format in PIAP_ENH and PIAP_PREM.
  • August 21, 2015 (v3.0 SOAP & REST): MetropolitanStatisticalAreaFIPSCode definition adjusted from integer to string of length 10.
  • May 29, 2015 (v2.0 SOAP & REST): SMPL_OWNSHP, GBO and KYC data layers released as part of D&B Direct Onboard API.
  • October 3, 2014 (v2.0 SOAP & REST): For Belgium case countries, the calculation for the Financial Embarrassment and Other Special Events indicators has been expanded to encompass additional conditions.
  • August 22, 2014 (v2.0 SOAP & REST): Custom data layers are now accepted by the monitoring service. Use GetProductCatalog for list of elements which will be monitored.

Product Request

IMPORTANT: Due to a known issue, please do not include request values for SubmittingOfficeID.

IMPORTANT: Please see the new Online Services Security Enhancement Release, effective November 09, 2020.

Overview

When requesting a Custom Product (that excludes small businesses or company principals), a valid D-U-N-S Number for a company, its country code, and the appropriate product code will be required. A trade up option exists to request data for the headquarters when the requested organization is a branch.

When requesting a Custom Product for a small business, you will be required to supply either valid D-U-N-S Number or subject identification number (Subject ID) for a small business, a country code of "US", and the appropriate product code. Subject IDs for organizations may be obtained by using the small business option in the On-Demand Entity Identification feature.

When requesting a Custom Product for a company principal, you will be required to supply the valid D-U-N-S Number for a company, principal identification number (Principal ID), and the appropriate product code. Principal IDs for individual company officers may be obtained by using the Search & Build-a-List - Contacts (Plus Email Lookup) feature.

NOTE: When ordering information for organizations located in Germany, customers are required to provide a valid order reason code.

Data Layer Entitlement

For customers in U.S. and Canadian markets, the API is provisioned for specific collections of products, reports, and/or features (collectively referred to as data layers) for production and trial usage. Entitlement is not required for testing in the sandbox environment.

  • This product is entitled as "Custom Product 1 to 6" for D&B Direct 2.0 customers.

For customers in the UK, Ireland, Belgium, Netherlands and Luxembourg markets, the API is provisioned as a specific set of data layers for production, trial, and sandbox usage.

  • This particular data layer is NOT included in the D&B Direct Onboard suite.

Specification

Sample Request
<soapenv:Envelope xmlns:cus="http://services.dnb.com/CustomProductServiceV2.0" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header>
      <wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
         <wsse:UsernameToken wsu:Id="UsernameToken-1BBED827A7375C1E8214955218920588">
            <wsse:Username>S100000A2B4A3B97E494E279B175E98C</wsse:Username>
            <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">password</wsse:Password>
         </wsse:UsernameToken>
      </wsse:Security>
   </soapenv:Header>
   <soapenv:Body>
      <cus:OrderProductRequest ServiceVersionNumber="3.1">
         <OrderProductRequestDetail>
            <InquiryDetail>
               <DUNSNumber>804735132</DUNSNumber>
            </InquiryDetail>
            <ProductSpecification>
               <DNBProductID>CST_PRD_3</DNBProductID>
               <TradeUpIndicator>0</TradeUpIndicator>
            </ProductSpecification>
            <ArchiveDetail>
               <ArchiveProductOptOutIndicator>false</ArchiveProductOptOutIndicator>
            </ArchiveDetail>
            <!--InquiryReferenceDetail>
               <CustomerReferenceText>2 3.1 3 2ENABLE_MOCK_TEST</CustomerReferenceText>
            </InquiryReferenceDetail-->
         </OrderProductRequestDetail>
      </cus:OrderProductRequest>
   </soapenv:Body>
</soapenv:Envelope>

Name Characteristics
OrderProductRequest Aggregate
OrderProductRequest @ServiceVersionNumber Attribute
OrderProductRequest. TransactionDetail Aggregate, Optional

Records information necessary to process this request.

OrderProductRequest. TransactionDetail. ApplicationTransactionID string, up to 64 chars, Optional

A number assigned by the calling application to uniquely identify this request.

OrderProductRequest. TransactionDetail. TransactionTimestamp DateTimestamp, Optional

The date and time when this request was created. When the request is from an intermediary, such as a workflow manager or service bus, this is the date and time when the message was sent to the D&B function, i.e., the date and time when the xml document was created by the requesting intermediary.

OrderProductRequest. TransactionDetail. SubmittingOfficeID string, up to 64 chars, Optional

A number that identifies the system or the software application from where this request originated. / A number used to uniquely identfy the D&B business segment or delivery channel from where this request originated.

End: OrderProductRequest. TransactionDetail /Aggregate
OrderProductRequest. OrderProductRequestDetail Aggregate, Optional

Records data relating to requests for a product. This may include such details as the product required, the subject about which the product should be produced, the content of the product.

OrderProductRequest. OrderProductRequestDetail. InquiryDetail Aggregate, Required

Records data that allows the customer to specify identifying information about the subject being inquired, e.g., the DUNS Number, the address, the telephone number.

OrderProductRequest. OrderProductRequestDetail. InquiryDetail. DUNSNumber string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional

The D-U-N-S Number is D&B's identification number, which provides unique identification of this organization, in accordance with the Data Universal Numbering System (D-U-N-S).

OrderProductRequest. OrderProductRequestDetail. InquiryDetail. SubjectID string, up to 15 chars, Optional

A number uniquely identifying the inquired subject within the D&B Worldwide Network.

OrderProductRequest. OrderProductRequestDetail. InquiryDetail. CountryISOAlpha2Code string, at least 2 chars up to 2 chars, Optional

The two-letter country code, defined in the ISO 3166-1 scheme published by International Organization for Standardization (ISO)identifying the country of the inquired subject.

OrderProductRequest. OrderProductRequestDetail. InquiryDetail. PrincipalIdentificationNumberDetail Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of several different identifiers issued by organizations to uniquely identify the principal. The issuing organization may be a Registration Authority, Government Department or Commercial Enterprise, e.g., the Social Security Administration department.

OrderProductRequest. OrderProductRequestDetail. InquiryDetail. PrincipalIdentificationNumberDetail @DNBCodeValue Attribute
OrderProductRequest. OrderProductRequestDetail. InquiryDetail. PrincipalIdentificationNumberDetail @DNBCodeTableNumber Attribute
OrderProductRequest. OrderProductRequestDetail. InquiryDetail. PrincipalIdentificationNumberDetail @TypeText Attribute
OrderProductRequest. OrderProductRequestDetail. InquiryDetail. PrincipalIdentificationNumberDetail. PrincipalIdentificationNumber string, Optional

A number assigned by an external body or by D&B which either uniquely identifies or helps to identify an individual.

End: OrderProductRequest. OrderProductRequestDetail. InquiryDetail. PrincipalIdentificationNumberDetail /Aggregate
End: OrderProductRequest. OrderProductRequestDetail. InquiryDetail /Aggregate
OrderProductRequest. OrderProductRequestDetail. ProductSpecification Aggregate, Required

Records data that allows the customer to specify the details of the requested product. This may include details such as the identifier of the product, the language in which the product needs to be rendered, the format in which the product needs to be rendered.

OrderProductRequest. OrderProductRequestDetail. ProductSpecification. DNBProductID string, Optional

An alphanumeric string that uniquely identifies the product being requested.

OrderProductRequest. OrderProductRequestDetail. ProductSpecification. LanguagePreferenceCode integer, up to 7 digits, Optional

A D&B code value that defines the language in which the customer wants this product to be rendered.

OrderProductRequest. OrderProductRequestDetail. ProductSpecification. CharacterSetPreferenceCode integer, up to 7 digits, Optional

A D&B code value denoting the set of graphic symbols (e.g., alphabet letter, pictograph) in which the product is to be rendered, e.g., Unicode.

OrderProductRequest. OrderProductRequestDetail. ProductSpecification. ProductFormatPreferenceCode integer, up to 7 digits, Optional
OrderProductRequest. OrderProductRequestDetail. ProductSpecification. TradeUpIndicator boolean, Optional

When 'true' indicates that the customer has requested that D&B return the data for the Headquarters when the requested organization is a Branch. When 'false' indicates that the customer has not requested that D&B return the data for the Headquarters when the requested organization is a Branch; however as this is the assumed condition there is no requirement to create this tag to represent this fact. Note: There are D&B WorldWide Network operations where the Headquarters information will be returned automatically, regardless of the customer request.

OrderProductRequest. OrderProductRequestDetail. ProductSpecification. OrderReasonCode

integer, up to 7 digits, Optional

Possible values: 6332 [Credit Decision]; 6333 [Assessment of credit solvency for intended business connection]; 6334 [Assessment of credit solvency for ongoing business connection]; 6335 [Debt Collection]; 6336 [Commercial Credit Insurance]; 6337 [Insurance Contract]; 6338 [Leasing Agreement]; 6339 [Rental Agreement]

End: OrderProductRequest. OrderProductRequestDetail. ProductSpecification /Aggregate
OrderProductRequest. OrderProductRequestDetail. ArchiveDetail Aggregate, Optional
OrderProductRequest. OrderProductRequestDetail. ArchiveDetail. ArchiveProductOptOutIndicator boolean, Optional

When 'true' indicates that the product being ordered is not to be stored. When 'false' indicates that the product being ordered is to be stored; however as this is the assumed condition there is no requirement to create this tag to represent this fact.

OrderProductRequest. OrderProductRequestDetail. ArchiveDetail. ExtendArchivePeriodIndicator boolean, Optional

When 'true' the duration to archive the data is to be extended. Note: There is an additional cost for extending the archival period of the data purchased. When 'false' the duration to archive the data is not to be extended.

OrderProductRequest. OrderProductRequestDetail. ArchiveDetail. PortfolioAssetContainerID long, Optional

A number used to uniquely identify the location where this product is to be stored.

End: OrderProductRequest. OrderProductRequestDetail. ArchiveDetail /Aggregate
OrderProductRequest. OrderProductRequestDetail. InquiryReferenceDetail Aggregate, Optional

Records data that allows the customer to specify information to be linked to the request in order to support subsequent order reconciliation.

OrderProductRequest. OrderProductRequestDetail. InquiryReferenceDetail. CustomerReferenceText string, up to 240 chars, Optional (Up to 5x)

A freeform reference string provided by the customer to be linked to the product in order to support subsequent order reconciliation.

OrderProductRequest. OrderProductRequestDetail. InquiryReferenceDetail. CustomerBillingEndorsementText string, at least 1 chars, up to 240 chars, Optional

Text that is filled in by customer and commonly contains requesting individual or department name, or customer's own account/reference number and/or name for the case on which the product was provided.This text is a reference used during the billing process.

End: OrderProductRequest. OrderProductRequestDetail. InquiryReferenceDetail /Aggregate
End: OrderProductRequest. OrderProductRequestDetail /Aggregate
End: OrderProductRequest /Aggregate

Endpoint

Use the following endpoint with the downloadable WSDL to request this product.

Endpoint (CustomProduct)
https://direct.dnb.com/CustomProduct/V{version}

Testing

This operation is currently unavailable in the D&B Direct sandbox (test) environment.

Trials

When conducting testing in the production environment during a trial period, product requests will be limited to the local market of the customer.

Production

A set of D-U-N-S Numbers is available to D&B Direct 2.0 customers for performing non-billable transactions in the production environment.

Product Response

While data for a particular company may not contain values for each of the business elements, there may be items that are considered by D&B to be "essential" to yield the maximum benefit of a data layer. If any of these essential elements do not contain a value for a particular company, a PD005 response code will be returned, and your organization will not incur a usage credit for the request.

For all codified data delivered by D&B Direct, the response package will include the decoded text value as a data element with the code value attached as an attribute. Refer to the Reference Data Service for access to the D&B standard code tables.

Specification

The following is a list of the possible data fields returned by this operation in the XML response. Samples are provided for testing successful and failed retrieval, and to demonstrate the basic layout of a response. The data returned in samples may not represent actual values that this feature will deliver.

The specific data fields pre-configured for each custom data product will located in the response package as noted.

NOTE: The D-U-N-S Number returned in the response will be a nine-digit zero-padded, numeric value.

Refer to the Financial Statements page for more information on the following:

  • Enhanced Financial Statements (US only) are available to customers, providing the latest, most granular data. Customers may see up to three types of Financial Statements.
  • Depreciation and Long Term Debt data is returned under various sections of the financial statements for different countries.
Name Characteristics
OrderProductResponse Aggregate
OrderProductResponse @ServiceVersionNumber Attribute
OrderProductResponse. TransactionDetail Aggregate, Required

Records information necessary to process a particular request. Examples of a request is the ordering of a product.

OrderProductResponse. TransactionDetail. ApplicationTransactionID string up to 64 chars., Optional

A number assigned by the calling application to uniquely identify this request.

OrderProductResponse. TransactionDetail. ServiceTransactionID string up to 64 chars., Required

A number assigned by the D&B service to uniquely identify this transaction.

OrderProductResponse. TransactionDetail. TransactionTimestamp DateTimestamp, Required

The date and time when this request was submitted or the date and time when the requesting intermediary, such as a workflow manager or service bus, sent the message to the D&B function, i.e., the date and time when the xml document was created by the requesting intermediary.

End: OrderProductResponse. TransactionDetail /Aggregate
OrderProductResponse. TransactionResult Aggregate, Required

An aggregate that can repeat multiple times to record the different outcomes of the transaction.

OrderProductResponse. TransactionResult. SeverityText string up to 16 chars., Required

Text that records the criticality of the outcome, e.g., Information, Warning, Error, Fatal.

OrderProductResponse. TransactionResult. ResultID string up to 32 chars., Required

An alphanumeric string that uniquely identifies the outcome of the transaction.

OrderProductResponse. TransactionResult. ResultText string up to 512 chars., Optional

Text that explains the outcome of the transaction.

OrderProductResponse. TransactionResult. ResultMessage Aggregate, Optional (Array)

An aggregate that can repeat multiple times to record textual data that expands on the ResultID and ResultText to provide additional information to the user regarding the status of the transaction. If the status implies that there is a problem this may also provide guidance to the user on how to address it.

OrderProductResponse. TransactionResult. ResultMessage. ResultDescription string up to 512 chars., Required

Text that describes the additional information regarding the outcome of the transaction.

End: OrderProductResponse. TransactionResult. ResultMessage /Aggregate
End: OrderProductResponse. TransactionResult /Aggregate
OrderProductResponse. OrderProductResponseDetail Aggregate, Optional

Records the data being returned to the customer as a result of a product request.

OrderProductResponse. OrderProductResponseDetail. InquiryDetail Aggregate, Required

Records data that allows the customer to specify identifying information about the subject being inquired, e.g., the DUNS Number, the address, the telephone number.

OrderProductResponse. OrderProductResponseDetail. InquiryDetail. DUNSNumber string up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Optional

The D&B's identification number, which provides unique identification of the inquired organization, in accordance with the Data Universal Numbering System (D-U-N-S).

OrderProductResponse. OrderProductResponseDetail. InquiryDetail. SubjectID string up to 15 chars., Optional

A number uniquely identifying the inquired subject within the D&B Worldwide Network.

OrderProductResponse. OrderProductResponseDetail. InquiryDetail. CountryISOAlpha2Code string at least 2 chars. up to 2 chars., Optional

The two-letter country code, defined in the ISO 3166-1 scheme published by International Organization for Standardization (ISO)identifying the country of the inquired subject.

OrderProductResponse. OrderProductResponseDetail. InquiryDetail. PrincipalIdentificationNumberDetail Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of several different identifiers issued by organizations to uniquely identify the principal. The issuing organization may be a Registration Authority, Government Department or Commercial Enterprise, e.g., the Social Security Administration department.

OrderProductResponse. OrderProductResponseDetail. InquiryDetail. PrincipalIdentificationNumberDetail @DNBCodeValue Attribute
OrderProductResponse. OrderProductResponseDetail. InquiryDetail. PrincipalIdentificationNumberDetail @DNBCodeTableNumber Attribute
OrderProductResponse. OrderProductResponseDetail. InquiryDetail. PrincipalIdentificationNumberDetail @TypeText Attribute
OrderProductResponse. OrderProductResponseDetail. InquiryDetail. PrincipalIdentificationNumberDetail. PrincipalIdentificationNumber string, Optional

A number assigned by an external body or by D&B which either uniquely identifies or helps to identify an individual.

End: OrderProductResponse. OrderProductResponseDetail. InquiryDetail. PrincipalIdentificationNumberDetail /Aggregate
End: OrderProductResponse. OrderProductResponseDetail. InquiryDetail /Aggregate
OrderProductResponse. OrderProductResponseDetail. Product Aggregate, Required

Records data about the product ordered by the customer and data about the organization on which the customer has placed this order.

OrderProductResponse. OrderProductResponseDetail. Product. DNBProductID string up to 64 chars., Optional

An alphanumeric string that uniquely identifies this product.

OrderProductResponse. OrderProductResponseDetail. Product. LanguageCode integer up to 7 digits., Optional

A D&B code value that defines the language in which the requested product is fulfilled.

OrderProductResponse. OrderProductResponseDetail. Product. Organization Aggregate, Required

Records data about an organization, a legal or commercial entity established to provide products and/or services in the marketplace or to the community.

Contents of "Organization PCM Aggregate Contents of "Organization PCM Aggregate

Possible values: Contents of "Organization PCM Aggregate

END: OrderProductResponse. OrderProductResponseDetail. Product. Organization /Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. ArchiveDetail Aggregate, Optional

Records data about the archival details of the product requested.

OrderProductResponse. OrderProductResponseDetail. Product. ArchiveDetail. PortfolioAssetID PortfolioAssetIDType, Optional

A number used to uniquely identify this product in the location where it is stored.

OrderProductResponse. OrderProductResponseDetail. Product. ArchiveDetail. PortfolioAssetContainerID long, Optional

A number used to uniquely identify the location where this product is stored.

End: OrderProductResponse. OrderProductResponseDetail. Product. ArchiveDetail /Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. CopyrightNoticeText string up to 128 chars., Optional

Text that specifies the underlying claim to copyright ownership of this product.

End: OrderProductResponse. OrderProductResponseDetail. Product /Aggregate
OrderProductResponse. OrderProductResponseDetail. InquiryReferenceDetail Aggregate, Optional

Records data that allows the customer to specify information to be linked to the request in order to support subsequent order reconciliation.

OrderProductResponse. OrderProductResponseDetail. InquiryReferenceDetail. CustomerReferenceText string up to 240 chars., Optional(Up to 5x)

A freeform reference string provided by the customer to be linked to the product in order to support subsequent order reconciliation.

OrderProductResponse. OrderProductResponseDetail. InquiryReferenceDetail. CustomerBillingEndorsementText string at least 1 chars. up to 240 chars., Optional

Text that is filled in by customer and commonly contains requesting individual or department name, or customer's own account/reference number and/or name for the case on which the product was provided.This text is a reference used during the billing process.

End: OrderProductResponse. OrderProductResponseDetail. InquiryReferenceDetail /Aggregate
End: OrderProductResponse. OrderProductResponseDetail /Aggregate
End: OrderProductResponse /Aggregate

Legend: [C] = may be included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitored using an aggregate or attribute XPath.

Lists of possible values (when present) are subject to change. Additional values not presented in this documentation may be delivered in the response and should be anticipated in any implementation.

Empty/NULL Values

A NULL returned for an element indicates that the information was not provided to D&B when the related data items were collected. The absence of a value for a particular item should not be considered indicative of any implied value (e.g., NULL for a boolean indicator is NOT the same as a value of 'false').

NOTE: There may be additional request and/or response elements specified in the WSDL that are not applicable for D&B Direct customers. Data elements that are not listed on this page are currently unused by this operation.

Response Codes & Error Handling

Successful service requests will return a CM000 response code in the TransactionResult ResultID field. Otherwise, one of the D&B Direct standard response codes will be returned.

This operation may return the following response codes: CM001-CM005, CM007-CM012, CM014, CM017, CM018, PD001, PD003, PD005, PD006, PD015, PD016,PD019 and SC001-SC012.

IMPORTANT: PD006 code - Applicable only for US/CA cases when TradeUpIndicator="true" for Risk packets.

D&B Direct 2.0 API requests are provided on a metered basis; and may require entitlement prior to use in the production environment. In addition, a concurrency limit (QPS) is monitored to ensure that it is not exceeded. An error code will be returned in the event that a transaction is throttled.

Qualified usage (e.g., a successful response) is tracked and billed according to the terms & conditions of the customer's contract. The response codes CM000, CM010, PD002 and PD015 are considered successful. A built-in feature exists to prevent duplicate billing when multiple successful requests with the same D-U-N-S Number and product code are submitted on the same calendar day (which is based on Eastern Standard Time [GMT-5]).

Retrieving Archived Copies

An option exists to retain the results from all successful requests for this product in a Product Request Archive, which may be retrieved without incurring additional usage charges.

NOTE: The default value for ArchiveProductOptOutIndicator is 'true', indicating that the request will NOT be automatically archived.

Business Elements

The business elements returned in a custom product vary based on customer selection.

Exception: Custom Product requests will not return the standard elements for the company requested. These elements may be included, by request, during the configuration process.

When any of the business elements that were designated as "required" when the Custom Product was configured do not contain a value for a particular company, an error code will be returned, and your organization will not incur a usage credit for the request.

Product Notes

D&B Sales Associates may be provided lists of either Business Element or Response Data Field items (the latter is preferred) for pricing and configuration of up to six Custom Products. Customers may also designate fields in a given Custom Product to be "required." When any of these required fields (for a given D-U-N-S Number) are not available, the request will return an error code.

Throughout the D&B Direct documentation, Business Element and Response Data Field items will be designated with a [C] if they may be included in a Custom Product.

For data items where previous calculations are available (e.g. Financial Stress Score and Commercial Credit Score), be sure to mention the version number to the D&B Sales Associate if an alternate calculation is required.

Once configured, the D&B Sales Associate will provide a Product Code designated for the new Custom Product. Each custom product configuration is only available to the customer account to which it is assigned.

Monitoring Custom Products

To determine which data fields within a custom product will trigger a Monitoring Change Notice, issue a request to the GetProductCatalog function in the Product Catalog Serviceand inspect the MonitorableElementDetail list that is returned.