Infoproff API Documentation - v2

Switch version V2

Getting Started

Web service wsdl and schemas are located here:

http://wsdfn.infoproff.com/v2/

Web service main functions:

  • SimpleSearch - Search companies information in different countries.
  • Order - Creates an order_id and returns duplicates. Duplicates are selected by next parameters: country, product, delivery_term and reg_code.
  • OrderCancellation - If you sent an order request and received the order_id, you have an opportunity to cancel this order (if is it not gone into production).
  • OrderConfirmation - After getting order_id you will have to confirm your order within 1 hour. If you don't confirm your order within 1 hour, the order will be cancelled automatically.
  • ChkStatus - Check order status.
  • GetReport - Get finished reports.
  • GetClassifiersFinancialStatements - Get all financial documents with all elements: row_number, row_formated_description, row_lang_key and row_order.
  • GetLegalForms - Get all legal forms for all available countries.
  • GetActivityClassificators - Get all codes and descriptions for specific activity classificator.
  • GetDictionaryStandardPhrases - Get all standard phrases with keys and language.
  • GetAvailableProducts - Get a list of available products.
  • CreditOpinionCalculator - Credit Opinion Calculator helps to assign credit opinion on a company.

API provides several services:

  1. Online credit reports for the following countries: Finland (FIN), Sweden (SWE)
  2. Offline reports for the following countries: All countries
  3. Credit opinion calculator

How to search for a company?

The company search consists of 2 options:

  1. Search by company name,
  2. Search by registration code.
List of available countries: Finland (FIN), Sweden (SWE), Norway (NOR), Denmark (DNK)
Important information:
Norway register does not allow to search deleted companies by names. Therefore, we cannot provide a SimpleSearch by names within deleted companies in Norway.
Field's length:
company_name varchar(512)
company_code varchar(64)

Below you can find the example:

Function SimpleSearch

Option 2: Search by registration code

Function SimpleSearch

How to order a credit report?

The order from registration to receipt of the report consists of these steps:

  1. The User register a new order (function "Order"). The system returns order details, list of duplicates placed in the last 60 days and awaits order confirmation.
  2. The User confirms an order (function "OrderConfirmation"). The system sends the order for production and returns the current production status.
  3. The User checks order status (function "ChkStatus").
  4. If an order is ready, then the User can download the report (function "GetReport").
List of available countries: Finland (FIN), Sweden (SWE)
Field's length:
business_name varchar(512)
reg_code varchar(64)
vat_code varchar(64)
address varchar(512)
phone varchar(256)
email varchar(256)
additional_info varchar(512)
ref_code varchar(64)

Below you can find the example:

STEP 1: Order report

Users who consider the step of order confirmation to be unnecessary can use the element "confirm_order" and pass the value "TRUE".

Usually it takes 10-20 seconds to prepare the credit report in online mode.
Therefore, for online reports, you should make checks every 5 or more seconds.

List of available companies for a test account:

01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
In addition, for online reports (delivery_term = "o"), you can use samples generated for every country (use: registration code "00000000"). These reports are free of charge and can be ordered using test account.
Function Order
Function OrderCancellation

STEP 2. Order Confirmation

Function OrderConfirmation

STEP 3. Status Checking

Function ChkStatus

STEP 4. Get report

List of available languages for Online reports: en (English), et (Estonian), ru (Russian), de (German)
Dowloading the Online report in pdf is not yet available.
Function GetReport

The following statuses are used for reports:

  • In progress - Report at the production stage
  • Canceled - Canceled order
  • Finished - The report is ready
  • Updated - Information was added to the finished report
  • Technical Error - A technical error has occurred in our system. This means, that we are informed about this error and will fix it ASAP. You will be informed when you will be able to receive the order.

If the execution status is Finished or Updated, then you can get an order.

How to download Offline report?

You can download Offline reports directly. Here is the instruction how you need to do it:

The request consist of 3 parts:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. Your unique hash, which we provide in response
  3. And fixed part at the end /download

How to get credit opinion?

Function CreditOpinionCalculator

How to get additional information?

Function GetClassifiersFinancialStatements
Function GetActivityClassificators
Function GetDictionaryStandardPhrases
Function GetAvailableProducts

Possible errors

These errors may occur while making request to our web service.

