Документація API Infoproff - v3


Початок роботи


Веб-сервіс wsdl та схеми знаходяться тут:

http://wsdfn.infoproff.com/v3/

Функції вебсервісу:

  • SimpleSearch - Пошук інформації про компанії в різних країнах.
  • ChkFinance - Шукайте доступні фінансові звіти.
  • Order - Створює order_id і повертає дублікати. Дублікати відбираються за наступними параметрами: country, product, reg_code.
  • OrderCancellation - Якщо Ви надіслали заявку на замовлення та отримали order_id, у Вас є можливість скасувати це замовлення (якщо воно не пішло у виробництво).
  • OrderConfirmation - Після отримання order_id Вам необхідно буде підтвердити замовлення протягом 1 години. Якщо Ви не підтвердите замовлення протягом 1 години, замовлення буде автоматично анульовано.
  • ChkStatus - Перевірте статус замовлення.
  • GetReport - Отримайте готові звіти.

  • GetClassifiersFinancialStatements - Отримати всі фінансові документи з усіма елементами: row_number, row_formed_description, row_lang_key та row_order.
  • GetLegalForms - Отримайте всі юридичні форми для всіх доступних країн.
  • GetActivityClassificators - Отримайте всі коди та описи за класифікатором видів діяльності.
  • GetDictionaryStandardPhrases - Отримайте всі стандартні фрази з ключами та мовою.
  • GetAvailableProducts - Отримайте перелік доступних продуктів.

  • CreditOpinionCalculator - Калькулятор кредитних історій допоможе визначити кредитну історію компанії.

API надає декілька послуг:

  1. Кредитні звіти онлайн для наступних країн: Ірландія (IRL), Іспанія (ESP), Італія (ITA), Австрія (AUT), Азербайджан (AZE), Бельгія (BEL), Болгарія (BGR), Греція (GRC), Данія (DNK), Естонія (EST), Казахстан (KAZ), Киргизстан (KGZ), Китай (CHN), Латвія (LVA), Люксембург (LUX), Мальта (MLT), Молдова (MDA), Монголія (MNG), Норвегія (NOR), Нідерланди (NLD), Німеччина (DEU), Польща (POL), Португалія (PRT), Росія (RUS), Словаччина (SVK), Словенія (SVN), Сполучене Королівство (GBR), Угорщина (HUN), Україна (UKR), Франція (FRA), Фінляндія (FIN), Хорватія (HRV), Чехія (CZE), Швейцарія (CHE), Швеція (SWE)
  2. Офлайн звіти для наступних країн: Всі країни
  3. Калькулятор кредитної історії
  4. Пошук компаній

Як шукати компанію?


Пошук компанії складається з 2 варіантів:

  1. Пошук за назвою компанії,
  2. Пошук за кодом компанії.
Перелік доступних країн: Ізраїль (ISR), Ірландія (IRL), Ісландія (ISL), Іспанія (ESP), Італія (ITA), Австралія (AUS), Австрія (AUT), Азербайджан (AZE), Албанія (ALB), Алжир (DZA), Ангола (AGO), Аргентина (ARG), Бельгія (BEL), Бенін (BEN), Болгарія (BGR), Болівія (BOL), Боснія і Герцеговина (BIH), Ботсвана (BWA), Бразилія (BRA), Білорусь (BLR), Венесуела (VEN), Возз'єднання (REU), Гамбія (GMB), Гаяна (GUY), Гваделупа (GLP), Гвіана (GUF), Гвінея (GIN), Гонконг (HKG), Гренландія (GRL), Греція (GRC), Грузія (GEO), Данія (DNK), Джерсі (JEY), Еквадор (ECU), Естонія (EST), Ефіопія (ETH), Замбія (ZMB), Зімбабве (ZWE), Казахстан (KAZ), Канада (CAN), Кенія (KEN), Киргизстан (KGZ), Китай (CHN), Китай (TWN), Конго (COG), Косово (XXK), Кот-д'Івуар (CIV), Кіпр (CYP), Латвія (LVA), Литва (LTU), Люксембург (LUX), Ліхтенштейн (LIE), Маврикій (MUS), Мадагаскар (MDG), Майотта (MYT), Мальдіви (MDV), Мальта (MLT), Марокко (MAR), Мартиніка (MTQ), Мен (IMN), Молдова (MDA), Монако (MCO), Монголія (MNG), Намібія (NAM), Нова Зеландія (NZL), Норвегія (NOR), Нігерія (NGA), Нідерланди (NLD), Німеччина (DEU), Парагвай (PRY), Перу (PER), Польща (POL), Португалія (PRT), Південна Африка (ZAF), Росія (RUS), Руанда (RWA), Румунія (ROU), Самоа (WSM), Сан-Марино (SMR), Сейшельські острови (SYC), Сен-Мартен (MAF), Сербія (SRB), Словаччина (SVK), Словенія (SVN), Сполучене Королівство (GBR), Сінгапур (SGP), Таджикистан (TJK), Танзанія (TZA), Таїланд (THA), Того (TGO), Туреччина (TUR), Угорщина (HUN), Узбекистан (UZB), Україна (UKR), Уругвай (URY), Франція (FRA), Філіппіни (PHL), Фінляндія (FIN), Хорватія (HRV), Чехія (CZE), Чилі (CHL), Швейцарія (CHE), Швеція (SWE), Шрі-Ланка (LKA), Японія (JPN)

Пошук по інших країнах виконується лише в базі архівних звітів. Якщо потрібну компанію не знайдено, введіть її дані вручну.

Важлива інформація:

search_result_id можна отримати тут для замовлень із delivery_term = "o" або delivery_term = "a".

Відповідь на пошуковий запит у наступних країнах може займати до 20 секунд: Сполучене Королівство, Ірландія, Франція, Іспанія, Португалія, Німеччина, Італія, Австрія, Швейцарія, Туреччина.

Норвезький реєстр не дозволяє здійснювати пошук видалених компаній за назвами. Тому ми не можемо надати SimpleSearch за іменами в межах видалених компаній в Норвегії.

Реєстр Туреччини підтримує пошук за назвою компанії на сайті SimpleSearch — пошук за реєстраційним кодом недоступний. Пошуковий запит повинен містити щонайменше 5 символів. Збіг визначається лише за початком назви компанії.

Довжина поля:
company_name varchar(512)
company_code varchar(64)

Нижче ви можете ознайомитися з прикладом:


Функція SimpleSearch

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:SimpleSearch>
            <SimpleSearchRequest>
                <authentication_block>
                	<username>XX</username>
                	<password>XX</password>
                </authentication_block>
                <search_block>
                    <company_name>biz group</company_name>
                    <country>SWE</country>
                </search_block>
            </SimpleSearchRequest>
        </ns0:SimpleSearch>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:SimpleSearchResponse>
            <SimpleSearchResponse>
                <search_result>
                    <item>
                        <search_result_id>7b459516-a36b-4f4a-83d9-7a1a864494df</search_result_id>
                        <name>ABČ Биз Sweden Groūp Āktiebolāg</name>
                        <name_transliteration>ABC Biz Sweden Group Aktiebolag</name_transliteration>
                        <historical_names>
                            <item>
                                <name>Groupama Asslcurazioni</name>
                            </item>
                            <item>
                                <name>Asslcurazioni</name>
                            </item>
                        </historical_names>
                        <reg_code>5592027779</reg_code>
                        <vat_code>TAX1125867</vat_code>
                        <static_code>6523456</static_code>
                        <legal_status>Active</legal_status>
                        <legal_form>Aktiebolag</legal_form>
                        <unified_legal_form>Limited liability company</unified_legal_form>
                        <legal_address>KLUBBSTIGEN 8, 17961, STENHAMRA, SVERIGE</legal_address>
                        <parent_company_code>3386027979</parent_company_code>
                        <archived_reports>
                            <item>
                                <product>kyc_report</product>
                                <revision_date>2023-04-20</revision_date>
                                <archived_report_cost>10</archived_report_cost>
                                <archived_report_cost_currency>EUR</archived_report_cost_currency>
                            </item>
                            <item>
                                <product>basic_report</product>
                                <revision_date>2023-06-29</revision_date>
                                <archived_report_cost>15.2</archived_report_cost>
                                <archived_report_cost_currency>EUR</archived_report_cost_currency>
                                <last_fin_report>
                                    <fin_report_year>2022</fin_report_year>
                                    <period_start>2022-01-01</period_start>
                                    <period_end>2022-12-31</period_end>
                                    <fin_period_duration_in_months>12</fin_period_duration_in_months>
                                </last_fin_report>
                            </item>
                            <item>
                                <product>full_report</product>
                                <revision_date>2022-04-13</revision_date>
                                <archived_report_cost>25.75</archived_report_cost>
                                <archived_report_cost_currency>EUR</archived_report_cost_currency>
                                <last_fin_report>
                                    <fin_report_year>2021</fin_report_year>
                                    <fin_period_start>2021-01-01</fin_period_start>
                                    <fin_period_end>2021-12-31</fin_period_end>
                                    <fin_period_duration_in_months>12</fin_period_duration_in_months>
                                </last_fin_report>
                            </item>
                        </archived_reports>
                    </item>
                    <item>
                        <search_result_id>fc8cec2a-5b59-4b30-b65c-ba2900669cd7</search_result_id>
                        <name>АДД Caprīccīo Groūp AB</name>
                        <name_transliteration>ADD Capriccio Group AB</name_transliteration>
                        <historical_names/>
                        <reg_code>5567769961</reg_code>
                        <vat_code/>
                        <static_code/>
                        <legal_status/>
                        <legal_form>Landsting</legal_form>
                        <unified_legal_form>State institution</unified_legal_form>
                        <legal_address>STUDENTBACKEN 1 12 TR, 11557, STOCKHOLM,
                            SVERIGE</legal_address>
                        <parent_company_code xsi:nil="true"/>
                    </item>
                    <item>
                        <search_result_id>4b9c5da2-3aac-4b9a-a308-f9c1e2ee8f32</search_result_id>
                        <name>AEE Good Group AB</name>
                        <name_transliteration>AEE Good Group AB</name_transliteration>
                        <historical_names/>
                        <reg_code>5591756685</reg_code>
                        <vat_code/>
                        <static_code/>
                        <legal_status>Active</legal_status>
                        <legal_form>Ömsesidigt försäkringsbolag</legal_form>
                        <unified_legal_form>Enterprise</unified_legal_form>
                        <legal_address>BOX 1, 18173, LIDINGÖ, SVERIGE</legal_address>
                        <parent_company_code xsi:nil="true"/>
                    </item>
                    ...
                </search_result>
            </SimpleSearchResponse>
        </ns1:SimpleSearchResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Варіант 2: Пошук за реєстраційним кодом

