Loading

Direct 2.0
Collapse

Know Your Vendor - Global Data

Also known as Global Supplier Risk.

Product(s)D&B Direct 2.0
Product Code(s)SR_GLB
Level(s)Standard
Monitoring AvailableYes
InterfaceREST
MethodGET
Format(s)JSON
ServiceCustomProduct
{version}3.0
3.0 Released OnAugust 21, 2015

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.

The Global Supplier Risk packet provides key supplier risk data for vendor management in the enterprise. It combines D&B’s financial and supplier risk scores with public filings information. When used with D&B’s in-depth company profile data (not included), this product provides a comprehensive view into a supplier’s risk propensity.

See the Predictive Analytics page for more information on Dun & Bradstreet's risk scores.

Update History

  • 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 December 14, 2018.

Overview

When requesting this feature, a valid D&B D-U-N-S Number for a company and the appropriate product code will be required. For improved performance, include its country code.

A trade up option exists to request data for the headquarters when the requested organization is a branch.

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

Global Availability

The SR_GLB data layer is available for businesses domiciled in the following countries:

CountryISO Code
United States of AmericaUS
BelgiumBE
FranceFR
GermanyDE
ItalyIT
NetherlandsNL
PortugalPT
SpainES
United KingdomGB
AustraliaAU
New ZealandNZ
AndorraAD
AnguillaAI
Antigua & BarbudaAG
ArubaAW
BahamasBS
BarbadosBB
BelizeBZ
BermudaBM
BoliviaBO
British Virgin IslandsVG
CanadaCA
Cayman IslandsKY
ChileCL
ColombiaCO
Costa RicaCR
DenmarkDK
DominicaDM
Dominican RepublicDO
EcuadorEC
El SalvadorSV
Faero IslandsFO
FinlandFI
GreenlandGL
GrenadaGD
GuatemalaGT
GuyanaGY
HaitiHT
HondurasHN
IrelandIE
JamaicaJM
JapanJP
LuxembourgLU
MexicoMX
MonacoMC
MontserratMS
Netherlands AntillesAN
Bonaire, Sint Eustatius And SabaBQ
CuraçaoCW
Sint Maarten (dutch)SX
NicaraguaNI
NorwayNO
PanamaPA
Saint Kitts & NevisKN
Saint LuciaLC
Saint VincentVC
San MarinoSM
SurinameSR
SwedenSE
Taiwan (republic of China)TW
Trinidad And TobagoTT
Turks And CaicosTC
VenezuelaVE
AfghanistanAF
AlbaniaAL
AlgeriaDZ
American SamoaAS
AngolaAO
ArgentinaAR
ArmeniaAM
AustriaAT
AzerbaijanAZ
BahrainBH
BangladeshBD
Benin, Peoples Republic ofBJ
BhutanBT
Bosnia And HerzegovinaBA
BotswanaBW
BrazilBR
BruneiBN
BulgariaBG
Burkina FasoBF
Burma (myanmar)MM
BurundiBI
BelarusBY
Kampuchea (prev. Cambodia)KH
CameroonCM
Cape Verde, Republic ofCV
Central Africa RepublicCF
Chad, Republic ofTD
China, Peoples Republic ofCN
Christmas IslandCX
Comoros RepublicKM
Congo Democratic RepublicCD
Cook IslandsCK
CroatiaHR
CyprusCY
Turkish Republic of Northern CyprusXT
Czech RepublicCZ
DjiboutiDJ
EgyptEG
Equatorial GuineaGQ
EritreaER
EstoniaEE
EthiopiaET
Falkland IslandsFK
FijiFJ
French GuianaGF
French Polynesia/tahitiPF
Gabon RepublicGA
GambiaGM
GeorgiaGE
GhanaGH
GibraltarGI
GreeceGR
GuadeloupeGP
GuamGU
Guinea BissauGW
Guinea, Republic ofGN
Hong KongHK
HungaryHU
IcelandIS
IndiaIN
IndonesiaID
IranIR
IraqIQ
IsraelIL
Ivory Coast/cote D'ivoireCI
JordanJO
KazakhstanKZ
KenyaKE
KiribatiKI
Korea, Republic ofKR
KuwaitKW
KyrgyzstanKG
LaosLA
LatviaLV
LebanonLB
LesothoLS
LiberiaLR
LibyaLY
LiechtensteinLI
LithuaniaLT
MacauMO
MacedoniaMK
MadagasgarMG
MalawiMW
MalaysiaMY
MaldivesMV
MaliML
MaltaMT
Marianas IslandsMP
Marshall IslandsMH
MartiniqueMQ
MauritaniaMR
MauritiusMU
MoldovaMD
MontenegroME
MoroccoMA
MozambiqueMZ
NamibiaNA
NauruNR
NepalNP
New CaledoniaNC
NigerNE
NigeriaNG
Norfolk IslandNF
OmanOM
PakistanPK
Papua New GuineaPG
ParaguayPY
PhilippinesPH
PolandPL
QatarQA
Reunion IslandRE
RomaniaRO
Russian FederationRU
RwandaRW
Saint HelenaSH
Saint Pierre Et MiquelonPM
Sao Tome & PrincipeST
Saudi ArabiaSA
SenegalSN
SerbiaRS
SeychellesSC
Sierra LeoneSL
SingaporeSG
SlovakiaSK
SloveniaSI
Solomon IslandsSB
SomaliaSO
South AfricaZA
Sri LankaLK
SudanSD
South SudanSS
SwazilandSZ
SwitzerlandCH
SyriaSY
TajhikstanTJ
TanzaniaTZ
ThailandTH
TogoTG
Tokelau IslandsTK
TongaTO
TunisiaTN
TurkeyTR
TurkmenistanTM
TuvaluTV
UgandaUG
UkraineUA
United Arab EmiratesAE
UruguayUY
UzbekistanUZ
VanuatuVU
VietnamVN
Western SamoaWS
YemenYE
ZambiaZM
ZimbabweZW
CongoCG
Puerto RicoPR
Holy See (vatican City State)VA
Serbia & MontenegroCS
KosovoXK
Micronesia, Federated States ofFM
Timor-LesteTL 

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 "D&B Supplier Evaluation Risk Rating" 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.
Sample Request
GET https://direct.dnb.com/V3.0/organizations/804735132/products/SR_GLB
Authorization: <My Token>

