Research - State/Province
| Products | D&B Direct 2.0 |
| Product Code(s) | IND_ADV |
| Level(s) | Standard |
| Monitoring Available | No |
| Interface | SOAP |
| WSDL | download |
| Format(s) | XML |
| Service | Industry |
| Operation | OrderProduct |
| {version} | 4.0 |
| Initial Release | October 3, 2013 |
State & Province Profiles deliver industry and economic insight, employment and real estate trends, and valuable resource links for each of the fifty US States, Washington, D.C. and ten Canadian Provinces.
Update History
- February 18, 2022 (ALL SOAP & REST): Defect fix to resolve discrepancies in the Hoovers Industry Code Type (25538) data provided via Industry Product Service.
- January 07, 2022 (ALL SOAP & REST): Defect fix to return proper response as per schema for FacsimileNumber element.
- August 21, 2015 (v4.0 SOAP & REST): WSDL issues corrected.
- May 29, 2015 (v3.1 SOAP & REST): The enumeration value "FastFact" is included to the request schema element ChapterName.
- May 29, 2015 (v3.1 SOAP & REST): The enumeration value "FastFact" is included to the request schema element ChapterName.
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 this feature, you will be required to supply either a two-letter US state or Canadian province abbreviation, the corresponding country code, and the product code (IND_ADV). Both abbreviations are case-sensitive.
Global Availability
The IND_ADV data layer is available for businesses domiciled in the following countries:
| Country | ISO Code |
|---|---|
| United States of America | US |
| Canada | CA |
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 "Industry Profile - Advanced Search" 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
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ind="http://services.dnb.com/IndustryProductServiceV2.0">
<soapenv:Header>
<wsse:Security soapenv:mustUnderstand="0" 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-11">
<wsse:Username>MyUserName</wsse:Username>
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">MyPassword</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
</soapenv:Header>
<soapenv:Body>
<ind:OrderProductRequest ServiceVersionNumber="">
<TransactionDetail>
<ApplicationTransactionID>Unique Advanced</ApplicationTransactionID>
<SubmittingOfficeID>333</SubmittingOfficeID>
</TransactionDetail>
<OrderProductRequestDetail>
<InquiryDetail>
<Location>
<ISOCountrySubDivisionCode>CA-ON</ISOCountrySubDivisionCode>
</Location>
</InquiryDetail>
<ProductSpecification>
<DNBProductID>IND_ADV</DNBProductID>
<LanguagePreferenceCode>39</LanguagePreferenceCode>
<ProfileChapterName>BusinessChallenges</ProfileChapterName>
</ProductSpecification>
<InquiryReferenceDetail>
<CustomerReferenceText>Industry Profile – Advanced Search</CustomerReferenceText>
<CustomerBillingEndorsementText>TC0523-12</CustomerBillingEndorsementText>
</InquiryReferenceDetail>
</OrderProductRequestDetail>
</ind: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 | date & time, 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, Required 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. Location | Aggregate, Optional Records the components of a location for which the business activity profile information is requested. |
| OrderProductRequest. OrderProductRequestDetail. InquiryDetail. Location. ISOCountrySubDivisionCode | string, up to 6 chars, Required Code represented in ISO 3166-2 scheme defining the name of a principal subdivision (e.g., province or state) of a country coded in ISO 3166-1; e.g., US-NJ represents the state New Jersey in United States, CA-ON represents the province Ontario in Canada. The first part is the ISO 3166-1 alpha-2 code of the country; The second part is a string of up to three alphanumeric characters, which is usually obtained from national sources and stems from coding systems already in use in the country concerned, but may also be developed by the ISO itself. Possible values: Supports US & Canada Sates only. Refer "ISO 3166-2:US" and "ISO 3166-2:CA" Tables for . |
| End: OrderProductRequest. OrderProductRequestDetail. InquiryDetail. Location | /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 | Element |
| 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. |
| End: OrderProductRequest. OrderProductRequestDetail. ProductSpecification | /Aggregate |
| OrderProductRequest. OrderProductRequestDetail. ArchiveDetail | Aggregate, Optional |
| OrderProductRequest. OrderProductRequestDetail. ArchiveDetail. ArchiveProductOptOutIndicator | boolean, Optional |
| 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 |
| 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 char, 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.
| SOAP (Industry) | |
|---|---|
| https://direct.dnb.com/IndustryProduct/V{version} | WSDL |
Testing
The following parameters may be used for D&B Direct 2.0 developer sandbox requests to retrieve successful responses. The data returned from sandbox requests may not represent actual values that this feature will deliver.
| Product | Test Parameter(s) |
|---|---|
| Research - State/Province | ISOCountrySubDivisionCode:US-NJ |
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.
NOTE: The D-U-N-S Number returned in the response will be a nine-digit zero-padded, numeric value.
(missing or bad snippet)| 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 | dateTime, 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. ResultMessageID | string, up to 30 chars, Optional An alphanumeric string that uniquely identifies the additional information regarding the outcome of the transaction. |
| OrderProductResponse. TransactionResult. ResultMessage. ResultDescription | string, up to 512 chars, Required Text that describes the additional information regarding the outcome of the transaction. |
| OrderProductResponse. TransactionResult. ResultMessage. NonSpecificDataProviderText | string, up to 30 chars, Optional Text that describes, in general terms, the source from which the Result Message data was originally obtained by D&B; e.g. Credit Bureau. |
| 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. Location | Aggregate, Optional Records the components of a location for which the business activity profile information is requested. |
| OrderProductResponse. OrderProductResponseDetail. InquiryDetail. Location. ISOCountrySubDivisionCode | string, up to 6 chars, Required Code represented in ISO 3166-2 scheme defining the name of a principal subdivision (e.g., province or state) of a country coded in ISO 3166-1; e.g., US-NJ represents the state New Jersey in United States, CA-ON represents the province Ontario in Canada. The first part is the ISO 3166-1 alpha-2 code of the country; The second part is a string of up to three alphanumeric characters, which is usually obtained from national sources and stems from coding systems already in use in the country concerned, but may also be developed by the ISO itself. |
| End: OrderProductResponse. OrderProductResponseDetail. InquiryDetail. Location | /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, Required |
| 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. IndustryProfile | Aggregate, Optional Records the market analysis information on the industries as recorded by the data provider. The market analysis information may include critical analysis, statistics and forecasts to help your engage key prospects, coach key clients, and deepen customer relationships. |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile | Aggregate, Optional Records the market analysis information on locations as recorded by the data provider. The market analysis information may include deliver industry and economic insight, employment and real estate trends, and valuable resource links for the location. |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail | Aggregate, Optional (Array) An entry loop which records the market analysis information on a location as recorded by the data provider. The market analysis information may include deliver industry and economic insight, employment and real estate trends, and valuable resource links for the location. |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. Location | Aggregate, Required Records the address details for the location for which this profile information is returned. |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. Location. TerritoryName | string, Optional The name of the locally governed area which forms part of a centrally governed nation as received by D&B. Clarification Note: As a guiding principle this is a geographic area which could theoretically exist as a separate nation. In the U.S. this would be a State. In the UK this would be one of the Home Nations. NOTE: Deprecated |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. Location. ISOCountrySubDivisionCode | string, up to 6 chars, Optional Code represented in ISO 3166-2 scheme defining the name of a principal subdivision (e.g., province or state) of a country coded in ISO 3166-1; e.g., US-NJ represents the state New Jersey in United States, CA-ON represents the province Ontario in Canada. The first part is the ISO 3166-1 alpha-2 code of the country; The second part is a string of up to three alphanumeric characters, which is usually obtained from national sources and stems from coding systems already in use in the country concerned, but may also be developed by the ISO itself. NOTE: Deprecated |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. Location. ImageURL | string, up to 256 chars, Optional Records the internet link of the images related to the location. NOTE: Deprecated |
| End: OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. Location | /Aggregate |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. LocationProfileChapterDetail | Aggregate, Optional (Array) An entry loop which can repeat multiple times to allow the recording of the details on the major divisions of the location profile information. |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. LocationProfileChapterDetail. ChapterName | string, up to 256 chars, Required Name of the major division of the profile information. NOTE: Deprecated |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. LocationProfileChapterDetail. ChapterContentDetail | Aggregate, Optional (Array) An entry loop which can repeat multiple times to allow the recording of the details recorded in the profile chapter. |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. LocationProfileChapterDetail. ChapterContentDetail. TitleText | string, up to 256 chars, Optional Text that records the title of the chapter content. NOTE: Deprecated |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. LocationProfileChapterDetail. ChapterContentDetail. ContentText | string, up to 5000 chars, Optional Text that records the body of the chapter content as paragraphs. NOTE: Deprecated |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. LocationProfileChapterDetail. ChapterContentDetail. KeyFactText | string, up to 720 chars, Optional (Array) Text that records the body of the chapter content as short phrases or single sentences. NOTE: Deprecated |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. LocationProfileChapterDetail. ChapterContentDetail. WebPageURL | string, up to 256 chars, Optional Records the internet link of the original chapter content. NOTE: Deprecated |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. LocationProfileChapterDetail. ChapterContentDetail. ImageURL | string, up to 256 chars, Optional Records the internet link of the images related to the chapter content. NOTE: Deprecated |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. LocationProfileChapterDetail. ChapterContentDetail. ImportanceLevel | integer, up to 3 digits, Optional A number used to identify the relative importance of this chapter compared to other chapters listed in this profile. The lower the importance level number, the more important is the chapter. NOTE: Deprecated |
| End: OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. LocationProfileChapterDetail. ChapterContentDetail | /Aggregate |
| End: OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. LocationProfileChapterDetail | /Aggregate |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. RelatedIndustryCode | Aggregate, Optional (Array) An entry loop which can repeat multiple times to allow the recording of several business activities that are related with the requested location. These industry codes are recorded using standardized coding schemes such as European NACE and U.S. Standard Industry Classifications (SIC). |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. RelatedIndustryCode @DNBCodeValue | Attribute Possible values: 25838 [D&B Hoovers Industry Code] |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. RelatedIndustryCode @TypeText | Attribute Possible values: 25838 [D&B Hoovers Industry Code] |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. RelatedIndustryCode. IndustryCode | string, up to 16 chars, Required An alphanumeric value identifying a business activity based on the scheme specified by the typeText. For instance, 1611 represents the highway and street construction industry in the U.S. SIC (Standard Industrial Classification) system. Clarification Note: These are generally external codes created by an external authoritative body, like the U.S. Office of Management and Budget (OMB), but D&B may have created extensions to more precisely define an activity, as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC). NOTE: Deprecated |
| OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. RelatedIndustryCode. IndustryCodeDescription | string, up to 256 chars, Optional (Array) Text that describes the business activity based on the scheme specified by the attribute typeText. E.g., 'highway and street construction' is the description of industry code 1611 in the U.S. SIC (Standard Industrial Classification) system. NOTE: Deprecated |
| End: OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail. RelatedIndustryCode | /Aggregate |
| End: OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile. LocationProfileDetail | /Aggregate |
| End: OrderProductResponse. OrderProductResponseDetail. Product. LocationProfile | /Aggregate |
| OrderProductResponse. OrderProductResponseDetail. Product. ArchiveDetail | Aggregate, Optional |
| OrderProductResponse. OrderProductResponseDetail. Product. ArchiveDetail. PortfolioAssetID | PortfolioAssetIDType, Required |
| OrderProductResponse. OrderProductResponseDetail. Product. ArchiveDetail. PortfolioAssetContainerID | long, Optional |
| OrderProductResponse. OrderProductResponseDetail. Product. ArchiveDetail. ExtendedArchiveIndicator | boolean, Optional When 'true' the duration to archive the data has been extended. When 'false' the duration to archive the data was not extended; however as this is the assumed condition there is no requirement to create this tag to represent this fact. |
| End: OrderProductResponse. OrderProductResponseDetail. Product. ArchiveDetail | /Aggregate |
| 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 char, 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
While D&B Direct uses a product canonical naming model in the request/response, many customers may be more familiar with the following business element labels.
| Name | Description |
|---|---|
| Location Profile Chapter Name (Industry Report) | PCM XPath: //LocationProfile/ LocationProfileDetail/ LocationProfileChapterDetail/ ChapterName |
| Location Profile Key Fact (Industry Report) | PCM XPath: //LocationProfile/ LocationProfileDetail/ LocationProfileChapterDetail/ ChapterContentDetail/ KeyFactText |
| Location Profile Paragraph Details (Industry Report) | Text of the First Research chapter paragraph PCM XPath: //LocationProfile/ LocationProfileDetail/ LocationProfileChapterDetail/ ChapterContentDetail/ ContentText |
| Location Profile Paragraph Images URL (Industry Report) | Text that records the location of images referenced by this Web-based content. PCM XPath: //LocationProfile/ LocationProfileDetail/ LocationProfileChapterDetail/ ChapterContentDetail/ ImageURL |
| Location Profile Paragraph Site URL (Industry Report) | Text that records the location of this Web-based content. PCM XPath: //LocationProfile/ LocationProfileDetail/ LocationProfileChapterDetail/ ChapterContentDetail/ WebPageURL |
| Location Profile Paragraph Title (Industry Report) | PCM XPath: //LocationProfile/ LocationProfileDetail/ LocationProfileChapterDetail/ ChapterContentDetail/ TitleText |
| Location Profile Related Industry Code | An alphanumeric value identifying a business activity based on the scheme specified by the description. For example, 1611 represents the highway and street construction industry in the U.S. SIC (Standard Industrial Classification) system. PCM XPath: //LocationProfile/ LocationProfileDetail/ RelatedIndustryCode/ IndustryCode |
| Location Profile Related Industry Description | Text that describes the business activity based on the scheme specified by the code. For example, 'highway and street construction' is the description of industry code 1611 in the U.S. SIC (Standard Industrial Classification) system. PCM XPath: //LocationProfile/ LocationProfileDetail/ RelatedIndustryCode/ IndustryCodeDescription |
| Location Profile Territory Code (Industry Report) | A code the name of a principal subdivision (e.g., province or state) of a country; e.g., US-NJ represents the state New Jersey in United States, CA-ON represents the province Ontario in Canada. PCM XPath: //LocationProfile/ LocationProfileDetail/ Location/ ISOCountrySubDivisionCode |
| Location Profile Territory Image URL (Industry Report) | Text that records the location of images referenced by this Web-based content. PCM XPath: //LocationProfile/ LocationProfileDetail/ Location/ ImageURL |
| Location Profile Territory or State Name (Industry Report) | Text recording the name of the locally governed area which forms part of a centrally governed nation as received by D&B. Clarification Note: As a guiding principle this is a geographic area which could theoretically exist as a separate nation. In the U.S PCM XPath: //LocationProfile/ LocationProfileDetail/ Location/ TerritoryName |
The preceding list is not presented in the order, nor manner, in which the information is packaged and delivered via the D&B Direct API. 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.
Product Notes
Industry profiles are updated quarterly and comprehensively reviewed once a year. News articles and most statistical data are updated monthly. All industry forecast numbers come from the INFORUM modeling data base, which is built on historic data derived from official government figures.
- © Dun & Bradstreet, Inc. 2019 – 2024. All rights reserved.