Функція SimpleSearch

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:SimpleSearch>
            <SimpleSearchRequest>
                <authentication_block>
                	<username>XX</username>
                	<password>XX</password>
                </authentication_block>
                <search_block>
                    <company_code>5592027779</company_code>
                    <country>SWE</country>
                </search_block>
            </SimpleSearchRequest>
        </ns0:SimpleSearch>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:SimpleSearchResponse>
            <SimpleSearchResponse>
                <item>
                    <search_result_id>7b459516-a36b-4f4a-83d9-7a1a864494df</search_result_id>
                    <name>ABČ Биз Sweden Groūp Āktiebolāg</name>
                    <name_transliteration>ABC Biz Sweden Group Aktiebolag</name_transliteration>
                    <historical_names>
                        <item>
                            <name>Groupama Asslcurazioni</name>
                        </item>
                        <item>
                            <name>Asslcurazioni</name>
                        </item>
                    </historical_names>
                    <reg_code>5592027779</reg_code>
                    <vat_code>TAX1125867</vat_code>
                    <static_code>6523456</static_code>
                    <legal_status>Active</legal_status>
                    <legal_form>Aktiebolag</legal_form>
                    <unified_legal_form>Limited liability company</unified_legal_form>
                    <legal_address>KLUBBSTIGEN 8, 17961, STENHAMRA, SVERIGE</legal_address>
                    <parent_company_code>3386027979</parent_company_code>
                </item>
            </SimpleSearchResponse>
        </ns1:SimpleSearchResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Варіант 3: пошук за запитом (за назвою або кодом)

Функція UnifiedSearch

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:SimpleSearch>
            <SimpleSearchRequest>
                <authentication_block>
                	<username>XX</username>
                	<password>XX</password>
                </authentication_block>
                <search_block>
                    <search_query>group</search_query>
                    <country>SWE</country>
                </search_block>
            </SimpleSearchRequest>
        </ns0:SimpleSearch>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:SimpleSearchResponse>
            <SimpleSearchResponse>
                <item>
                    <search_result_id>7b459516-a36b-4f4a-83d9-7a1a864494df</search_result_id>
                    <name>ABČ Биз Sweden Groūp Āktiebolāg</name>
                    <name_transliteration>ABC Biz Sweden Group Aktiebolag</name_transliteration>
                    <historical_names>
                        <item>
                            <name>Groupama Asslcurazioni</name>
                        </item>
                        <item>
                            <name>Asslcurazioni</name>
                        </item>
                    </historical_names>
                    <reg_code>5592027779</reg_code>
                    <vat_code>TAX1125867</vat_code>
                    <static_code>6523456</static_code>
                    <legal_status>Active</legal_status>
                    <legal_form>Aktiebolag</legal_form>
                    <unified_legal_form>Limited liability company</unified_legal_form>
                    <legal_address>KLUBBSTIGEN 8, 17961, STENHAMRA, SVERIGE</legal_address>
                    <parent_company_code>3386027979</parent_company_code>
                </item>
                <item>
                    <search_result_id>4b9c5da2-3aac-4b9a-a308-f9c1e2ee8f32</search_result_id>
                    <name>AEE Good Group AB</name>
                    <name_transliteration>AEE Good Group AB</name_transliteration>
                    <historical_names/>
                    <reg_code>5591756685</reg_code>
                    <vat_code/>
                    <static_code/>
                    <legal_status>Active</legal_status>
                    <legal_form>Ömsesidigt försäkringsbolag</legal_form>
                    <unified_legal_form>Enterprise</unified_legal_form>
                    <legal_address>BOX 1, 18173, LIDINGÖ, SVERIGE</legal_address>
                    <parent_company_code xsi:nil="true"/>
                </item>
            </SimpleSearchResponse>
        </ns1:SimpleSearchResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Як замовити кредитний звіт?


Список доступних країн для онлайн-кредитних звітів: Ірландія (IRL), Іспанія (ESP), Італія (ITA), Австрія (AUT), Азербайджан (AZE), Бельгія (BEL), Болгарія (BGR), Греція (GRC), Данія (DNK), Естонія (EST), Казахстан (KAZ), Киргизстан (KGZ), Китай (CHN), Латвія (LVA), Люксембург (LUX), Мальта (MLT), Молдова (MDA), Монголія (MNG), Норвегія (NOR), Нідерланди (NLD), Німеччина (DEU), Польща (POL), Португалія (PRT), Росія (RUS), Словаччина (SVK), Словенія (SVN), Сполучене Королівство (GBR), Угорщина (HUN), Україна (UKR), Франція (FRA), Фінляндія (FIN), Хорватія (HRV), Чехія (CZE), Швейцарія (CHE), Швеція (SWE)
Довжина поля:
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)

Нижче наведено приклад замовлення та завантаження звітів:

КРОК 1: Знайти компанію (Онлайн-/офлайн-замовлення (з search_result_id))

Функція SimpleSearch

Щоб замовити звіт Online/Offline with identification, потрібно отримати "<search_result_id>".
Для цього перейдіть за посиланням: Як шукати компанію?

Пошук дає змогу точно ідентифікувати компанію, щодо якої ви хочете оформити замовлення. Наприклад, у деяких країнах може бути кілька компаній з одним реєстраційним номером або одна й та сама офіційна назва може належати кільком компаніям.

КРОК 2: Замовити звіт (Онлайн-/офлайн-замовлення (з search_result_id))

Функція Order
Якщо ви не використаєте елемент confirm_order, то в XML-відповіді отримаєте <last_duplicates>, щоб вирішити, чи справді потрібно оформлювати замовлення.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:Order>
            <OrderReportRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
                <order_details_by_id>
                    <country>FIN</country>
                    <product>full_report</product>
                    <delivery_term>o</delivery_term>
                    <notification_of_completion>true</notification_of_completion>
                    <confirm_order>false</confirm_order>
                    <copy_notifiaction_to_other_emails>
                        <item>mail1@mail.com</item>
                    	<item>mail2@mail.com</item>
                    </copy_notifiaction_to_other_emails>
                    <company_details>
                        <search_result_id>60751300-4b72-451f-bf96-2a1a7cbe71c6</search_result_id>
                        <address>Company address</address>
                        <phone>Company phone</phone>
                        <email>Company email</email>
                        <additional_info>Additional information regarding company</additional_info>
                        <ref_code>YOUR REF CODE</ref_code> <!-- if you need it -->
                    </company_details>
                </order_details_by_id>
            </OrderReportRequest>
        </ns0:Order>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:OrderResponse>
            <OrderReportResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>08481566</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>ref_code</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Awaiting Confirmation</order_status>
                </order_data>
                <last_duplicates>
                    <order_data>
                        <order_id>90000054</order_id>
                        <order_hash>ZJHhHYIbpUp2xtZM1Jqg5QQYmnrLo2E7p-J8uP7BUF5_G7BNu5J0-nNVxKOeIxun</order_hash>
                        <order_deadline>2019-09-09 </order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-09-09 13:02:32</request_time>
                        <order_details>
                            <country>FIN</country>
                            <product>full_report</product>
                            <delivery_term>o</delivery_term>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <reg_code>08481566</reg_code>
                                <ref_code>ref_code</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Awaiting Confirmation</order_status>
                    </order_data>
                    <order_data>
                        <order_id>90000053</order_id>
                        <order_hash>X4Z6VL9KZd5bWsnWQ_NjdlfN2ix7M1jdwW_FrJ_IyIVKwkDipsx73dW3RMgVE8y0</order_hash>
                        <order_deadline>2019-08-02</order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-08-02 16:34:12</request_time>
                        <order_details>
                            <country>FIN</country>
                            <product>full_report</product>
                            <delivery_term>s</delivery_term>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <reg_code>08481566</reg_code>
                                <vat_code>000000001</vat_code>
                                <ref_code>ref_code</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Finished</order_status>
                    </order_data>
                </last_duplicates>
            </OrderReportResponse>
        </ns1:OrderResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

КРОК 3: Скасування замовлення (необов’язково) (Онлайн-/офлайн-замовлення (з search_result_id))

Функція OrderCancellation
Якщо ви бажаєте скасувати замовлення, можете скористатися цією функцією OrderCancellation. Якщо замовлення вже виконується, скасувати його буде неможливо.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:OrderCancellation>
            <OrderCancellationRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
                <order_id>90000055</order_id>
            </OrderCancellationRequest>
        </ns0:OrderCancellation>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:OrderCancellationResponse>
            <OrderCancellationResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>08481566</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>ref_code</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Canceled</order_status>
                </order_data>
            </OrderCancellationResponse>
        </ns1:OrderCancellationResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

КРОК 4: Підтвердження замовлення (Онлайн-/офлайн-замовлення (з search_result_id))

Функція OrderConfirmation
Якщо ви не використали елемент "confirm_order", потрібно підтвердити замовлення.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:OrderConfirmation>
            <OrderConfirmationRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
                <order_id>90000055</order_id>
            </OrderConfirmationRequest>
        </ns0:OrderConfirmation>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-EN>
        <ns1:OrderConfirmationResponse>
            <OrderConfirmationResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>08481566</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>ref_code</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>In progress</order_status>
                </order_data>
            </OrderConfirmationResponse>
        </ns1:OrderConfirmationResponse>
    </SOAP-EN</div>V:Body>
