Cookies Settings

Loading

dnb-logo
Direct 2.0
Collapse

Predictive Global Payment Risk - D&B Emerging Market Mediation Alert Score (EMMA)

An EMMA Score is a judgmental risk score developed for use in Emerging Markets, as an initial risk assessment tool, eventually to be replaced by an empirically derived score when sufficient data is present in that market. It utilizes all available commercial data on that company, and applies judgmental modeling methodologies and local market expertise to assign the proper weights.

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

(missing or bad snippet)

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, 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 PGPR_EMMA data layer is available for businesses domiciled in the following countries:

CountryISO Code
MexicoMX
China, Peoples Republic ofCN
TurkeyTR

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 "Predictive Global Payment Risk - D&B Emerging Market Mediation Alert Score (EMMA)" 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 (PGPR_EMMA)
<soapenv:Envelope xmlns:ass="http://services.dnb.com/AssessmentProductServiceV2.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-1">
            <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">Password</wsse:Password>
         </wsse:UsernameToken>
      </wsse:Security>
   </soapenv:Header>
   <soapenv:Body>
      <ass:OrderProductRequest ServiceVersionNumber="5.0">
         <TransactionDetail>
            <ApplicationTransactionID>PGPR_EMMA_Sample_001</ApplicationTransactionID>
         </TransactionDetail>
         <OrderProductRequestDetail>
            <InquiryDetail>
               <DUNSNumber>654502665</DUNSNumber>
            </InquiryDetail>
            <ProductSpecification>
               <DNBProductID>PGPR_EMMA</DNBProductID>
            </ProductSpecification>
            <InquiryReferenceDetail>
               <CustomerReferenceText>PGPR_EMMA_Sample</CustomerReferenceText>
               <CustomerBillingEndorsementText>PGPR_EMMA_Sample</CustomerBillingEndorsementText>
            </InquiryReferenceDetail>
         </OrderProductRequestDetail>
      </ass:OrderProductRequest>
   </soapenv:Body>
</soapenv:Envelope>
NameCharacteristics
OrderProductRequestAggregate
OrderProductRequest @ServiceVersionNumberAttribute
OrderProductRequest. TransactionDetailAggregate, Optional

Records information necessary to process this request.

OrderProductRequest. TransactionDetail. ApplicationTransactionIDstring, up to 64 chars, Optional

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

OrderProductRequest. TransactionDetail. TransactionTimestampDateTimestamp, 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. SubmittingOfficeIDstring, 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. OrderProductRequestDetailAggregate, 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. InquiryDetailAggregate, 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. DUNSNumberstring, 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. CountryISOAlpha2Codestring, at least 2 chars up to 2 chars, Optional

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

End: OrderProductRequest. OrderProductRequestDetail. InquiryDetail /Aggregate
OrderProductRequest. OrderProductRequestDetail. ProductSpecificationAggregate, 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. DNBProductIDstring, Optional

An alphanumeric string that uniquely identifies the product being requested.

OrderProductRequest. OrderProductRequestDetail. ProductSpecification. LanguagePreferenceCodeinteger, up to 7 digits, Optional

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

Possible values: 39 [English]

OrderProductRequest. OrderProductRequestDetail. ProductSpecification. OrderReasonCodeinteger, 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]

OrderProductRequest. OrderProductRequestDetail. ProductSpecification. TradeUpIndicatorboolean, 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.

Possible values: true; false

End: OrderProductRequest. OrderProductRequestDetail. ProductSpecification /Aggregate
OrderProductRequest. OrderProductRequestDetail. ArchiveDetailAggregate, Optional
OrderProductRequest. OrderProductRequestDetail. ArchiveDetail. ArchiveProductOptOutIndicatorboolean, 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.

Possible values: true; false

OrderProductRequest. OrderProductRequestDetail. ArchiveDetail. ExtendArchivePeriodIndicatorboolean, 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.

Possible values: true; false

End: OrderProductRequest. OrderProductRequestDetail. ArchiveDetail /Aggregate
OrderProductRequest. OrderProductRequestDetail. InquiryReferenceDetailAggregate, 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. CustomerReferenceTextstring, 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. CustomerBillingEndorsementTextstring, 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.