Specification

Name Characteristics
{version} Element
ApplicationTransactionID string, up to 64 chars, Optional

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

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.

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.

{DUNS} 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).

{subjectID} string, up to 15 chars, Optional

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

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.

PrincipalIdentificationNumberTypeCode Element
PrincipalIdentificationNumber string, Optional

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

{productID} string, Required

An alphanumeric string that uniquely identifies the product being requested.

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.

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.

ProductFormatPreferenceCode integer, up to 7 digits, Optional
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.

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]

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.

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.

PortfolioAssetContainerID long, Optional

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

CustomerReferenceText string, up to 240 chars, Optional

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

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.

Endpoint

Use the following endpoint for requesting this product. The {version} is dependent on the underlying service delivering the product.

NOTE: While "organizations" is part of this endpoint, there is no service by this name. Many D&B Direct calls have a similar structure; however, the {version} component is based on the SERVICE to which a given product is associated.

Endpoint (CustomProduct)
GET https://direct.dnb.com/V{version}/organizations/{DUNS}/products/{productID}

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.

NOTE: The D&B Direct REST implementation uses the BadgerFish approach for JSON with some minor variations.

Specification

The following is a list of the possible data fields returned by this operation in the JSON 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.

Sample Response
{"OrderProductResponse": {
   "@ServiceVersionNumber": "3.0",
   "TransactionDetail":    {
      "ApplicationTransactionID": "Raj",
      "ServiceTransactionID": "Id-2543005a7fe4070099850700e8b158d3-2",
      "TransactionTimestamp": "2017-11-06T06:10:31.673-05:00"
   },
   "TransactionResult":    {
      "SeverityText": "Information",
      "ResultID": "CM000",
      "ResultText": "Success"
   },
   "OrderProductResponseDetail":    {
      "InquiryDetail":       {
         "DUNSNumber": "804735132",
         "CountryISOAlpha2Code": "US"
      },
      "Product":       {
         "DNBProductID": "SR_GLB",
         "LanguageCode": 39,
         "Organization":          {
            "SubjectHeader": {"DUNSNumber": "804735132"},
            "Location": {"PrimaryAddress": [{"CountryISOAlpha2Code": "US"}]},
            "Events": {"LegalEvents":             {
               "SuitInformation": {"SuitSummary": {"OpenFilingsCount": 1}},
               "LienInformation": {"LienSummary": {"OpenFilingsCount": 1}},
               "JudgmentInformation": {"JudgmentSummary":                {
                  "OpenFilingsCount": 3,
                  "OpenFilingsAmount": {"$": 700}
               }},
               "SuitsAndOrJudgmentsIndicator": true,
               "ClaimsIndicator": true
            }},
            "OrganizationName": {"OrganizationPrimaryName": [{"OrganizationName": {"$": "Gorman Manufacturing Company, Inc."}}]},
            "OrganizationDetail":             {
               "FamilyTreeMemberRole":                [
                  {"FamilyTreeMemberRoleText":                   {
                     "@DNBCodeValue": 12775,
                     "$": "Global Ultimate"
                  }},
                  {"FamilyTreeMemberRoleText":                   {
                     "@DNBCodeValue": 12774,
                     "$": "Domestic Ultimate"
                  }},
                  {"FamilyTreeMemberRoleText":                   {
                     "@DNBCodeValue": 12773,
                     "$": "Parent"
                  }},
                  {"FamilyTreeMemberRoleText":                   {
                     "@DNBCodeValue": 12771,
                     "$": "Headquarters"
                  }}
               ],
               "OperatingStatusText":                {
                  "@DNBCodeValue": 9074,
                  "$": "Active"
               }
            },
            "Assessment":             {
               "DNBStandardRating": {"DNBStandardRating": "3A4"},
               "SupplierStabilityIndexScore":                {
                  "ClassScore": "10",
                  "ScoreCommentary":                   [
                     {"CommentaryText":                      {
                        "@DNBCodeValue": 26935,
                        "$": "The business carries a high risk Commercial Credit Score"
                     }},
                     {"CommentaryText":                      {
                        "@DNBCodeValue": 3550,
                        "$": "Evidence of suits and liens in D&B's file."
                     }},
                     {"CommentaryText":                      {
                        "@DNBCodeValue": 26936,
                        "$": "This business carries a high risk Financial Stress Score."
                     }},
                     {"CommentaryText":                      {
                        "@DNBCodeValue": 20073,
                        "$": "Special Event in the D&B Report"
                     }}
                  ]
               },
               "SupplierEvaluationRiskScore": [               {
                  "RiskScore": "6",
                  "ScoreCommentary":                   [
                     {"CommentaryText":                      {
                        "@DNBCodeValue": 26173,
                        "$": "Proportion of past due balances to total amount owing"
                     }},
                     {"CommentaryText":                      {
                        "@DNBCodeValue": 26148,
                        "$": "Total Liabilities to Net Worth influencing the score"
                     }},
                     {"CommentaryText":                      {
                        "@DNBCodeValue": 26158,
                        "$": "Business belongs to an industry with above average risk of ceasing operations or becoming inactive"
                     }},
                     {"CommentaryText":                      {
                        "@DNBCodeValue": 26172,
                        "$": "Proportion of slow payment experiences to total number of payment experiences reported"
                     }}
                  ]
               }]
            },
            "BusinessTrading":             {
               "Purchaser": {"CurrentPaydexScore": {"TwelveMonthsPaydex": [               {
                  "PaydexScore": 45,
                  "PaydexDate": {"$": "2017-11"}
               }]}},
               "PaydexScoreNorms": {"PaydexScoreIndustryNorms": [               {
                  "CalculationDate": {"$": "2017-09-06"},
                  "PaydexMedianQuartileScore": 77
               }]}
            }
         },
         "ArchiveDetail": {"PortfolioAssetID": 78755207}
      },
      "InquiryReferenceDetail":       {
         "CustomerReferenceText": ["SBCRP_17052013-01"],
         "CustomerBillingEndorsementText": "SBCRP_17052013"
      }
   }
}}
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 Element, string, up to 64 chars. , Optional

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

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

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

