matchCompany

Return DUNS Number for a given account number

Input Parameters:

Name	XML Input Parameter	Type	Description	Mandatory (M) /Optional (O)	Possible Values
Account Number	<dto:entityNumber> more info	Text	The unique number assigned to each of the D&B Finance Analytics Accounts. This field is not case sensitive	M - If Business Information is not provided	e.g.: FCC36EAN
Bureau Name	One of the Field in the Field List for the Account. <dto:bureauName> more info	Text	Name of the bureau to be used for pulling bureau data. The information provided under other FieldDTOs is used for matching.	O	dnb
Business Information	<dto:businessInformation> more info	Text	Business Identity details, such as the name and address. Based on the inputs provided, a Nationwide search against D&B databases is conducted. US is the default country. This field is not case sensitive.	M - If Account Number is not provided	e.g.: GORMAN MANUFACTURING COMPANY, INC., 492 Koller Street, San Francisco , CA - 94110.
Entity Type	<dto:entityType> more info	Text	Identifier as Application/Account	O	Application/Account
Return List	<dto:listOfSimilars> more info	Boolean	The value in this field determines if a List of Similars needs to be returned if a perfect match is not found based on the input parameters. This field is not case sensitive.	O	True (Default) False

Output Parameters

Name	XML Output Parameter	Type	Description	Possible Values
DUNS Number	<bureauIdentifierNumber> more info	Number	Returns the DUNS number of the account with matching input credentials. If no matching companies are found then a SBRI Unmatched database search is performed automatically	e.g.: 80-473-5132
Business Information	<BureauCompanyDTO> more info	Text	Business Identity details of the account, such as the name and address	e.g.: GORMAN MANUFACTURING COMPANY, INC., 492 Koller Street, San Francisco , CA - 94110.
List of Similars	<listOfSimilarsFound> more info	Boolean	Flag to indicate whether there was more than one match found.	e.g.: true/false.

Exceptions Thrown:

• InvalidAccountNumberException - when the user does not provide a valid account number.

• AccountNumberNotFoundException - when the account number entered by the user is not available
• DUNSNumberNotFoundException - when the DUNS Number provided by the user is not available
• BureauNotAvailableException - when bureau chosen by user is not available
• AccountNumberNotProvidedException/BusinessNameNotProvidedException - when the account number or business name is not provided in the input parameter
• CompanyNotFoundException (When request submitted using business information) - when there is no match found when the user submits a request for match company with business information as the input