SOAP (Assessment)
https://direct.dnb.com/AssessmentProduct/V{version}WSDL

Testing

Sandbox

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.

D-U-N-S Number (Country Code)
654502665 (CN); 811761659 (MX)

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.

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

Sample Response (PGPR_EMMA)
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soap-env:Body xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">
      <ass:OrderProductResponse ServiceVersionNumber="5.0" xmlns:ass="http://services.dnb.com/AssessmentProductServiceV2.0">
         <TransactionDetail>
            <ApplicationTransactionID>PGPR_EMMA_Sample_001</ApplicationTransactionID>
            <ServiceTransactionID>Id-5b61ef3f52eabe3e06fb1945-2</ServiceTransactionID>
            <TransactionTimestamp>2014-01-30T16:04:01.911-05:00</TransactionTimestamp>
         </TransactionDetail>
         <TransactionResult>
            <SeverityText>Information</SeverityText>
            <ResultID>CM000</ResultID>
            <ResultText>Success</ResultText>
         </TransactionResult>
         <OrderProductResponseDetail>
            <InquiryDetail>
               <DUNSNumber>654502665</DUNSNumber>
               <CountryISOAlpha2Code>CN</CountryISOAlpha2Code>
            </InquiryDetail>
            <Product>
               <DNBProductID>PGPR_EMMA</DNBProductID>
               <Organization>
                  <SubjectHeader>
                     <DUNSNumber>654502665</DUNSNumber>
                  </SubjectHeader>
                  <Telecommunication>
                     <TelephoneNumber>
                        <TelecommunicationNumber>021 5750 5988</TelecommunicationNumber>
                        <InternationalDialingCode>86</InternationalDialingCode>
                     </TelephoneNumber>
                     <FacsimileNumber>
                        <TelecommunicationNumber>021 5750 5981</TelecommunicationNumber>
                        <InternationalDialingCode>86</InternationalDialingCode>
                     </FacsimileNumber>
                  </Telecommunication>
                  <Location>
                     <PrimaryAddress>
                        <StreetAddressLine>
                           <LineText>No.3, Yongjia Road, Wuniu Industry Zone,Jiading District</LineText>
                        </StreetAddressLine>
                        <PrimaryTownName>Shanghai</PrimaryTownName>
                        <CountryISOAlpha2Code>CN</CountryISOAlpha2Code>
                        <PostalCode>201123</PostalCode>
                        <TerritoryOfficialName>Shanghai</TerritoryOfficialName>
                     </PrimaryAddress>
                  </Location>
                  <OrganizationName>
                     <OrganizationPrimaryName>
                        <OrganizationName>Sample Report (China) Co., Ltd</OrganizationName>
                     </OrganizationPrimaryName>
                  </OrganizationName>
                  <OrganizationDetail>
                     <FamilyTreeMemberRole>
                        <FamilyTreeMemberRoleText DNBCodeValue="9159">Subsidiary</FamilyTreeMemberRoleText>
                     </FamilyTreeMemberRole>
                     <FamilyTreeMemberRole>
                        <FamilyTreeMemberRoleText DNBCodeValue="12773">Parent</FamilyTreeMemberRoleText>
                     </FamilyTreeMemberRole>
                  </OrganizationDetail>
                  <Assessment>
                     <EmergingMarketMediationScore>
                        <RawScore>2297</RawScore>
                        <ClassScore>5</ClassScore>
                        <ScoreDate>2014-01-08</ScoreDate>
                     </EmergingMarketMediationScore>
                  </Assessment>
               </Organization>
            </Product>
            <InquiryReferenceDetail>
               <CustomerReferenceText>PGPR_EMMA_Sample</CustomerReferenceText>
               <CustomerBillingEndorsementText>PGPR_EMMA_Sample</CustomerBillingEndorsementText>
            </InquiryReferenceDetail>
         </OrderProductResponseDetail>
      </ass:OrderProductResponse>
   </soap-env:Body>
</soapenv:Envelope>
NameCharacteristics
OrderProductResponseAggregate
OrderProductResponse @ServiceVersionNumberAttribute
OrderProductResponse. TransactionDetailAggregate, string, up to 64 chars., Required

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

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

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