</SOAP-ENV:Envelope>

КРОК 5: Перевірити статус замовлення (Онлайн-/офлайн-замовлення (з search_result_id))

Функція ChkStatus
  • - Для офлайн-замовлень прийнятна частота перевірки статусу — раз на 30 хвилин.
  • - Для онлайн-замовлень прийнятна частота перевірки статусу — раз на 5 секунд.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:ChkStatus>
            <ChkStatusRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
                <order_id>90000055</order_id>
            </ChkStatusRequest>
        </ns0:ChkStatus>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:ChkStatusResponse>
            <ChkStatusResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>08481566</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>ref_code</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Finished</order_status>
                </order_data>
            </ChkStatusResponse>
        </ns1:ChkStatusResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Для звітів використовуються наступні статуси:

  • У процесі виконання - Звіт на етапі виробництва
  • Очікує ідентифікації - Підготовка звіту призупинена. Потребує додаткових даних від клієнта.
  • Скасовано - Скасоване замовлення
  • Завершено - Звіт готовий
  • Оновлено - До готового звіту додано інформацію
  • Відхилено - Замовлення відхилено (недостатньо коштів, некоректні дані замовлення або інша причина).
  • Технічна помилка - У нашій системі сталася технічна помилка. Це означає, що ми проінформовані про цю помилку і будемо виправляти її якнайшвидше. Про те, коли Ви зможете отримати замовлення, Вас буде повідомлено додатково.

Якщо статус виконання Finished або Updated, то Ви можете отримати замовлення.

КРОК 6: Отримати звіт (Онлайн-/офлайн-замовлення (з search_result_id))

Функція GetReport
Список доступних мов: ar (Arabic), az (Azerbaijani), bg (Болгарська), cs (Чеська), da (Данська), de (Німецька), el (Грецька), en (Англійська мова), es (іспанська), et (естонська), fi (Фінська), fr (Французька), he (Hebrew), hi (Hindi), hu (угорська), hy (Armenian), id (Індонезійська), it (Італійська), ja (Японський), ka (Georgian), kk (Kazakh), ko (Корейська), lt (Литовська), lv (латвійська), mn (Mongolian), ms (Malay), nb (Норвезький Бокмоль), nl (Голландська), pl (Польська), pt (Португальська), ro (Румунська), ru (російська), sk (Словацька), sl (Словенська), sr (Српски), sv (Шведська), th (Thai), tr (Турецька), uk (Українська), uz (Uzbek), vi (Vietnamese), zh (Китайська)

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetReport>
            <GetReportRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
                <order_id>90000055</order_id>
                <lang>en</lang>
            </GetReportRequest>
        </ns0:GetReport>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Body>
        <ns1:GetReportResponse>
            <GetReportResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>08481566</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>ref_code</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Finished</order_status>
                </order_data>
                <report>
                    <language>en</language>
                    <revision_date>2019-01-28</revision_date>
                    <identification>
                        <person_type key="101741" lang="en">company</person_type>
                        <name>Company LLC</name>
                        <code>0848156-6</code>
                        <code_origin>FIN</code_origin>
                    </identification>
                    <summary>
                        <name_in_the_register>Company LLC</name_in_the_register>
                        <name_in_english>Company name in English</name_in_english>
                        <registration_code>...</registration_code>
                        <taxpayer_code>...</taxpayer_code>
                        <legal_form>...</legal_form>
                        <unified_legal_form>...</unified_legal_form>
                        <legal_address>...</legal_address>
                        <office_address>...</office_address>
                        <telephone>...</telephone>
                        <fax>...</fax>
                        <email>...</email>
                        <www>...</www>
                        <legal_status>...</legal_status>
                        <capital>...</capital>
                        <capital_currency>...</capital_currency>
                        <foundation_date>...</foundation_date>
                        <deletion_date xsi:nil="..."/>
                        <remarks_on_payments>...</remarks_on_payments>
                        <export>...</export>
                        <import>...</import>
                        <litigations>...</litigations>
                        <main_activities>...</main_activities>
                        <latest_turnovers>...</latest_turnovers>
                        <credit_rating>...</credit_rating>
                        <credit_rating_description>...</credit_rating_description>
                        <credit_rating_limit>...</credit_rating_limit>
                    </summary>
                    <credit_opinions>...</credit_opinions>
                    <general_data>
                        <business_names_data>...</business_names_data>
                        <registration_data>...</registration_data>
                        <trade_names_data>...</trade_names_data>
                        <addresses_data>...</addresses_data>
                        <contacts_data>...</contacts_data>
                        <important_notifications_data>...</important_notifications_data>
                        <statuses_data>...</statuses_data>
                        <activities_data>...</activities_data>
                        <legal_form_data>...</legal_form_data>
                        <capital_data>...</capital_data>
                        <employees_data>...</employees_data>
                    </general_data>
                    <shareholders>...</shareholders>
                    <managers>...</managers>
                    <the_normal_regulations_of_the_representation_rights>...</the_normal_regulations_of_the_representation_rights>
                    <relations_of_persons>...</relations_of_persons>
                    <branches_data>...</branches_data>
                    <export_import_data>...</export_import_data>
                    <publications_data>...</publications_data>
                    <negative_information>...</negative_information>
                    <financial_statements_data>...</financial_statements_data>
                </report>
            </GetReportResponse>
        </ns1:GetReportResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

КРОК 1: Замовити звіт (Офлайн-замовлення (без search_result_id))

Функція Order
Якщо ви не використаєте елемент confirm_order, то в XML-відповіді отримаєте <last_duplicates>, щоб вирішити, чи справді потрібно оформлювати замовлення.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:Order>
            <OrderReportRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
                <order_details>
                    <country>RUS</country>
                    <product>full_report</product>
                    <delivery_term>n</delivery_term> <!-- available delivery_term: "n", "f" and "s" -->
                    <notification_of_completion>true</notification_of_completion>
                    <confirm_order>false</confirm_order>
                    <copy_notifiaction_to_other_emails>
                        <item>mail1@mail.com</item>
                        <item>mail2@mail.com</item>
                    </copy_notifiaction_to_other_emails>
                    <company_details>
                        <business_name>Company LLC</business_name> <!-- business_name or reg_code is required -->
                        <reg_code>123456789</reg_code> <!-- business_name or reg_code is required -->
                        <vat_code>000000001</vat_code>
                        <address>Company address</address>
                        <phone>Company phone</phone>
                        <email>Company email</email>
                        <additional_info>Additional information regarding company</additional_info>
                        <ref_code>YOUR REF CODE</ref_code> <!-- if you need it -->
                    </company_details>
                </order_details>
            </OrderReportRequest>
        </ns0:Order>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:OrderResponse>
            <OrderReportResponse>
                <order_data>
                    <order_id>1000000040</order_id>
                    <order_hash>pP0lMzDIsPgEClO0nHk5Lo_fsGLhqADVNzx3RPFJj5DOTHm-Z5vA_PMUgMJm84Di</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:11:32</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>123456789</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Awaiting Confirmation</order_status>
                </order_data>
                <last_duplicates>
                    <order_data>
                        <order_id>1000000035</order_id>
                        <order_hash>ZJHhHYIbpUp2xtZM1Jqg5QQYmnrLo2E7p-J8uP7BUF5_G7BNu5J0-nNVxKOeIxun</order_hash>
                        <order_deadline>2019-08-01 </order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-08-01 13:02:32</request_time>
                        <order_details>
                            <country>FIN</country>
                            <product>full_report</product>
                            <delivery_term>f</delivery_term>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <reg_code>123456789</reg_code>
                                <ref_code>ref_code</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Awaiting Confirmation</order_status>
                    </order_data>
                    <order_data>
                        <order_id>1000000036</order_id>
                        <order_hash>X4Z6VL9KZd5bWsnWQ_NjdlfN2ix7M1jdwW_FrJ_IyIVKwkDipsx73dW3RMgVE8y0</order_hash>
                        <order_deadline>2019-06-02</order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-06-02 16:34:12</request_time>
                        <order_details>
                            <country>FIN</country>
                            <product>full_report</product>
                            <delivery_term>o</delivery_term>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <reg_code>123456789</reg_code>
                                <ref_code>ref_code</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Finished</order_status>
                    </order_data>
                </last_duplicates>
            </OrderReportResponse>
        </ns1:OrderResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

КРОК 2: Скасування замовлення (необов’язково) (Офлайн-замовлення (без search_result_id))

Функція OrderCancellation
Якщо ви бажаєте скасувати замовлення, можете скористатися функцією OrderCancellation. Якщо замовлення вже виконується, скасувати його буде неможливо.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:OrderCancellation>
            <OrderCancellationRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
                <order_id>1000000040</order_id>
            </OrderCancellationRequest>
        </ns0:OrderCancellation>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:OrderCancellationResponse>
            <OrderCancellationResponse>
                <order_data>
                    <order_id>1000000040</order_id>
                    <order_hash>pP0lMzDIsPgEClO0nHk5Lo_fsGLhqADVNzx3RPFJj5DOTHm-Z5vA_PMUgMJm84Di</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:11:32</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>123456789</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Canceled</order_status>
                </order_data>
            </OrderCancellationResponse>
        </ns1:OrderCancellationResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

КРОК 3: Підтвердження замовлення (Офлайн-замовлення (без search_result_id))

Функція OrderConfirmation
Якщо ви не використали елемент "confirm_order", потрібно підтвердити замовлення.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:OrderConfirmation>
            <OrderConfirmationRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
                <order_id>1000000040</order_id>
            </OrderConfirmationRequest>
        </ns0:OrderConfirmation>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-EN>
        <ns1:OrderConfirmationResponse>
            <OrderConfirmationResponse>
                <order_data>
                    <order_id>1000000040</order_id>
                    <order_hash>pP0lMzDIsPgEClO0nHk5Lo_fsGLhqADVNzx3RPFJj5DOTHm-Z5vA_PMUgMJm84Di</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:11:32</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>123456789</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>In progress</order_status>
                </order_data>
            </OrderConfirmationResponse>
        </ns1:OrderConfirmationResponse>
    </SOAP-EN</div>V:Body>
