Infoproff API Документация - v4


Начало работы


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

https://wsdfn.infoproff.com/v4/

Коллекция Postman (API v4) — готова к использованию:

https://www.postman.com/infoproff/infoproff-webservices/documentation/9kweer5/soap-api-v4

Postman предоставляет удобный способ тестировать наше API без необходимости писать код. Он также может автоматически генерировать примеры HTTP-запросов для большинства распространённых языков программирования.

Запросы, сформированные Postman, представляют собой базовые HTTP-вызовы, совместимые с нашим SOAP API. Однако для промышленной интеграции мы рекомендуем использовать полнофункциональные SOAP-клиенты, доступные в большинстве языков программирования. Такие клиенты могут работать напрямую с WSDL и XSD, автоматически обрабатывая схемы, типы данных и структуры сообщений.

Использование специализированного SOAP-клиента обеспечивает более надёжную и устойчивую интеграцию и снижает вероятность ошибок при формировании и разборе SOAP-сообщений.

Данные аутентификации

Основной метод аутентификации — HTTP Basic Auth. Предпочтительный и рекомендуемый подход — использование заголовка Authorization с закодированными учётными данными.

Значение username соответствует App ID, а password — связанному Secret Key. Эти значения создаются в разделе API Tokens панели пользователя и не связаны с учётными данными для входа на портал.

Механизм authentication_block, использовавшийся в предыдущих версиях API, по-прежнему поддерживается для обратной совместимости, но считается устаревшим и не должен применяться в новых интеграциях.

Функции веб-сервиса:

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

  • GetClassifiersFinancialStatements - Получить все финансовые документы со всеми элементами: row_number, row_formated_description, row_lang_key и row_order.
  • GetLegalForms - Получить все юридические формы для всех доступных стран.
  • GetActivityClassificators - Получить все коды и описания для конкретного классификатора деятельности.
  • GetDictionaryStandardPhrases - Получить все стандартные фразы с ключами и языком.
  • GetAvailableProducts - Получить список доступных продуктов.

  • CreditOpinionCalculator - Калькулятор кредитного мнения помогает назначить кредитное мнение о компании.

API предоставляет несколько сервисов:

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

Как искать компанию?


Поиск компании состоит из 2 вариантов:

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

Как заказать кредитный отчет?


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

Функция 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 (Норвежский (Bokmål)), 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 (версия 4) по сравнению с SOAP (версия 3)


Новые разделы

  • country_economic_overview — включают следующие подразделы: data_transparency_index, country_development_indicators, economic_forecast.
  • paid_taxes — информация об уплаченных налогах.
  • tenders — информация о тендерах.
  • sanctions — добавлено в раздел « negative_information ».

Обновления существующих разделов

В разделы « beneficiaries », « shareholders », « managers » и « employees_data » добавлен следующий элемент:
  • source_type — тип источника данных (например, official, mass_media, company_admin и т. д.).
В разделе « relations_of_persons » добавлен новый элемент:
  • match_type
Раздел « capital » был переструктурирован:
  • Элемент « capital_amount » был переименован в « issued_capital ».
  • Добавлены следующие новые элементы:
    • number_of_shares
    • share_value
    • authorized_capital
В разделе « employees_data »:
  • Новый элемент « group_figure » указывает, включают ли данные агрегированные показатели на уровне группы (true).
  • Элемент source_type указывает тип источника данных.
  • Элемент « is_estimated » теперь включается только в том случае, если его значение равно « true ».
Новый раздел « assets_data » — объединяет ранее существовавшие разделы:
  • real_estate_data (ранее называвшийся « property_data »), « vehicles » и « machinery_and_equipment » (ранее называвшийся « assets »).
  • Планируемые дополнения: « patents » и « biological_assets ».
В разделе « vehicles » добавлено новое поле:
  • value
В разделе « litigations » добавлены следующие элементы:
  • content, instance, process, authority
В financial_statement/positions и summary/latest_turnovers добавлен новый элемент:
  • value_origin — описывает происхождение значения; например, значение « estimated » — это значение оценивается и рассчитывается на основе доступных данных с использованием логики или искусственного интеллекта.
В разделе branches_data добавлены следующие поля:
  • registration_number
  • director_name

Примечание: на этапе стабилизации могут быть внесены незначительные улучшения и корректировки.

Webhooks Settings


Обзор

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

Настройка Webhook

Чтобы настроить веб-крючок для вашего приложения, перейдите на страницу настроек приложения и найдите раздел "Настройки веб-крючков". И укажите следующую информацию:

  1. "Webhook URL" - это URL, по которому ваш сервер будет получать POST-запросы веб-хуков.
  2. "Delivery max attempts" - это параметр, определяющий максимальное количество повторных попыток, которые должны быть предприняты для доставки события webhook при неудачной первой попытке доставки.
  3. "Таймаут повторной доставки" - это параметр, который позволяет указать интервал времени между повторными попытками, когда попытка доставки веб-крючка не удалась.

После ввода этих данных нажмите "Сохранить".

Типы событий Webhook

  1. Новый статус заказа

Полезная нагрузка вебхука

Когда произойдет событие, мы отправим 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.

Secret - это комбинация App ID и Secret Key из настроек вебхуков.


                #!/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 params для идентификации отправителя.


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

Устранение неполадок

Сервер должен ответить в течение 10 секунд и вернуть HTTP-код 2XX; в противном случае доставка webhook считается неудачной. В случае неудачи функция попытается повторно отправить запрос в соответствии с политикой доставки.