OrderProductResponse. TransactionDetail. ServiceTransactionIDElement, Required

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

OrderProductResponse. TransactionDetail. TransactionTimestampElement, 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. TransactionResultAggregate, string, up to 16 chars., Required

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

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

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

OrderProductResponse. TransactionResult. ResultIDElement, string, up to 512 chars., Required

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

OrderProductResponse. TransactionResult. ResultTextElement, Optional

Text that explains the outcome of the transaction.

OrderProductResponse. TransactionResult. ResultMessageAggregate, string, up to 512 chars., 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. ResultDescriptionElement, Required

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

End: OrderProductResponse. TransactionResult. ResultMessage Aggregate
End: OrderProductResponse. TransactionResult Aggregate
OrderProductResponse. OrderProductResponseDetailAggregate, Optional

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

OrderProductResponse. OrderProductResponseDetail. InquiryDetailAggregate, string, up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., 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. DUNSNumberElement, string, at least 2 chars. up to 2 chars., 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. CountryISOAlpha2CodeElement, Optional

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

End: OrderProductResponse. OrderProductResponseDetail. InquiryDetail Aggregate
OrderProductResponse. OrderProductResponseDetail. ProductAggregate, string, up to 64 chars., 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. DNBProductIDElement, integer, up to 7 digits., Optional

An alphanumeric string that uniquely identifies this product.

OrderProductResponse. OrderProductResponseDetail. Product. LanguageCodeElement, Optional

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

OrderProductResponse. OrderProductResponseDetail. Product. OrganizationAggregate, 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. SubjectHeaderAggregate, string, up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., 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. DUNSNumberElement, 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).

End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeaderAggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. LocationAggregate, 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. PrimaryAddressAggregate, Optional (Array)

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. StreetAddressLineAggregate, string, up to 240 chars., Optional (Array)

An entry loop which can repeat multiple times to allow the recording of several lines where each address line contains one or more named address elements. Examples of named address elements are Street Name, Street Number, Building Name, Estate Name. They are called “lines” because an addres can be divided into multiple lines. When there are multiple lines the sequence of the lines must be preserved.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. StreetAddressLine. LineTextElement, Required, [M+]

Text that records the street address components as it would be presented on an address label. This includes, but is not limited to, details such as street name, street number, building name, estate name.

Monitor Path: //Organization /Location /PrimaryAddress

End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. StreetAddressLineAggregate, string, up to 64 chars.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. PrimaryTownNameElement, string, at least 2 chars. up to 2 chars., Optional, [M+]

The name of the town or city recognized by the Postal Authority for delivering mail.

Monitor Path: //Organization /Location /PrimaryAddress

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. CountryISOAlpha2CodeElement, string, up to 16 chars., Optional, [M+]

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

Monitor Path: //Organization /Location /PrimaryAddress

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. PostalCodeElement, string, up to 64 chars., Optional, [M+]

An identifier used by the local country Postal Authority to identify a particular geographic location. For example, in Belgium, Postal Code 9000 identifies the town of GHENT.

Monitor Path: //Organization /Location /PrimaryAddress

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. TerritoryOfficialNameElement, string, up to 64 chars., Optional, [M+]

Monitor Path: //Organization /Location /PrimaryAddress

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. TerritoryAbbreviatedNameElement, string, up to 64 chars., Optional, [M+]

The shortened name of the locally governed area which forms part of a centrally governed nation. For example 'NJ' for the US State New Jersey within Country United States of America.

Monitor Path: //Organization /Location /PrimaryAddress

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. MinorTownNameElement, string, up to 64 chars., Optional, [M+]

Text recording the name of a village, town or suburb where this is not a Primary Town/City. For example, 'Booker' in Booker, High Wycombe.

Monitor Path: //Organization /Location /PrimaryAddress

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. CountyOfficialNameElement, Optional
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddressAggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of address which is mainly utilized for the purpose of mail delivery. This usually includes a Post Office Box number or similar mailing details.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. StreetAddressLineAggregate, string, up to 240 chars., Optional (Array)