</SOAP-ENV:Envelope>

КРОК 4: Перевірка статусу (Офлайн-замовлення (без search_result_id))

Функція ChkStatus
Для офлайн-замовлень прийнятна частота перевірки статусу — раз на 30 хвилин.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:ChkStatus>
            <ChkStatusRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
                <order_id>1000000040</order_id>
            </ChkStatusRequest>
        </ns0:ChkStatus>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:ChkStatusResponse>
            <ChkStatusResponse>
                <order_data>
                    <order_id>1000000040</order_id>
                    <order_hash>pP0lMzDIsPgEClO0nHk5Lo_fsGLhqADVNzx3RPFJj5DOTHm-Z5vA_PMUgMJm84Di</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:11:32</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>123456789</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Finished</order_status>
                </order_data>
            </ChkStatusResponse>
        </ns1:ChkStatusResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Для звітів використовуються наступні статуси:

  • У процесі виконання - Звіт на етапі виробництва
  • Очікує ідентифікації - Підготовка звіту призупинена. Потребує додаткових даних від клієнта.
  • Скасовано - Скасоване замовлення
  • Завершено - Звіт готовий
  • Оновлено - До готового звіту додано інформацію
  • Відхилено - Замовлення відхилено (недостатньо коштів, некоректні дані замовлення або інша причина).
  • Технічна помилка - У нашій системі сталася технічна помилка. Це означає, що ми проінформовані про цю помилку і будемо виправляти її якнайшвидше. Про те, коли Ви зможете отримати замовлення, Вас буде повідомлено додатково.

Якщо статус виконання Finished або Updated, то Ви можете отримати замовлення.

КРОК 5: Отримати звіт (Офлайн-замовлення (без search_result_id))

Функція GetReport
Список доступних мов: ar (Arabic), az (Azerbaijani), bg (Болгарська), cs (Чеська), da (Данська), de (Німецька), el (Грецька), en (Англійська мова), es (іспанська), et (естонська), fi (Фінська), fr (Французька), he (Hebrew), hi (Hindi), hu (угорська), hy (Armenian), id (Індонезійська), it (Італійська), ja (Японський), ka (Georgian), kk (Kazakh), ko (Корейська), lt (Литовська), lv (латвійська), mn (Mongolian), ms (Malay), nb (Норвезький Бокмоль), nl (Голландська), pl (Польська), pt (Португальська), ro (Румунська), ru (російська), sk (Словацька), sl (Словенська), sr (Српски), sv (Шведська), th (Thai), tr (Турецька), uk (Українська), uz (Uzbek), vi (Vietnamese), zh (Китайська)

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetReport>
            <GetReportRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
                <order_id>1000000040</order_id>
                <lang>en</lang>
            </GetReportRequest>
        </ns0:GetReport>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Body>
        <ns1:GetReportResponse>
            <GetReportResponse>
                <order_data>
                    <order_id>1000000040</order_id>
                    <order_hash>pP0lMzDIsPgEClO0nHk5Lo_fsGLhqADVNzx3RPFJj5DOTHm-Z5vA_PMUgMJm84Di</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:11:32</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>123456789</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Finished</order_status>
                </order_data>
                <report>
                    <language>en</language>
                    <revision_date>2019-01-28</revision_date>
                    <identification>
                        <person_type key="101741" lang="en">company</person_type>
                        <name>Company LLC</name>
                        <code>12345678-9</code>
                        <code_origin>FIN</code_origin>
                    </identification>
                    <summary>
                        <name_in_the_register>Company LLC</name_in_the_register>
                        <name_in_english>Company name in English</name_in_english>
                        <registration_code>...</registration_code>
                        <taxpayer_code>...</taxpayer_code>
                        <legal_form>...</legal_form>
                        <unified_legal_form>...</unified_legal_form>
                        <legal_address>...</legal_address>
                        <office_address>...</office_address>
                        <telephone>...</telephone>
                        <fax>...</fax>
                        <email>...</email>
                        <www>...</www>
                        <legal_status>...</legal_status>
                        <capital>...</capital>
                        <capital_currency>...</capital_currency>
                        <foundation_date>...</foundation_date>
                        <deletion_date xsi:nil="..."/>
                        <remarks_on_payments>...</remarks_on_payments>
                        <export>...</export>
                        <import>...</import>
                        <litigations>...</litigations>
                        <main_activities>...</main_activities>
                        <latest_turnovers>...</latest_turnovers>
                        <credit_rating>...</credit_rating>
                        <credit_rating_description>...</credit_rating_description>
                        <credit_rating_limit>...</credit_rating_limit>
                    </summary>
                    <credit_opinions>...</credit_opinions>
                    <general_data>
                        <business_names_data>...</business_names_data>
                        <registration_data>...</registration_data>
                        <trade_names_data>...</trade_names_data>
                        <addresses_data>...</addresses_data>
                        <contacts_data>...</contacts_data>
                        <important_notifications_data>...</important_notifications_data>
                        <statuses_data>...</statuses_data>
                        <activities_data>...</activities_data>
                        <legal_form_data>...</legal_form_data>
                        <capital_data>...</capital_data>
                        <employees_data>...</employees_data>
                    </general_data>
                    <shareholders>...</shareholders>
                    <managers>...</managers>
                    <the_normal_regulations_of_the_representation_rights>...</the_normal_regulations_of_the_representation_rights>
                    <relations_of_persons>...</relations_of_persons>
                    <branches_data>...</branches_data>
                    <export_import_data>...</export_import_data>
                    <publications_data>...</publications_data>
                    <negative_information>...</negative_information>
                    <financial_statements_data>...</financial_statements_data>
                </report>
            </GetReportResponse>
        </ns1:GetReportResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Як замовити архівний кредитний звіт?


Придбання архівного звіту доступне для всіх країн.

Нижче наведено приклад замовлення та завантаження архівних звітів:

КРОК 1: Знайти компанію

Функція SimpleSearch

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:SimpleSearchResponse>
            <SimpleSearchResponse>
                <search_result>
                    <item>
                        <search_result_id>7b459516-a36b-4f4a-83d9-7a1a864494df</search_result_id>
                        <name>Example Company Name</name>
                        <reg_code>00000000</reg_code>
                        ...
                        <archived_reports> <!-- <?= t('docs', 'Section with available archived reports on this company') ?>-->
                            ...
                            <item>
                                <product>full_report</product>
                                <revision_date>2022-04-13</revision_date>
                                <archived_report_cost>15.75</archived_report_cost>
                                <archived_report_cost_currency>EUR</archived_report_cost_currency>
                                <last_fin_report>
                                    <fin_report_year>2021</fin_report_year>
                                    <fin_period_start>2021-01-01</fin_period_start>
                                    <fin_period_end>2021-12-31</fin_period_end>
                                    <fin_period_duration_in_months>12</fin_period_duration_in_months>
                                </last_fin_report>
                            </item>
                            ...
                        </archived_reports>
                    </item>
                    ...
                </search_result>
            </SimpleSearchResponse>
        </ns1:SimpleSearchResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Щоб замовити архівний звіт, потрібно отримати "<search_result_id>", у якому є розділ "<archived_reports>" із потрібним продуктом.
Для цього перейдіть за посиланням: Як шукати компанію?

Приклади компаній з архівними звітами:

  • Country: EST, Reg. Code: 12309116
  • Country: EST, Reg. Code: 12854256
  • Country: EST, Reg. Code: 12830238
  • Country: USA, Company name: Apple

КРОК 2: Замовити звіт

Функція Order

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:Order>
            <OrderReportRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
                <order_details_by_id>
                    <country>FIN</country>
                    <product>full_report</product><!-- <?= t('docs', "Selected archived product for this company") ?> -->
                    <delivery_term>a</delivery_term> <!-- <?= t('docs', "Core difference, always 'a' = archive") ?> -->
                    <notification_of_completion>true</notification_of_completion>
                    <confirm_order>true</confirm_order>
                    <copy_notifiaction_to_other_emails>
                        <item>mail1@mail.com</item>
                    	<item>mail2@mail.com</item>
                    </copy_notifiaction_to_other_emails>
                    <company_details>
                        <search_result_id>7b459516-a36b-4f4a-83d9-7a1a864494df</search_result_id> <!-- <?= t('docs', 'Always required') ?> -->
                        <ref_code>YOUR REF CODE</ref_code> <!-- <?= t('docs', 'If you need it') ?> -->
                    </company_details>
                </order_details_by_id>
            </OrderReportRequest>
        </ns0:Order>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

КРОК 3: Скасування замовлення (необов’язково)

Так само, як для онлайн-/офлайн-звітів.

КРОК 4: Підтвердження замовлення

Так само, як для онлайн-/офлайн-звітів.

КРОК 5: Перевірити статус замовлення

Так само, як для онлайн-/офлайн-звітів.

Для архівних замовлень прийнятна частота перевірки статусу — раз на 5 секунд.

КРОК 6: Отримати звіт

Так само, як для онлайн-/офлайн-звітів.

Як замовити фінансову звітність онлайн?


КРОК 1: Знайти компанію

Функція SimpleSearch

Щоб замовити онлайн-фінансову звітність, потрібно отримати "<search_result_id>".
Для цього перейдіть за посиланням: Як шукати компанію?

Пошук дає змогу точно ідентифікувати компанію, щодо якої ви хочете оформити замовлення. Наприклад, у деяких країнах може бути кілька компаній з одним реєстраційним номером або одна й та сама офіційна назва може належати кільком компаніям.

КРОК 2: Пошук доступної фінансової звітності

Функція ChkFinance

Ця функція потрібна тільки при замовленні товару: finances (Financial statements) з delivery_term = 'o'.

