getAaaRating

getAaaRating(authorizedRequest $item)

Get AAA rating of company with additional calculation details

Request parameters

• token - access token (required)
• country - country code, currently only EST is supported (optional, default EST)
• reg_code - registration number of company (optional, default 10117826 Bisnode)
• customer - if you're reseller, you can add a note about your customer here. Used only in log file, you can search and filter log by this parameter (optional)
• language - language of results en,et or ru (optional, default en)

Example:

<?xml version = "1.0" encoding = "UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Body>
	<SOAP-ENV:getAaaRating>
	  <item>
		<token>0c725874e737c8195de547f67692d8b976726561</token>
		<country>EST</country>
		<reg_code>10117826</reg_code>
	  </item>
	</SOAP-ENV:getAaaRating>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Response

Parts of response:

• action - name of function you've called
• general - general company information
• aaa_rating - structure with parameters operation_rating, background_rating, finance_rating, atp_rating, aaa_rating and credit_limit. Each of them have code, status and color parameters.

Example:

<?xml version = "1.0" encoding = "UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Body>
	<SOAP-ENV:getAaaRatingResponse>
	  <item>
		<action>getAaaRating</action>
		<general>
		  <company_name>BISNODE ESTONIA AS</company_name>
		  <company_type>Public limited company</company_type>
		  <company_type_code>Public limited company</company_type_code>
		  <status>Active</status>
		  <status_code>active</status_code>
		  <deletion_date/>
		  <registration_number>10117826</registration_number>
		  <registration_date>1996-11-18</registration_date>
		  <registered_capital>25560.0</registered_capital>
		  <registered_capital_currency>EUR</registered_capital_currency>
		  <vat_number>EE100106532</vat_number>
		  <address>Estonia pst 5, 10143, Tallinna linn, Harju maakond</address>
		  <activity>63.99</activity>
		</general>
		<aaa_rating>
		  <operation_rating><code>A-EST</code>
			<status>Established</status>
			<color>green</color>
		  </operation_rating>
		  <background_rating><code>D-POSI</code>
			<status>Positive</status>
			<color>green</color>
		  </background_rating>
		  <finance_rating><code>G-EXCE</code>
			<status>Excellent</status>
			<color>green</color>
		  </finance_rating>
		  <atp_rating><code>A-NEUT</code>
			<status>Not negative</status>
			<color>green</color>
		  </atp_rating>
		  <aaa_rating><code>AAA</code>
			<status>Highest Creditworthiness</status>
			<color>green</color>
		  </aaa_rating>
		  <credit_limit><code>1</code>
			<status>112022 EUR</status>
			<color>green</color>
		  </credit_limit>
		</aaa_rating>
	  </item>
	</SOAP-ENV:getAaaRatingResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Error messages

In case of fatal problem, instead of result you will receive an error message

• Token is wrong - you trying to access SOAP service with wrong or expired access token.
• This request is not allowed for you - the request you trying to perform is not allowed for you. This may be a problem in our system, please contact support.
• No such company - company you requested is not available. Check country and reg_code parameters are correct.
• Only EST country supported in this request - currently, we have reports only for estonian companies. Change country to EST

Example:

<?xml version = "1.0" encoding = "UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Body>
	<SOAP-ENV:Fault>
	  <faultcode>SOAP-ENV:Client</faultcode>
	  <faultstring>This request is not allowed for you</faultstring>
	</SOAP-ENV:Fault>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

See also

• SOAP documentation
• REST documentation