An entry loop which can repeat multiple times to allow the recording of several lines where each address line contains one or more named address elements. Examples of named address elements are Street Name, Street Number, Building Name, Estate Name. They are called “lines” because an addres can be divided into multiple lines. When there are multiple lines the sequence of the lines must be preserved.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. StreetAddressLine. LineTextElement, Required, [M+]

Text that records the street address components as it would be presented on an address label. This includes, but is not limited to, details such as street name, street number, building name, estate name.

Monitor Path: //Organization /Location /MailingAddress

End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. StreetAddressLine Aggregate, string, up to 64 chars.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. PrimaryTownNameElement, string, at least 2 chars. up to 2 chars., Optional, [M+]

The name of the town or city recognized by the Postal Authority for delivering mail.

Monitor Path: //Organization /Location /MailingAddress

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. CountryISOAlpha2CodeElement, string, up to 64 chars., Optional, [M+]

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

Monitor Path: //Organization /Location /MailingAddress

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. CountyOfficialNameElement, string, up to 16 chars., Optional, [M+]

Monitor Path: //Organization /Location /MailingAddress

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. PostalCodeElement, string, up to 64 chars., Optional, [M+]

An identifier used by the local country Postal Authority to identify a particular geographic location. For example, in Belgium, Postal Code 9000 identifies the town of GHENT.

Monitor Path: //Organization /Location /MailingAddress

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. TerritoryOfficialNameElement, string, up to 64 chars., Optional, [M+]

Monitor Path: //Organization /Location /MailingAddress

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. TerritoryAbbreviatedNameElement, Optional, [M+]

The shortened name of the locally governed area which forms part of a centrally governed nation. For example 'NJ' for the US State New Jersey within Country United States of America.

Monitor Path: //Organization /Location /MailingAddress

End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. TelecommunicationAggregate, Optional

Records information about the different modes of Telecommunication addresses used by a subject for external contact purposes. The modes of communication include telephone, fax, e-mail, web address.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Telecommunication. TelephoneNumberAggregate, string, at least 1 chars. up to 50 chars., Optional (Array)

An entry loop which can allow multiple Telephone contact information used for voice communication with the subject.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Telecommunication. TelephoneNumber. TelecommunicationNumberElement, string, up to 7 chars., Required, [M+]

A sequence of digits used by the subject for voice communication in a public switched telephone network. This sequence of digits includes the area code or city code.

NOTE: This number does not include the International Dialing Code and Domestic Dialing Code.

NOTE: Data provided is formatted as per national conventions for each country

Monitor Path: //Organization /Telecommunication

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Telecommunication. TelephoneNumber. InternationalDialingCodeElement, Optional, [M+]

The country calling code assigned by the International Telecommunication Union (ITU) required to connect to this Telecommunication Number of the subject country when dialing from outside the subject country; e.g., '1' for the US, '44' for the UK, '91' for India.

Monitor Path: //Organization /Telecommunication

End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Telecommunication. TelephoneNumber Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Telecommunication. FacsimileNumberAggregate, string, at least 1 chars. up to 50 chars., Optional (Array)

An entry loop which can allow multiple Facsimile contact information used for data communication with the subject.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Telecommunication. FacsimileNumber. TelecommunicationNumberElement, string, up to 7 chars., Required, [M+]

A sequence of digits used by the subject for voice communication in a public switched telephone network. This sequence of digits includes the area code or city code.

NOTE: This number does not include the International Dialing Code and Domestic Dialing Code.

NOTE: Data provided is formatted as per national conventions for each country.

Monitor Path: //Organization /Telecommunication

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Telecommunication. FacsimileNumber. InternationalDialingCodeElement, Optional, [M+]

The country calling code assigned by the International Telecommunication Union (ITU) required to connect to this Telecommunication Number of the subject country when dialing from outside the subject country; e.g., '1' for the US, '44' for the UK, '91' for India.

Monitor Path: //Organization /Telecommunication

OrderProductResponse. OrderProductResponseDetail. Product. Organization. OrganizationNameAggregate, 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. OrganizationPrimaryNameAggregate, string, up to 256 chars., Optional (Array)

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. OrganizationNameElement, string, up to 256 chars., Required

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