Перелік доступних країн: Естонія (EST), Швеція (SWE)

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:ChkFinance>
            <ChkFinanceRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
                <finance_check_block>
                    <search_result_id>0f6b91f8-3d1b-4901-9d1f-6920afca0667</search_result_id>
                    <country>EST</country>
                </finance_check_block>
            </ChkFinanceRequest>
        </ns0:ChkFinance>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Body>
        <ns1:ChkFinanceResponse>
            <ChkFinanceResponse>
                <finance_check_result>
                    <search_result_id>0f6b91f8-3d1b-4901-9d1f-6920afca0667</search_result_id>
                    <name>00000000 EHITUS</name>
                    <reg_code>00000000</reg_code>
                    <vat_code xsi:nil="true"/>
                    <legal_status>Entered into the register</legal_status>
                    <legal_form>Aktsiaselts</legal_form>
                    <legal_address>Järvevana tee 9g, Kesklinna linnaosa, Tallinn, Harju maakond,
                        11314, Eesti</legal_address>
                    <financial_statements>
                        <item>
                            <available_year>2021</available_year>
                        </item>
                        <item>
                            <available_year>2020</available_year>
                        </item>
                        <item>
                            <available_year>2019</available_year>
                        </item>
                        <item>
                            <available_year>2018</available_year>
                        </item>
                        <item>
                            <available_year>2017</available_year>
                        </item>
                        <item>
                            <available_year>2016</available_year>
                        </item>
                        <item>
                            <available_year>2015</available_year>
                        </item>
                        <item>
                            <available_year>2014</available_year>
                        </item>
                        <item>
                            <available_year>2013</available_year>
                        </item>
                    </financial_statements>
                </finance_check_result>
            </ChkFinanceResponse>
        </ns1:ChkFinanceResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

КРОК 3: Замовити фінансову звітність

Функція Order
Якщо ви не використаєте елемент confirm_order, то в XML-відповіді отримаєте <last_duplicates>, щоб вирішити, чи справді потрібно оформлювати замовлення.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:Order>
            <OrderReportRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
                <order_details_by_id>
                    <country>EST</country>
                    <product>finances</product>
                    <delivery_term>o</delivery_term>
                    <preferable_finances> <!-- only neccasery for product: 'finances' -->
                        <item>2021</item>
                        <item>2020</item>
                    </preferable_finances>
                    <notification_of_completion>true</notification_of_completion>
                    <confirm_order>false</confirm_order>
                    <copy_notifiaction_to_other_emails>
                        <item>mail1@mail.com</item>
                    	<item>mail2@mail.com</item>
                    </copy_notifiaction_to_other_emails>
                    <company_details>
                        <search_result_id>60751300-4b72-451f-bf96-2a1a7cbe71c6</search_result_id>
                        <ref_code>YOUR REF CODE</ref_code> <!-- if you need it -->
                    </company_details>
                </order_details_by_id>
            </OrderReportRequest>
        </ns0:Order>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:OrderResponse>
            <OrderReportResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>EST</country>
                        <product>finances</product>
                        <delivery_term>o</delivery_term>
                        <preferable_finances>
                            <item>2021</item>
                            <item>2020</item>
                        </preferable_finances>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>00000000 EHITUS</business_name>
                            <reg_code>00000000</reg_code>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Awaiting Confirmation</order_status>
                </order_data>
                <last_duplicates>
                    <order_data>
                        <order_id>90000054</order_id>
                        <order_hash>ZJHhHYIbpUp2xtZM1Jqg5QQYmnrLo2E7p-J8uP7BUF5_G7BNu5J0-nNVxKOeIxun</order_hash>
                        <order_deadline>2019-09-09 </order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-09-09 13:02:32</request_time>
                        <order_details>
                            <country>EST</country>
                            <product>finances</product>
                            <delivery_term>o</delivery_term>
                            <preferable_finances>
                                <item>2020</item>
                                <item>2019</item>
                            </preferable_finances>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <business_name>00000000 EHITUS</business_name>
                                <reg_code>00000000</reg_code>
                                <ref_code>YOUR REF CODE</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Awaiting Confirmation</order_status>
                    </order_data>
                    <order_data>
                        <order_id>90000053</order_id>
                        <order_hash>X4Z6VL9KZd5bWsnWQ_NjdlfN2ix7M1jdwW_FrJ_IyIVKwkDipsx73dW3RMgVE8y0</order_hash>
                        <order_deadline>2019-08-02</order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-08-02 16:34:12</request_time>
                        <order_details>
                            <country>EST</country>
                            <product>finances</product>
                            <delivery_term>o</delivery_term>
                            <preferable_finances>
                                <item>2018</item>
                            </preferable_finances>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <business_name>00000000 EHITUS</business_name>
                                <reg_code>00000000</reg_code>
                                <ref_code>YOUR REF CODE</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Finished</order_status>
                    </order_data>
                </last_duplicates>
            </OrderReportResponse>
        </ns1:OrderResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

КРОК 4: Скасування замовлення (необов’язково)

Функція OrderCancellation
Якщо ви бажаєте скасувати замовлення, можете скористатися цією функцією OrderCancellation. Якщо замовлення вже виконується, скасувати його буде неможливо.
Приклади XML-запиту/відповіді дивіться за посиланням: Як скасувати замовлення?

КРОК 5: Підтвердження замовлення

Функція OrderConfirmation
Якщо ви не використали елемент "confirm_order", потрібно підтвердити замовлення.
Приклади XML-запиту/відповіді дивіться за посиланням: Як підтвердити замовлення?

КРОК 6: Перевірити статус замовлення

Функція ChkStatus
  • - Для онлайн-замовлень прийнятна частота перевірки статусу — раз на 5 секунд.

Для звітів використовуються наступні статуси:

  • У процесі виконання - Звіт на етапі виробництва
  • Очікує ідентифікації - Підготовка звіту призупинена. Потребує додаткових даних від клієнта.
  • Скасовано - Скасоване замовлення
  • Завершено - Звіт готовий
  • Оновлено - До готового звіту додано інформацію
  • Відхилено - Замовлення відхилено (недостатньо коштів, некоректні дані замовлення або інша причина).
  • Технічна помилка - У нашій системі сталася технічна помилка. Це означає, що ми проінформовані про цю помилку і будемо виправляти її якнайшвидше. Про те, коли Ви зможете отримати замовлення, Вас буде повідомлено додатково.

Якщо статус виконання Finished або Updated, ви можете отримати замовлення.

Приклади XML-запиту/відповіді дивіться за посиланням: Як перевірити статус замовлення?

КРОК 7: Отримати звіт

Функція GetReport
Список доступних мов: ar (Arabic), az (Azerbaijani), bg (Болгарська), cs (Чеська), da (Данська), de (Німецька), el (Грецька), en (Англійська мова), es (іспанська), et (естонська), fi (Фінська), fr (Французька), he (Hebrew), hi (Hindi), hu (угорська), hy (Armenian), id (Індонезійська), it (Італійська), ja (Японський), ka (Georgian), kk (Kazakh), ko (Корейська), lt (Литовська), lv (латвійська), mn (Mongolian), ms (Malay), nb (Норвезький Бокмоль), nl (Голландська), pl (Польська), pt (Португальська), ro (Румунська), ru (російська), sk (Словацька), sl (Словенська), sr (Српски), sv (Шведська), th (Thai), tr (Турецька), uk (Українська), uz (Uzbek), vi (Vietnamese), zh (Китайська)
Приклади XML-запиту/відповіді дивіться за посиланням: Як отримати готове замовлення?

Як завантажити стандартні звіти (у форматах, відмінних від XML)?


Типи стандартних продуктів: Basic Report, Mini Report, Linkages, Registration Data Report, Full report (private person), Short report (private person), Full report (with research), Financials (bank), Short Report, Real estate ownership search, Extended report, Full Report, KYC Report, Linked persons, Credit Opinion, Financial statements.

Запит складається з 3 частин:

  1. Фіксована частина https://www.infoproff.com/en/orders/files/
  2. Ваш унікальний хеш, який ми надаємо у відповідь
    <order_hash>
  3. І фіксована частина в кінці /report?&lang=en&doc_type=pdf&currency_position=left&preferred_currency=EUR
https://www.infoproff.com/en/orders/files/<order_hash>/report?&lang=en&doc_type=pdf&currency_position=left&preferred_currency=EUR
lang: en, et, ru, lv, ar, az, bg, cs, da, de, el, fi, fr, he, hi, hu, hy, id, it, ja, ka, kk, ko, lt, mn, ms, nl, nb, pl, pt, ro, sk, sl, es, sr, sv, th, tr, uk, uz, vi, zh
doc_type: pdf, html, docx, xlsx
currency_position: left, right
preferred_currency: XXX - Оригінальний (без обміну), EUR, USD, AUD, BGN, BRL, CAD, CHF, CNY, CZK, DKK, GBP, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, RUB, SEK, SGD, THB, TRY, ZAR

Як завантажити нестандартну продукцію?


Типи нестандартних продуктів: Marketing database (special offer), Site visit - non-capital city, Extract from registry, Site visit - capital city, Due Diligence, non-standard, Shareholder document, Memorandum of Association, Certificate of incorporation.

Запит складається з 3 частин:

  1. Фіксована частина https://www.infoproff.com/en/orders/files/
  2. Ваш унікальний хеш, який ми надаємо у відповідь
    <order_hash>
  3. І нерухома частина на кінці /download
https://www.infoproff.com/en/orders/files/<order_hash>/download

Як отримати кредитний висновок?