OrderProductResponse { TransactionDetail { TransactionTimestamp Element, 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 Element, string, up to 16 chars. , Required

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

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

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

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

Text that explains the outcome of the transaction.

OrderProductResponse { TransactionResult { ResultMessage Aggregate, Optional (Infinite)

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 Element, 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 Element, 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 Element, string, up to 15 chars. , Optional

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

OrderProductResponse { OrderProductResponseDetail { InquiryDetail { CountryISOAlpha2Code Element, 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 (Infinite)

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 Element, 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 Element, string, up to 64 chars. , Optional

An alphanumeric string that uniquely identifies this product.

OrderProductResponse { OrderProductResponseDetail { Product { LanguageCode Element, 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.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader Aggregate, Required

Records high level information about the subject such as the primary language of the subject and the primary currency in which this subject trades. When the subject is an organizantion, this may also include details such as DUNS Number.

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

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).

Monitor Path: //Organization /SubjectHeader /DUNSNumber

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location Aggregate, Optional

Records the address details for a subject. An address is the designation of a place where a subject can be located or may be communicated with, e.g., primary address, registered address, mailing address.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress Aggregate, Optional (Infinite)

An entry loop to allow the recording of a single primary or physical address of the subject in multiple languages and/or writing scripts. For an organization this is the principal address at which the organization is located. For an individual, this is the home address.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountryISOAlpha2Code Element, string, at least 2 chars. up to 2 chars. , Optional, [M+]

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

Monitor Path: //Organization /Location /PrimaryAddress

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress Aggregate
END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events Aggregate, Optional

Records the information about events that have either involved or affected the subject (usually an organization, but sometimes an individual who is an owner or principal of an organization). It covers legal events, significant events and financing events.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents Aggregate, Optional

Records legal actions targeting the subject, such as criminal proceedings, protested bills, county court judgments, receiverships, bankruptcies.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { BankruptcyIndicator Element, boolean, Optional, [M]

Monitor Path: //Organization /Events /LegalEvents /BankruptcyIndicator

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { FinancialEmbarrassmentIndicator Element, boolean, Optional, [M]

When turned ON (set to TRUE),it indicates that open bankruptcy, receivership liquidation or equivalent exist in the D&B database for this subject.When turned OFF (set to FALSE),it indicates that no open bankruptcy, receivership liquidation or equivalent exist in the D&B database for this subject.

Monitor Path: //Organization /Events /LegalEvents /FinancialEmbarrassmentIndicator

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { BankruptcyInformation Aggregate, Optional

Records the details and the summarized views about the legally declared inability of the subject to pay its creditors.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { BankruptcyInformation { Bankruptcy Aggregate, Optional (Infinite)

An entry loop which can repeat multiple times to allow the recording of details on the subject's legal declaration on it's inability to pay its creditors.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { BankruptcyInformation { Bankruptcy { FilingTypeText Element, string, up to 256 chars. , Optional

Text that describes the type of event which has been registered or recorded against the subject.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { BankruptcyInformation { Bankruptcy { FilingStatusDate Element, date , Optional, [M+]

The date when the situation recorded in the Filing Status Text occurred.

Monitor Path: //Organization /Events /LegalEvents /BankruptcyInformation /Bankruptcy

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { BankruptcyInformation { Bankruptcy { FilingStatusText Element, string, up to 256 chars. , Optional, [M+]

Monitor Path: //Organization /Events /LegalEvents /BankruptcyInformation /Bankruptcy

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { BankruptcyInformation { Bankruptcy Aggregate
END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { BankruptcyInformation Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { SuitInformation Aggregate, Optional

Records the details and the summarized views about the legal proceeding under which a plaintiff attempts to recover satisfaction or remedy from the defendant for damages.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { SuitInformation { SuitSummary Aggregate, Optional (Infinite)

Records the summarized information about the legal proceeding under which a plaintiff attempts to recover satisfaction or remedy from the defendant for damages.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { SuitInformation { SuitSummary { OpenFilingsCount Element, integer, Optional

The total number of all legal events of the type covered by this summary that has a status of Open.

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { SuitInformation { SuitSummary Aggregate
END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { SuitInformation Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { LienInformation Aggregate, Optional

Records the details and the summarized views about the legal right of a creditor to retain possession of a property from its owner pending payment of a debt or performance of some agreed-upon obligation.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { LienInformation { LienSummary Aggregate, Optional

Records summarized information regarding all forms of security interest granted over the item of property to secure the payment of a debt or performance of some other obligation as recorded on D&B database.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { LienInformation { LienSummary { OpenFilingsCount Element, integer, Optional

The total number of all legal events of the type covered by this summary that has a status of Open.

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { LienInformation { LienSummary Aggregate
END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { LienInformation Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { JudgmentInformation Aggregate, Optional

Records the details and the summarized views of formal decisions made by a court that involved the subject.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { JudgmentInformation { JudgmentSummary Aggregate, Optional

Records summarized information regarding all the decisions made by a court that involved this subject as recorded on the D&B database.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { JudgmentInformation { JudgmentSummary { OpenFilingsAmount Element, decimal, Optional

The total monetary value of all legal event of the type covered by this summary that has a status of Open.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { JudgmentInformation { JudgmentSummary { OpenFilingsCount Element, integer, Optional

The total number of all legal events of the type covered by this summary that has a status of Open.

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { JudgmentInformation { JudgmentSummary Aggregate
END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { JudgmentInformation Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { DebarmentsInformation Aggregate, Optional
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { DebarmentsInformation { DebarmentsSummary Aggregate, Required
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { DebarmentsInformation { DebarmentsSummary { TotalFilingCount Element, integer, Optional, [M]

The total number of all legal events of the type covered by this summary.

Monitor Path: //Organization /Events /LegalEvents /DebarmentsInformation /DebarmentsSummary /TotalFilingCount

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { DebarmentsInformation { DebarmentsSummary Aggregate
END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { DebarmentsInformation Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { CriminalProceedingsIndicator Element, boolean, Optional, [M]

Monitor Path: //Organization /Events /LegalEvents /CriminalProceedingsIndicator

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { SuitsAndOrJudgmentsIndicator Element, boolean, Optional, [M]

Monitor Path: //Organization /Events /LegalEvents /SuitsAndOrJudgmentsIndicator

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { ClaimsIndicator Element, boolean, Optional, [M]

Monitor Path: //Organization /Events /LegalEvents /ClaimsIndicator

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { SignificantEvents Aggregate, Optional

Records information about key events which may affect the subject. It covers such things as: natural disasters (e.g., floods, hurricane), accidents (e.g., chemical spillage), major events at the business (e.g.,change of control,business interruption, awarded contract), societal events (e.g., war, civil disturbance).

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { SignificantEvents { DisasterSpecialEventsIndicator Element, boolean, Optional, [M]

Monitor Path: //Organization /Events /SignificantEvents /DisasterSpecialEventsIndicator

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { SignificantEvents Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancialOrLegalOrSpecialEventsIndicator Element, boolean, Optional, [M]

Monitor Path: //Organization /Events /FinancialOrLegalOrSpecialEventsIndicator

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName Aggregate, Optional

Records the different names of the organization by which it is known as well as names of other organizations that have a similar name to this organization.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName Aggregate, Optional (Infinite)

An entry loop which can repeat multiple times to allow the recording of a single name by which the organization is primarily known / identified in different languages and/or writing scripts.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName { OrganizationName Element, string, up to 256 chars. , Required, [M]

Text recording a name of this organization in the specified language and/or writing script.

Monitor Path: //Organization /OrganizationName /OrganizationPrimaryName@RegisteredNameIndicator /OrganizationName

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName Aggregate
END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail Aggregate, Optional

Records fundamental information about a Subject which may vary over time.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole Aggregate, Optional (Infinite)

An entry loop that can repeat multiple times to allow the recording of various parts that the Subject plays as a member of an ownership structured family tree.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole { FamilyTreeMemberRoleText Element, string, up to 256 chars. , Optional, [M+]

Text describing the part that the Subject plays as a member of an ownership structured family tree, e.g., a branch, division, a parent, headquarters, subsidiary, global ultimate, domestic ultimate.

Monitor Path: //Organization /OrganizationDetail /FamilyTreeMemberRole

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { OperatingStatusText Element, string, up to 256 chars. , Optional, [M]

Text describing this organization's functional state / trading status, e.g. active, out of business, dormant.

Monitor Path: //Organization /OrganizationDetail /OperatingStatusText@DNBCodeValue

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment Aggregate, Optional

Records insightful and value added information on organizations, such as: - recommendations on how much credit to extend to them, - assessments of their liquidity, - concise evaluations of their performance and behavior, - predictions on the risk of conducting business with them. The predictive scores are usually calculated and assigned by D&B, but such assessments may also be recorded when assigned by third parties.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { DNBStandardRating Aggregate, Optional

Records the most current Standard D&B Rating assigned to this organization.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { DNBStandardRating { DNBStandardRating Element, string, up to 64 chars. , Required, [M]

Text that Indicates the estimated financial strength and composite credit appraisal assigned by the Business Reporter on a subjective basis at the time the report is written.

NOTE: Foreign Branch companies will be denoted as rating ‘FB’.

Monitor Path: //Organization /Assessment /DNBStandardRating /DNBStandardRating

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { DNBStandardRating Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { SupplierStabilityIndexScore Aggregate, Optional
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { SupplierStabilityIndexScore { ClassScore Element, string, up to 3 chars. , Optional, [M]

A number from 0 to 10 based on the information in DNB file.A numeric value that succinctly expresses the likelihood of risk by specifying in which risk group this organization belongs. In other words, it specifies where this organization falls in a statistical distribution of all businesses (e.g, a bell curve, a half-normal distribution).

Monitor Path: //Organization /Assessment /SupplierStabilityIndexScore /ClassScore

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { SupplierStabilityIndexScore { ScoreCommentary Aggregate, Optional (Infinite)

An entry loop which can repeat multiple times to allow the recording of primary reasons for the score.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { SupplierStabilityIndexScore { ScoreCommentary { CommentaryText Element, string, up to 256 chars. , Optional, [M]

Text that explains the primary reasons for the score.

Possible values: SCoTS Table: 173 [Rating - Reason Commentary]

Monitor Path: //Organization /Assessment /SupplierStabilityIndexScore /ScoreCommentary /CommentaryText@DNBCodeValue

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { SupplierStabilityIndexScore { ScoreCommentary Aggregate
END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { SupplierStabilityIndexScore Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { SupplierEvaluationRiskScore Aggregate, Optional (Infinite)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { SupplierEvaluationRiskScore { RiskScore Element, string, up to 16 chars. , Optional, [M]

Monitor Path: //Organization /Assessment /SupplierEvaluationRiskScore /RiskScore

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { SupplierEvaluationRiskScore { ScoreCommentary Aggregate, Optional (Infinite)

An entry loop which can repeat multiple times to allow the recording of comments about the score of this organization

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { SupplierEvaluationRiskScore { ScoreCommentary { CommentaryText Element, string, up to 256 chars. , Optional, [M]

Text that explains the primary reasons for the score.

Monitor Path: //Organization /Assessment /SupplierEvaluationRiskScore /ScoreCommentary /CommentaryText@DNBCodeValue

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { SupplierEvaluationRiskScore { ScoreCommentary Aggregate
END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { SupplierEvaluationRiskScore Aggregate
END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading Aggregate, Optional

Records references or opinions in terms of the timeliness of payment, the amounts of the transactions and the terms of sale applied to the transactions and summarized views of this data that involves the subject either as a buyer or supplier of goods or services.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser Aggregate, Optional

Records trade data where the subject is a purchaser of good or services.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore Aggregate, Optional

Records subject's current Paydex Score. A calculated element summarizing the payment habits of a subject based on trade experiences obtained from its suppliers.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore { TwelveMonthsPaydex Aggregate, Optional(Up to 2x)

An entry loop which can repeat to allow the recording of the numeric value assigned to an organization by a D&B algorithm, assessing the organization's ability to meet future obligations of a particular monetary range based on the twelve most recent months of trade experiences as of the current month, from different sources.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore { TwelveMonthsPaydex { PaydexScore Element, integerup to 3 digits. , Required, [M]

A calculated element summarizing the payment habits of a subject based on trade experiences obtained from its suppliers over the last 3 months.

Monitor Path: //Organization /BusinessTrading /Purchaser /CurrentPaydexScore /TwelveMonthsPaydex /PaydexScore

OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore { TwelveMonthsPaydex { PaydexDate Element, date , Optional

The date marking the end of the time period covered by the payment performance score.

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore { TwelveMonthsPaydex Aggregate
END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore { GlobalPaydex Aggregate, Optional(Up to 2x)

An entry loop which can repeat to allow the recording of the numeric value assigned to an organization by a D&amp;B algorithm, assessing the organization&apos;s ability to meet future obligations of a particular monetary range based on the trade experiences during a time period that cannot be specified.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore { GlobalPaydex { PaydexScore Element, integerup to 3 digits. , Required, [M]

A calculated element summarizing the payment habits of a subject based on trade experiences obtained from its suppliers over the last 3 months.

Monitor Path: //Organization /BusinessTrading /Purchaser /CurrentPaydexScore /GlobalPaydex /PaydexScore

OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore { GlobalPaydex { PaydexDate Element, date , Optional

The date marking the end of the time period covered by the payment performance score.

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore { GlobalPaydex Aggregate
END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { PaydexScoreNorms Aggregate, Optional

Records the norm Paydex Scores for the subject's industry or country over time. Norm Paydex Scores is a numeric value that is a collective measure of how all the businesses pay their creditors, where the higher the number, the more timely the payments. For example, the median norm for businesses in the publishing industry may be 70, while the median norm for businesses in the farming industry may be 59.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { PaydexScoreNorms { PaydexScoreIndustryNorms Aggregate, Optional (Infinite)

An entry loop which can repeat multiple times to allow the recording of the norm Paydex Scores for the subject's industry over time.that is a collective measure of how all the businesses in a particular industry (on which D&B has trade) pay their creditors, where the higher the number, the more timely the payments.For example, the median norm for businesses in the publishing industry may be 70, while the median norm for businesses in the farming industry may be 59.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { PaydexScoreNorms { PaydexScoreIndustryNorms { PaydexMedianQuartileScore Element, integerup to 3 digits. , Optional, [M+]

A numerical score denoting how timely payments are, statistically-speaking, at the pointegerat which 50% of the organizations included in this industry norm have an equal or higher payment index score, while the other 50% of organizations have an equal or lower payment index score.

Monitor Path: //Organization /BusinessTrading /PaydexScoreNorms

OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { PaydexScoreNorms { PaydexScoreIndustryNorms { CalculationDate Element, date , Optional

The date the Industry Norm Score was calculated expressed as month and year.

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { PaydexScoreNorms { PaydexScoreIndustryNorms Aggregate
END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { PaydexScoreNorms Aggregate
END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading Aggregate
END: OrderProductResponse { OrderProductResponseDetail { Product { Organization Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail Aggregate, Optional
OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail { PortfolioAssetID Element, Required
OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail { PortfolioAssetContainerID Element, Optional
End: OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { CopyrightNoticeText Element, 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 Element, 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 Element, 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').

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, and SC001-SC012.

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.