OrderProductResponse. OrderProductResponseDetail. Product. Organization. OrganizationDetail. FamilyTreeMemberRole. FamilyTreeMemberRoleTextElement, Optional

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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. OrganizationDetail. FamilyTreeMemberRole. FamilyTreeMemberRoleText @DNBCodeValueAttribute, boolean
OrderProductResponse. OrderProductResponseDetail. Product. Organization. OrganizationDetail. StandaloneOrganizationIndicatorElement, Optional

When turned ON (set to TRUE) it indicates that this organization is not a member of a legal family tree. This means it cannot play the role of a subsidiary, parent, headquarters or branch; i.e., FamilyTreeMemberRoleText cannot be present.When turned OFF (set to FALSE) it indicates that this organization is a member of a legal family tree. In this condition the FamilyTreeMemberRoleText must be present.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment. EmergingMarketMediationScoreAggregate, long, Optional
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment. EmergingMarketMediationScore. RawScoreElement, string, up to 3 chars., Optional

A numeric value that predicts the likelihood that the risk will occur.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment. EmergingMarketMediationScore. ClassScoreElement, Optional

A one digit number from 0 to 5 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).

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment. EmergingMarketMediationScore. ScoreCommentaryAggregate, string, up to 256 chars., Optional (Array)

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

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment. EmergingMarketMediationScore. ScoreCommentary. CommentaryTextElement, Optional, [M+]

Text that explains the primary reasons for the score.

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

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment. EmergingMarketMediationScore. ScoreCommentary. CommentaryText@DNBCodeValueAttribute, , [M+]

Records the period of the Financial Summary when this cannot be expressed using 'Summary Date' and 'Number of Months'

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment. EmergingMarketMediationScore. ScoreCommentary. CommentaryText@DNBCodeTableNumberAttribute, string, up to 16 chars.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment. EmergingMarketMediationScore. ScoreModelVersionNumberElement, date, Optional

Summarizes an organization or individual's assets, equity and liabilities at a specific point in time.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment. EmergingMarketMediationScore. ScoreDateElement, Optional

Records the legal debts or obligations of a company  that arise during the course of business operations. Liabilities are settled over time through the transfer of economic benefits including money, goods or services.

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.

Currency Codes/Units

Whenever financial statement data is included in a response, each individual business element (ItemAmount) should be inspected for currency code and unit values (CurrencyISOAlpha3Code and UnitOfSize). If a given element does not include these attributes, the values provided in the statement header should be utilized.

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.

This product will also return a set of standard elements (e.g. D-U-N-S Number, Organization Name, Trade Styles, Family Tree Role, Primary Address, Mailing Address, Telephone Number, Fax Number, etc.) in addition to the business elements listed.

NameDescription
Emerging Market Mediation Class ScoreA one digit number from 0 to 5 assigned to the business based on information in D&B's file. The higher the class score the greater the likelihood that the organization will have late payments or business failure [M]

PCM XPath: //Organization/ Assessment/ EmergingMarketMediationScore/ ClassScore

Emerging Market Mediation Commentary TextText that explains the primary reasons the subject business was assigned the Emerging Market Mediation Score. [M+]

PCM XPath: //Organization/ Assessment/ EmergingMarketMediationScore/ ScoreCommentary/ CommentaryText

Emerging Market Mediation Raw ScoreA numeric value that predicts late payment or business failure of an organization in an emerging market. [M]

PCM XPath: //Organization/ Assessment/ EmergingMarketMediationScore/ RawScore

Emerging Market Score DateThe date on which the score was calculated. [M]

PCM XPath: //Organization/ Assessment/ EmergingMarketMediationScore/ ScoreDate

Emerging Market Score Model Version NumberThe numeric value specifying the version of the Emerging Market Mediation Score that was used for this organization. [M]

PCM XPath: //Organization/ Assessment/ EmergingMarketMediationScore/ ScoreModelVersionNumber

Non-Postal TownText recording the name of a village, town or suburb where this is not a Primary Town/City. For example, 'Booker' in Booker, High Wycombe.