Функція CreditOpinionCalculator

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns0="http://infoproff.com/">
   <SOAP-ENV:Header />
   <SOAP-ENV:Body>
      <ns0:CreditOpinionCalculator>
         <CreditOpinionCalculatorRequest>
            <authentication_block>
               <username>XX</username>
               <password>XX</password>
            </authentication_block>
            <order_details>
               <country>XXX</country>
               <product>credit_opinion_calculator</product>
               <delivery_term>o</delivery_term>
               <lang>en</lang>
               <ref_code>test1</ref_code>
               <initial_data>
                  <general_data>
                     <status>REG</status>
                     <foundation>1996-11-13</foundation>
                     <nace2code>22.21</nace2code>
                     <employees>
                        <item>
                           <number_of_employees>236</number_of_employees>
                           <year>2018</year>
                           <period_end_date>2018-12-31</period_end_date>
                        </item>
                        <item>
                           <number_of_employees>216</number_of_employees>
                           <year>2017</year>
                           <period_end_date>2017-12-31</period_end_date>
                        </item>
                        <item>
                           <number_of_employees>210</number_of_employees>
                           <year>2016</year>
                           <period_end_date>2016-12-31</period_end_date>
                        </item>
                     </employees>
                  </general_data>
                  <debts>
                     <unpaid_debts>
                        <total_amount>100000000</total_amount>
                        <currency_name>EUR</currency_name>
                        <currency_exchange_rate_to_eur>1</currency_exchange_rate_to_eur>
                     </unpaid_debts>
                     <last_registered_debt>2020-01-15</last_registered_debt>
                  </debts>
                  <financial_elements>
                     <item>
                        <year>2018</year>
                        <period>12</period>
                        <currency>EUR</currency>
                        <scale>1</scale>
                        <currency_exchange_rate_to_eur>1</currency_exchange_rate_to_eur>
                        <period_start_date>2018-01-01</period_start_date>
                        <period_end_date>2018-12-31</period_end_date>
                        <positions>
                           <position>
                              <position_code>1000</position_code>
                              <value>29089411</value>
                           </position>
                           <position>
                              <position_code>1010</position_code>
                              <value>6556256</value>
                           </position>
                           <position>
                              <position_code>1020</position_code>
                              <value>20895813</value>
                           </position>
                           <position>
                              <position_code>1100</position_code>
                              <value>26347731</value>
                           </position>
                           <position>
                              <position_code>1110</position_code>
                              <value>6422249</value>
                           </position>
                           </position>
                           <position>
                              <position_code>1130</position_code>
                              <value>315255</value>
                           </position>
                           <position>
                              <position_code>1200</position_code>
                              <value>55437150</value>
                           </position>
                           <position>
                              <position_code>1300</position_code>
                              <value>13563874</value>
                           </position>
                           <position>
                              <position_code>1310</position_code>
                              <value>2141431</value>
                           </position>
                           <position>
                              <position_code>1400</position_code>
                              <value>41542005</value>
                           </position>
                           <position>
                              <position_code>1410</position_code>
                              <value>10780537</value>
                           </position>
                           <position>
                              <position_code>1420</position_code>
                              <value>30761468</value>
                           </position>
                           <position>
                              <position_code>1500</position_code>
                              <value>55437150</value>
                           </position>
                           <position>
                              <position_code>1600</position_code>
                              <value>32763727</value>
                           </position>
                           <position>
                              <position_code>1700</position_code>
                              <value>-11583299</value>
                           </position>
                           <position>
                              <position_code>1800</position_code>
                              <value>1852455</value>
                           </position>
                           <position>
                              <position_code>1900</position_code>
                              <value>4604983</value>
                           </position>
                           <position>
                              <position_code>2000</position_code>
                              <value>3876811</value>
                           </position>
                        </positions>
                     </item>
                     <item>
                        <year>2017</year>
                        <period>12</period>
                        <currency>EUR</currency>
                        <scale>1</scale>
                        <currency_exchange_rate_to_eur>1</currency_exchange_rate_to_eur>
                        <period_start_date>2017-01-01</period_start_date>
                        <period_end_date>2017-12-31</period_end_date>
                        <positions>
                           <position>
                              <position_code>1000</position_code>
                              <value>27956649</value>
                           </position>
                           <position>
                              <position_code>1010</position_code>
                              <value>6699710</value>
                           </position>
                           <position>
                              <position_code>1020</position_code>
                              <value>20784951</value>
                           </position>
                           <position>
                              <position_code>1100</position_code>
                              <value>13530424</value>
                           </position>
                           <position>
                              <position_code>1110</position_code>
                              <value>5848610</value>
                           </position>
                           <position>
                              <position_code>1120</position_code>
                              <value>7350656</value>
                           </position>
                           <position>
                              <position_code>1130</position_code>
                              <value>331158</value>
                           </position>
                           <position>
                              <position_code>1200</position_code>
                              <value>41487080</value>
                           </position>
                           <position>
                              <position_code>1300</position_code>
                              <value>13233015</value>
                           </position>
                           <position>
                              <position_code>1310</position_code>
                              <value>2141431</value>
                           </position>
                           <position>
                              <position_code>1400</position_code>
                              <value>28234892</value>
                           </position>
                           <position>
                              <position_code>1410</position_code>
                              <value>4000000</value>
                           </position>
                           <position>
                              <position_code>1420</position_code>
                              <value>24234892</value>
                           </position>
                           <position>
                              <position_code>1500</position_code>
                              <value>41487080</value>
                           </position>
                           <position>
                              <position_code>1600</position_code>
                              <value>38508619</value>
                           </position>
                           <position>
                              <position_code>1700</position_code>
                              <value>-13380841</value>
                           </position>
                           <position>
                              <position_code>1800</position_code>
                              <value>4020449</value>
                           </position>
                           <position>
                              <position_code>1900</position_code>
                              <value>3071074</value>
                           </position>
                           <position>
                              <position_code>2000</position_code>
                              <value>2211543</value>
                           </position>
                        </positions>
                     </item>
                     <item>
                        <year>2016</year>
                        <period>12</period>
                        <currency>EUR</currency>
                        <scale>1</scale>
                        <currency_exchange_rate_to_eur>1</currency_exchange_rate_to_eur>
                        <period_start_date>2016-01-01</period_start_date>
                        <period_end_date>2016-12-31</period_end_date>
                        <positions>
                           <position>
                              <position_code>1000</position_code>
                              <value>23098292</value>
                           </position>
                           <position>
                              <position_code>1010</position_code>
                              <value>6251447</value>
                           </position>
                           <position>
                              <position_code>1020</position_code>
                              <value>16338678</value>
                           </position>
                           <position>
                              <position_code>1100</position_code>
                              <value>11104261</value>
                           </position>
                           <position>
                              <position_code>1110</position_code>
                              <value>5111604</value>
                           </position>
                           <position>
                              <position_code>1120</position_code>
                              <value>4657457</value>
                           </position>
                           <position>
                              <position_code>1130</position_code>
                              <value>1335200</value>
                           </position>
                           <position>
                              <position_code>1200</position_code>
                              <value>34202560</value>
                           </position>
                           <position>
                              <position_code>1300</position_code>
                              <value>12554095</value>
                           </position>
                           <position>
                              <position_code>1310</position_code>
                              <value>2141431</value>
                           </position>
                           <position>
                              <position_code>1400</position_code>
                              <value>21617540</value>
                           </position>
                           <position>
                              <position_code>1410</position_code>
                              <value>2000000</value>
                           </position>
                           <position>
                              <position_code>1420</position_code>
                              <value>19617540</value>
                           </position>
                           <position>
                              <position_code>1500</position_code>
                              <value>34202560</value>
                           </position>
                           <position>
                              <position_code>1600</position_code>
                              <value>34392412</value>
                           </position>
                           <position>
                              <position_code>1700</position_code>
                              <value>-12182016</value>
                           </position>
                           <position>
                              <position_code>1800</position_code>
                              <value>2520984</value>
                           </position>
                           <position>
                              <position_code>1900</position_code>
                              <value>-335799</value>
                           </position>
                           <position>
                              <position_code>2000</position_code>
                              <value>-764980</value>
                           </position>
                        </positions>
                     </item>
                  </financial_elements>
               </initial_data>
            </order_details>
         </CreditOpinionCalculatorRequest>
      </ns0:CreditOpinionCalculator>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://infoproff.com/">
   <SOAP-ENV:Body>
      <ns1:CreditOpinionCalculatorResponse>
         <CreditOpinionCalculatorResponse>
            <order_data>
               <order_id>1444</order_id>
               <order_hash>MpfreVp7EFZ7piIMQykCnfevRjyDOKNuAi5uAvy3XHBVAKpMXsLD99URoYppb7Ry</order_hash>
               <order_deadline>2020-01-27</order_deadline>
               <price>1.5</price>
               <currency>EUR</currency>
               <request_time>2020-01-27 14:09:27</request_time>
               <order_status>Finished</order_status>
            </order_data>
            <credit_opinion>
               <language>en</language>
               <ref_code>test1</ref_code>
               <credit_opinion>
                  <item>
                     <credit_rating>CCC</credit_rating>
                     <rating_description>Risk above normal. Short term credit only.</rating_description>
                     <credit_limit>154000</credit_limit>
                     <credit_limit_currency>EUR</credit_limit_currency>
                     <latest_turnover_type>R12</latest_turnover_type>
                     <latest_turnover_range>20 000 001 - 50 000 000</latest_turnover_range>
                     <rating_explanation>
                        <explanation>Long-established company.</explanation>
                        <explanation>Latest turnover range 20 000 001 - 50 000 000 EUR.</explanation>
                        <explanation>The company had downfall in turnover during the known financial periods (at least once).</explanation>
                        <explanation>Within last years company's turnover had a slight decrease (growth rate).</explanation>
                        <explanation>Equity of the company is at a normal level.</explanation>
                        <explanation>Current ratio of the company is at a low level.</explanation>
                        <explanation>Quick ratio of the company is at a very low level.</explanation>
                        <explanation>Profitability of the company is at a very high level (in relation to equity).</explanation>
                     </rating_explanation>
                  </item>
               </credit_opinion>
            </credit_opinion>
         </CreditOpinionCalculatorResponse>
      </ns1:CreditOpinionCalculatorResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Як отримати додаткову інформацію?