All functions
  • Incorrect username/password or you have no permissions.
    You are entering wrong credentials or your API access is blocked.
Function SimpleSearch
  1. You don't have permissions to search in this country.
    List of available countries: Finland (FIN), Sweden (SWE)
Function Order
  1. This product is not available.
    Such product can't be found and it is not possible to order.
  2. You can't order report on company with legal form: "legal_form"
    This error only applies to: Sweden (SWE)
    In Sweden it is not possible to order online report (delivery_term = "o") with the next legal forms:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. This company is not in the test list.
    Company registration code is not in our test list.
    List of available companies for a test account:
    01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
  4. Business Name or Reg Code is required
    When ordering offline report (delivery_term = "n", "f" or "s") "Business Name" or "Reg Code" is required.
  5. Reg Code is required when delivery term is Online
    When ordering online report (delivery_term = "o") "Reg Code" is required.
Function GetReport
  1. This language is not supported.
    List of available languages for Online reports: en (English), et (Estonian), ru (Russian), de (German)
Functions GetReport ChkStatus
  1. Incorrect order_id.
    Order ID can't be found. You get order ID when you use Order function.
Function OrderCancellation
  1. Your order is already canceled.
    You don't have permission to cancel the order anymore.
Function OrderConfirmation
  1. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

SOAP (Version 3) changes compared to SOAP (Version 2)

SOAP (Version 3) changes compared to SOAP (Version 2) [Overview]

1) New function: ChkFinance

Allows you to search for available financial statements.
Currently available only in EST (Estonia), SWE (Sweden)

2) Function: SimpleSearch

- Changes in list of available countries: Finland (FIN), Sweden (SWE), Norway (NOR), Denmark (DNK), Belgium (BEL), Estonia (EST), Netherlands (NLD), United Kingdom (GBR), Ireland (IRL), France (FRA), Spain (ESP), Portugal (PRT), Germany (DEU), Italy (ITA), Austria (AUT), Switzerland (CHE), Cyprus (CYP)

- Each time you place an request we asaign a new 'search_result_id' for each company. You need to use this 'search_result_id' to place online orders.

Also you can place offline (delivery_term = 'n', 'f' or 's') orders with 'search_result_id', if you desire.

3) Function: Order
Identification is required!

To place an online order, you need to recieve 'search_result_id' from function 'SimpleSearch', and only after that you can place an online (delivery_term = 'o') order.

- Changes in list of available countries for online credit reports: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Available to download financial statements (using product: finances) in online mode: Estonia (EST), Sweden (SWE)

3) Function: GetReport

- Changes in of available languages: en (English), et (Estonian), ru (Russian), de (German), zh (Chinese), ja (Japanese), bg (Bulgarian), cs (Czech), da (Danish), el (Greek), fi (Finnish), fr (French), hu (Hungarian), it (Italian), lv (Latvian), lt (Lithuanian), nl (Dutch), pl (Polish), pt (Portuguese), ro (Romanian), sk (Slovak), sl (Slovenian), es (Spanish), sv (Swedish)


SOAP (Version 3) changes compared to SOAP (Version 2) [WSDL and XSD]

File: report.xsd

New elements:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

New function:

- ChkFinance

Function that allows you to search for available financial statements.

NB: This function is only needed when ordering a product: finances (Financial statements) with delivery_term = 'o'.
File: order.xsd

1) OrderReportRequest has a choice:

- order_details:

Using general information: business_name, reg_code, vat_code, address, phone, email, additional_info

NB:
* Business Name or Registration Code is required
* Only for orders with delivery_term: 'n', 'f' and 's' (credit reports in offline mode)

- order_details_by_id:

Using 'search_result_id'

NB:
* 'search_result_id' can be obtained with function: 'SimpleSearch'
* each new search generates new 'search_result_id'

2) order_details

New element:

- preferable_finances

NB: This element is required only ordering a product: finances (Financial statements) with delivery_term = 'o'.

3) SimpleSearchRequest

Removed element:

search_block.reg_code

New element:

search_block->company_code

NB: in some countries we allow to search companies by vat_code.

4) SimpleSearchResponse

Removed elements

- code

New elements:

  • - search_result_id (is required for order with delivery_term = 'o')
  • - name_transliteration
  • - reg_code
  • - vat_code
  • - unified_legal_form