PCM XPath: //Organization/ Location/ PrimaryAddress/ MinorTownName

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.

Standard Elements

Whenever a D&B Direct data or report product request returns a single D-U-N-S Number, several business elements pertaining to that company will be included with the results.

These elements include D-U-N-S Number*, Organization Name, Primary Address** (including street, city, state, postal code, country), Mailing Address** (including street, city, state, postal code, county), Telephone Number, Fax Number, Trade Styles (up to five), Family Tree Role (HQ, branch), a Standalone Organization Indicator(true/false) and the PortfolioAssetID***.

All standard elements (with the exception of Family Tree Role and PortfolioAssetID) may be referenced by the Monitoring process.

* The D-U-N-S Number of the organization referenced in the results. In the case of a trade up, this will be the headquarters D-U-N-S Number.

** Addresses are returned as they are recieved by D&B and therefore may not conform to local postal formatting specifications.

*** This is an identification number that can be used to retrieve a given results package at a later date from the Product Request Archive (if/when that feature is enabled in a request).

NameDescription
D-U-N-S NumberThe 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). This DUNS Number represents the business entity.
Country CodeThe two-letter country code, defined by the International Organization for Standardization (ISO) ISO 3166-1 scheme identifying the country of the business entity.
County NameText recording the name of the county in which the business is located.
Family Tree Member RoleText recording of various parts that the Subject plays as a member of an ownership structured family tree.
FAX NumberThe FAX number of the business.
FAX Number International Dialing CodeThe FAX number international dialing code of the business.
Mailing Country CodeThe two-letter country code, defined by the International Organization for Standardization (ISO) ISO 3166-1 scheme identifying the country which the business uses for mailing purposes.
Mailing County NameText recording the name of the county which the business uses for mailing purposes.
Mailing Postal CodeAn identifier used by the local country Postal Authority which the business uses for mailing purposes.
Mailing StreetText recording an address which is mainly utilized for the purpose of mail delivery to the business. This usually includes a Post Office Box number or similar mailing details.
Mailing Street (2)Text recording an address which is mainly utilized for the purpose of mail delivery to the business. This usually includes a Post Office Box number or similar mailing details.
Mailing Territory AbbreviationText recording the shortened name of the locally governed area which forms part of a centrally governed nation which the business uses for mailing purposes.
Mailing Territory NameText recording the name of the locally governed area which forms part of a centrally governed nation which the business uses for mailing purposes.
Mailing Town NameThe address number, or post office box number, and street name which a business uses for mailing purposes.
Postal CodeAn identifier used by the local country Postal Authority to identify where the business is located.
Primary Business NameText recording of a single name by which the organization is primarily known or identified.
Standalone Organization IndicatorWhen true indicates that this organization is not a member of a legal family tree. The Subject has no Parent Company, no subsidiaries or no branch/division locations.
Street AddressText recording the address number, or post office box number and street name where the business is located.
Street Address (2)Text recording the address number, or post office box number and street name where the business is located.
Telephone NumberThe telephone number of the business.
Telephone Number International Dialing CodeThe telephone number international dialing code of the business.
Territory Abbreviated NameText recording the shortened name of the locally governed area which forms part of a centrally governed nation to identify where the business is located.
Territory NameText recording the name of the locally governed area which forms part of a centrally governed nation to identify where the business is located.
Town NameText recording the name of a city, town, township, village, borough, etc. where the business is located.
Trade Style NameText recording the name which an organization trades under for commercial purposes although its registered legal name used for contracts and other formal situations may be another name.

Product Notes

The Emerging Market Mediation Alert (EMMA) is a country-specific, statistically based score that predicts the likelihood of a business in an emerging market to be problematic in paying its debts within twelve months from observation, and eventually going out-of-business.

Emerging markets do not have the pairings of trade behavior data and actual bankruptcy filings to pass D&B’s criteria for a standard delinquency or failure score. The EMMA score acknowledges that there are pockets of an emerging market’s database that are deserving of a risk score sooner, because such businesses are more popular as global suppliers and customers.

The availability of certain scores delivered by this product may be limited due to a lack of sufficient company or industry specific data to perform the calculations.