Функція GetClassifiersFinancialStatements

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetClassifiersFinancialStatements>
            <GetClassifiersFinancialStatementsRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
            </GetClassifiersFinancialStatementsRequest>
        </ns0:GetClassifiersFinancialStatements>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:GetClassifiersFinancialStatementsResponse>
            <GetClassifiersFinancialStatementsResponse>
                <financial_statements>
                    <item>
                        <subtype_id>97</subtype_id>
                        <subtype_description>Income statement format 2</subtype_description>
                        <row_number>333100</row_number>
                        <row_formated_description>basic earnings (loss) per
                            share</row_formated_description>
                        <row_lang_key>6886</row_lang_key>
                        <row_order>340</row_order>
                    </item>
                    <item>
                        <subtype_id>97</subtype_id>
                        <subtype_description>Income statement format 2</subtype_description>
                        <row_number>323600</row_number>
                        <row_formated_description>interest income</row_formated_description>
                        <row_lang_key>3686</row_lang_key>
                        <row_order>170</row_order>
                    </item>
					...
                    <item>
                        <subtype_id>89</subtype_id>
                        <subtype_description>Financial key ratios</subtype_description>
                        <row_number>3080</row_number>
                        <row_formated_description>Quick ratio</row_formated_description>
                        <row_lang_key>7644</row_lang_key>
                        <row_order>80</row_order>
                    </item>
                    <item>
                        <subtype_id>89</subtype_id>
                        <subtype_description>Financial key ratios</subtype_description>
                        <row_number>3060</row_number>
                        <row_formated_description>Leverage</row_formated_description>
                        <row_lang_key>7541</row_lang_key>
                        <row_order>60</row_order>
                    </item>
                </financial_statements>
            </GetClassifiersFinancialStatementsResponse>
        </ns1:GetClassifiersFinancialStatementsResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetLegalForms>
            <GetLegalFormsRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
            </GetLegalFormsRequest>
        </ns0:GetLegalForms>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Body>
        <ns1:GetLegalFormsResponse>
            <GetLegalFormsResponse>
                <legal_forms>
                    <item>
                        <country>BLR</country>
                        <language>RUS</language>
                        <legal_form>Крестьянское (фермерское) хозяйство</legal_form>
                        <lang_key>268</lang_key>
                    </item>
                    <item>
                        <country>BLR</country>
                        <language>RUS</language>
                        <legal_form>Крестьянское хозяйство</legal_form>
                        <lang_key>268</lang_key>
                    </item>
                    <item>
                        <country>UKR</country>
                        <language>UKR</language>
                        <legal_form>Споживчий кооператив</legal_form>
                        <lang_key>264</lang_key>
                    </item>
                     <item>
                        <country>RUS</country>
                        <language>RUS</language>
                        <legal_form>АКЦИОНЕРНОЕ ОБЩЕСТВО</legal_form>
                        <lang_key>263</lang_key>
                    </item>
                </legal_forms>
            </GetLegalFormsResponse>
        </ns1:GetLegalFormsResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Функція GetActivityClassificators

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetActivityClassificators>
            <GetActivityClassificatorsRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
                <classificator_type>CLASSIFICATOR_TYPE</classificator_type>
            </GetActivityClassificatorsRequest>
        </ns0:GetActivityClassificators>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CLASSIFICATOR_TYPE:
"EMTAK 2008"
"NACE Rev.2"
"КВЕД 2005"
"КВЕД 2010"
"ОКВЭД 2"
"ОКВЭД 2007"
"SBI"

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:GetActivityClassificatorsResponse>
            <GetActivityClassificatorsResponse>
                <classificator_type>NACE Rev.2</classificator_type>
                <activities>
                    <item>
                        <activity_description>ACCOMMODATION AND FOOD SERVICE ACTIVITIES</activity_description>
                        <activity_code>I</activity_code>
                        <activity_language>ENG</activity_language>
                        <activity_lang_key>10673</activity_lang_key>
                    </item>
					...
                    <item>
                        <activity_description>HUMAN HEALTH AND SOCIAL WORK
                            ACTIVITIES</activity_description>
                        <activity_code>Q</activity_code>
                        <activity_language>ENG</activity_language>
                        <activity_lang_key>10858</activity_lang_key>
                    </item>
                 </activities>
            </GetActivityClassificatorsResponse>
        </ns1:GetActivityClassificatorsResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Функція GetDictionaryStandardPhrases

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetDictionaryStandardPhrases>
            <GetDictionaryStandardPhrasesRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
            </GetDictionaryStandardPhrasesRequest>
        </ns0:GetDictionaryStandardPhrases>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:GetDictionaryStandardPhrasesResponse>
            <GetDictionaryStandardPhrasesResponse>
                <dictionary_standard_phrases>
                    <item>
                        <dictionary_lang_key>6612</dictionary_lang_key>
                        <dictionary_category>opinion_comment</dictionary_category>
                        <dictionary_language>ENG</dictionary_language>
                        <dictionary_value>Company was in a merger process and financial statements
                            after merger are not available.</dictionary_value>
                    </item>
                    <item>
                        <dictionary_lang_key>101806</dictionary_lang_key>
                        <dictionary_category>asset_subtype</dictionary_category>
                        <dictionary_language>ENG</dictionary_language>
                        <dictionary_value>Property intended for varied purposes</dictionary_value>
                    </item>
					...
                    <item>
                        <dictionary_lang_key>252</dictionary_lang_key>
                        <dictionary_category>town_settlement_village_type</dictionary_category>
                        <dictionary_language>ENG</dictionary_language>
                        <dictionary_value>district</dictionary_value>
                    </item>
                    <item>
                        <dictionary_lang_key>254</dictionary_lang_key>
                        <dictionary_category>town_settlement_village_type</dictionary_category>
                        <dictionary_language>ENG</dictionary_language>
                        <dictionary_value>county</dictionary_value>
                    </item>
                </dictionary_standard_phrases>
            </GetDictionaryStandardPhrasesResponse>
        </ns1:GetDictionaryStandardPhrasesResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Функція GetAvailableProducts

delivery_term:

  1. "o" = "Online"
  2. "n" = "Normal"
  3. "f" = "Flash"
  4. "s" = "SuperFlash"

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetAvailableProducts>
            <GetAvailableProductsRequest>
                <authentication_block>
                    <username>XX</username>
                    <password>XX</password>
                </authentication_block>
            </GetAvailableProductsRequest>
        </ns0:GetAvailableProducts>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:GetAvailableProductsResponse>
            <GetAvailableProductsResponse>
                <available_products>
                    <item>
                        <country>RUS</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <full_description>Full Report (Normal)</full_description>
                        <maximum_delivery_working_days>7</maximum_delivery_working_days>
                        <price>28.00</price>
                    </item>
                    <item>
                        <country>SWE</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <full_description>Full Report (Normal)</full_description>
                        <maximum_delivery_working_days>0</maximum_delivery_working_days>
                        <price>25.00</price>
                    </item>
                    <item>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <full_description>Full Report (Normal)</full_description>
                        <maximum_delivery_working_days>0</maximum_delivery_working_days>
                        <price>25.00</price>
                    </item>
                </available_products>
            </GetAvailableProductsResponse>
        </ns1:GetAvailableProductsResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Можливі помилки


Ці помилки можуть виникнути при відправці запиту до нашого веб-сервісу.


Всі функції
  • Incorrect username/password or you have no permissions.
    Ви вводите неправильні облікові дані або ваш доступ до API заблоковано.

Функція SimpleSearch
  1. You don't have permissions to search in this country.
    Перелік доступних країн: Ізраїль (ISR), Ірландія (IRL), Ісландія (ISL), Іспанія (ESP), Італія (ITA), Австралія (AUS), Австрія (AUT), Азербайджан (AZE), Албанія (ALB), Алжир (DZA), Ангола (AGO), Аргентина (ARG), Бельгія (BEL), Бенін (BEN), Болгарія (BGR), Болівія (BOL), Боснія і Герцеговина (BIH), Ботсвана (BWA), Бразилія (BRA), Білорусь (BLR), Венесуела (VEN), Возз'єднання (REU), Гамбія (GMB), Гаяна (GUY), Гваделупа (GLP), Гвіана (GUF), Гвінея (GIN), Гонконг (HKG), Гренландія (GRL), Греція (GRC), Грузія (GEO), Данія (DNK), Джерсі (JEY), Еквадор (ECU), Естонія (EST), Ефіопія (ETH), Замбія (ZMB), Зімбабве (ZWE), Казахстан (KAZ), Канада (CAN), Кенія (KEN), Киргизстан (KGZ), Китай (CHN), Китай (TWN), Конго (COG), Косово (XXK), Кот-д'Івуар (CIV), Кіпр (CYP), Латвія (LVA), Литва (LTU), Люксембург (LUX), Ліхтенштейн (LIE), Маврикій (MUS), Мадагаскар (MDG), Майотта (MYT), Мальдіви (MDV), Мальта (MLT), Марокко (MAR), Мартиніка (MTQ), Мен (IMN), Молдова (MDA), Монако (MCO), Монголія (MNG), Намібія (NAM), Нова Зеландія (NZL), Норвегія (NOR), Нігерія (NGA), Нідерланди (NLD), Німеччина (DEU), Парагвай (PRY), Перу (PER), Польща (POL), Португалія (PRT), Південна Африка (ZAF), Росія (RUS), Руанда (RWA), Румунія (ROU), Самоа (WSM), Сан-Марино (SMR), Сейшельські острови (SYC), Сен-Мартен (MAF), Сербія (SRB), Словаччина (SVK), Словенія (SVN), Сполучене Королівство (GBR), Сінгапур (SGP), Таджикистан (TJK), Танзанія (TZA), Таїланд (THA), Того (TGO), Туреччина (TUR), Угорщина (HUN), Узбекистан (UZB), Україна (UKR), Уругвай (URY), Франція (FRA), Філіппіни (PHL), Фінляндія (FIN), Хорватія (HRV), Чехія (CZE), Чилі (CHL), Швейцарія (CHE), Швеція (SWE), Шрі-Ланка (LKA), Японія (JPN)
Функція Order
  1. This product is not available.
    Такого продукту не знайти і не замовити.
  2. You can't order report on company with legal form: "legal_form"
    Ця помилка стосується тільки: Швеція (SWE)
    У Швеції неможливо замовити звіт онлайн (delivery_term = "o") з наступними організаційно-правовими формами:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. When delivery term is Online, please use order_details_by_id with search_result_id.
    Ця помилка з’являється лише якщо ви намагаєтеся замовити онлайн-звіт без search_result_id.
    Важливо використовувати order_details_by_id в OrderReportRequest
  4. Business Name or Reg Code is required
    При замовленні офлайн звіту (delivery_term = "n", "f" або "s") обов'язковим є заповнення поля "Назва підприємства" або "Код ЄДРПОУ".
  5. Reg Code is required when delivery term is Online
    При замовленні онлайн звіту (delivery_term = "o") обов'язковим є "Reg Code".

Функція GetReport
  1. This language is not supported.
    Список доступних мов для онлайн-звітів: ar (Arabic), az (Azerbaijani), bg (Болгарська), cs (Чеська), da (Данська), de (Німецька), el (Грецька), en (Англійська мова), es (іспанська), et (естонська), fi (Фінська), fr (Французька), he (Hebrew), hi (Hindi), hu (угорська), hy (Armenian), id (Індонезійська), it (Італійська), ja (Японський), ka (Georgian), kk (Kazakh), ko (Корейська), lt (Литовська), lv (латвійська), mn (Mongolian), ms (Malay), nb (Норвезький Бокмоль), nl (Голландська), pl (Польська), pt (Португальська), ro (Румунська), ru (російська), sk (Словацька), sl (Словенська), sr (Српски), sv (Шведська), th (Thai), tr (Турецька), uk (Українська), uz (Uzbek), vi (Vietnamese), zh (Китайська)

Функції GetReport ChkStatus
  1. Incorrect order_id.
    Не вдається знайти ідентифікатор замовлення. Ви можете отримати ідентифікатор замовлення, скориставшись функцією Order.

Функція OrderCancellation
  1. Your order is already canceled.
    Ви більше не маєте права скасувати замовлення.

Функція 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 (версія 3) у порівнянні з SOAP (версія 2)


Зміни SOAP (версія 3) у порівнянні з SOAP (версія 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: Ізраїль (ISR), Ірландія (IRL), Ісландія (ISL), Іспанія (ESP), Італія (ITA), Австралія (AUS), Австрія (AUT), Азербайджан (AZE), Албанія (ALB), Алжир (DZA), Ангола (AGO), Аргентина (ARG), Бельгія (BEL), Бенін (BEN), Болгарія (BGR), Болівія (BOL), Боснія і Герцеговина (BIH), Ботсвана (BWA), Бразилія (BRA), Білорусь (BLR), Венесуела (VEN), Возз'єднання (REU), Гамбія (GMB), Гаяна (GUY), Гваделупа (GLP), Гвіана (GUF), Гвінея (GIN), Гонконг (HKG), Гренландія (GRL), Греція (GRC), Грузія (GEO), Данія (DNK), Джерсі (JEY), Еквадор (ECU), Естонія (EST), Ефіопія (ETH), Замбія (ZMB), Зімбабве (ZWE), Казахстан (KAZ), Канада (CAN), Кенія (KEN), Киргизстан (KGZ), Китай (CHN), Китай (TWN), Конго (COG), Косово (XXK), Кот-д'Івуар (CIV), Кіпр (CYP), Латвія (LVA), Литва (LTU), Люксембург (LUX), Ліхтенштейн (LIE), Маврикій (MUS), Мадагаскар (MDG), Майотта (MYT), Мальдіви (MDV), Мальта (MLT), Марокко (MAR), Мартиніка (MTQ), Мен (IMN), Молдова (MDA), Монако (MCO), Монголія (MNG), Намібія (NAM), Нова Зеландія (NZL), Норвегія (NOR), Нігерія (NGA), Нідерланди (NLD), Німеччина (DEU), Парагвай (PRY), Перу (PER), Польща (POL), Португалія (PRT), Південна Африка (ZAF), Росія (RUS), Руанда (RWA), Румунія (ROU), Самоа (WSM), Сан-Марино (SMR), Сейшельські острови (SYC), Сен-Мартен (MAF), Сербія (SRB), Словаччина (SVK), Словенія (SVN), Сполучене Королівство (GBR), Сінгапур (SGP), Таджикистан (TJK), Танзанія (TZA), Таїланд (THA), Того (TGO), Туреччина (TUR), Угорщина (HUN), Узбекистан (UZB), Україна (UKR), Уругвай (URY), Франція (FRA), Філіппіни (PHL), Фінляндія (FIN), Хорватія (HRV), Чехія (CZE), Чилі (CHL), Швейцарія (CHE), Швеція (SWE), Шрі-Ланка (LKA), Японія (JPN)

- 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: Ірландія (IRL), Іспанія (ESP), Італія (ITA), Австрія (AUT), Азербайджан (AZE), Бельгія (BEL), Болгарія (BGR), Греція (GRC), Данія (DNK), Естонія (EST), Казахстан (KAZ), Киргизстан (KGZ), Китай (CHN), Латвія (LVA), Люксембург (LUX), Мальта (MLT), Молдова (MDA), Монголія (MNG), Норвегія (NOR), Нідерланди (NLD), Німеччина (DEU), Польща (POL), Португалія (PRT), Росія (RUS), Словаччина (SVK), Словенія (SVN), Сполучене Королівство (GBR), Угорщина (HUN), Україна (UKR), Франція (FRA), Фінляндія (FIN), Хорватія (HRV), Чехія (CZE), Швейцарія (CHE), Швеція (SWE)

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

3) Function: GetReport

- Changes in of available languages: ar (Arabic), az (Azerbaijani), bg (Болгарська), cs (Чеська), da (Данська), de (Німецька), el (Грецька), en (Англійська мова), es (іспанська), et (естонська), fi (Фінська), fr (Французька), he (Hebrew), hi (Hindi), hu (угорська), hy (Armenian), id (Індонезійська), it (Італійська), ja (Японський), ka (Georgian), kk (Kazakh), ko (Корейська), lt (Литовська), lv (латвійська), mn (Mongolian), ms (Malay), nb (Норвезький Бокмоль), nl (Голландська), pl (Польська), pt (Португальська), ro (Румунська), ru (російська), sk (Словацька), sl (Словенська), sr (Српски), sv (Шведська), th (Thai), tr (Турецька), uk (Українська), uz (Uzbek), vi (Vietnamese), zh (Китайська)


Зміни SOAP (версія 3) у порівнянні з SOAP (версія 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

Нові елементи:

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

Webhooks Settings


Огляд

Веб-хук - це спосіб, за допомогою якого програма може надавати іншим програмам інформацію в режимі реального часу. Наша функція веб-хук реалізує HTTP-відгуки, налаштовані за допомогою URL-адреси. На цю URL-адресу надсилається HTTP POST-вантаж у форматі JSON щоразу, коли відбувається певна подія. У контексті нашого проекту ми розробили функцію webhook, щоб запускати певні події.

Налаштування веб-хука

Щоб налаштувати веб-хук для вашого додатку, перейдіть на сторінку налаштувань додатку і знайдіть розділ "Налаштування веб-хуків". І надайте наступну інформацію:

  1. "URL-адреса веб- хука" - це URL-адреса, на яку ваш сервер буде отримувати POST-запити веб-хука.
  2. " Максимальна кількість спроб доставки " - це параметр, який визначає максимальну кількість повторних спроб доставки події вебхука, якщо перша спроба доставки виявилася невдалою.
  3. "Тайм-аут повторної спроби доставки " - це налаштування, яке дозволяє вказати інтервал часу між повторними спробами, коли спроба доставки вебхука закінчується невдачею.

Після введення цих даних натисніть "Зберегти".

Типи подій веб-хука

  1. Новий статус замовлення

Корисне навантаження Webhook

Коли відбувається подія, ми надсилаємо HTTP POST-запит на URL-адресу корисного навантаження з тілом JSON, що містить інформацію про подію.

Ось приклад корисного навантаження:
Приклад корисного навантаження нового статусу замовлення

                {
                    "event_type": "new_status",
                    "order_id": "12345",
                    "client_ref_number": "98765",
                    "new_status": "Finished"
                    "reason": "..." # Optional, an example here could be the reason for the "Rejected" status
                }
            
Можливі значення поля "new_status":
  • "Finished" - замовлення сформовано. Замовлення можна забрати;
  • "Updated" - оновлено замовлення, додано дані до завершеного замовлення;
  • "Canceled" - замовлення скасовується на прохання (або за згодою) клієнта;
  • "Rejected" - замовлення відхиляється. Зазвичай через те, що неможливо ідентифікувати компанію.
  • "Identification pending" - нам потрібно більше інформації від клієнта, перш ніж ми зможемо підготувати замовлення..

Захист вебхуків

Важливо переконатися, що POST-запити, надіслані на URL-адресу корисного навантаження, походять від нашого додатка. Щоб допомогти вам у цьому, кожен запит веб-хука містить заголовок X-Signature.

Підпис Опис

Для підпису ми використовуємо HMAC з алгоритмом SHA512.

Секрет - це конкатенація ідентифікатора додатку та секретного ключа з налаштувань веб-хуків.


                #!/bin/bash

                payload='{"key1": "value1","key2": "value2"}'
                secret='$app_id$secret_key'

                # Generate HMAC SHA512 signature
                signature=$(echo -n "$payload" | openssl dgst -sha512 -hmac "$secret" | awk '{print $2}')

                # Send request
                curl -X POST \
                  -H "Content-Type: application/json" \
                  -H "X-Signature: $signature" \
                  -d "$payload" \
                  https://example.com/api/endpoint
            

Ви можете додати власні параметри get до кінцевої точки, щоб ідентифікувати відправника, якщо це необхідно.


                https://example.com/api/endpoint?custom_token=c3606e43c40d4556b64a4ad8c72f554e
            

Усунення несправностей

Сервер повинен відповісти протягом 10 секунд і повернути 2XX HTTP-код; в іншому випадку доставка вебхука вважається невдалою. У разі невдачі функція спробує повторно відправити запит відповідно до політики доставки.

© Документація API Infoproff 2026