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

Версія перемикача V4

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

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

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

Postman Collection (API v4) — Ready for Use:

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

Postman provides a convenient way to test our API without the need to write any code. It can also automatically generate example HTTP requests for most common programming languages.

The requests generated by Postman are basic HTTP calls compatible with our SOAP API. However, for production-grade integration, we recommend using fully featured SOAP clients available in most programming languages. These clients can work directly with WSDL and XSD, automatically handling schemas, data types, and message structures.

Using a dedicated SOAP client ensures a more reliable and robust integration, reducing the likelihood of errors when constructing and parsing SOAP messages.

Authentification details

The primary authentication method is HTTP Basic Auth. Using the Authorization header with encoded credentials is the preferred and recommended approach.

The username corresponds to the App ID, and the password is the associated Secret Key. These values are generated in the API Tokens section of the user dashboard and are not related to the credentials used for logging into the portal.

The authentication_block mechanism, used in previous API versions, is still supported for backward compatibility but is considered deprecated and should not be used in new integrations.

Web service functions:

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

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

  1. Кредитні звіти онлайн для наступних країн: Фінляндська Республіка (FIN), Королівство Швеція (SWE), Королівство Бельгія (BEL), Королівство Нідерландів (NLD), Естонська Республіка (EST), Республіка Казахстан (KAZ), Республіка Польща (POL), Киргизька Республіка (KGZ), Китайська Народна Республіка (CHN), Монголія (MNG)
  2. Офлайн звіти для наступних країн: Всі країни
  3. Калькулятор кредитної історії

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

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

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

The search for other countries is performed only in the database of archived reports. If you do not find the desired company, enter the company details manually.

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

search_result_id can be acquired here for orders with delivery_term = "o" or delivery_term = "a".

It may take up to 20 seconds to respond to a search request in the following countries: United Kingdom, Ireland, France, Spain, Portugal, Germany, Italy, Austria, Switzerland.

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

Field's length:
company_name varchar(512)
company_code varchar(64)

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

Функція SimpleSearch

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

Функція SimpleSearch

Option 3: Search by query (by name or code)

Функція UnifiedSearch

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

List of available countries for online credit reports: Ірландія (IRL), Італійська Республіка (ITA), Австрійська Республіка (AUT), Азербайджанська Республіка (AZE), Велике Герцогство Люксембург (LUX), Грецька Республіка (GRC), Естонська Республіка (EST), Киргизька Республіка (KGZ), Китайська Народна Республіка (CHN), Королівство Іспанія (ESP), Королівство Бельгія (BEL), Королівство Данія (DNK), Королівство Норвегія (NOR), Королівство Нідерландів (NLD), Королівство Швеція (SWE), Латвійська Республіка (LVA), Монголія (MNG), Португальська Республіка (PRT), Республіка Болгарія (BGR), Республіка Казахстан (KAZ), Республіка Мальта (MLT), Республіка Молдова (MDA), Республіка Польща (POL), Республіка Словенія (SVN), Республіка Хорватія (HRV), Російська Федерація (RUS), Словацька Республіка (SVK), Сполучене Королівство Великої Британії та Північної Ірландії (GBR), Угорська Республіка (HUN), Федеративна Республіка Німеччина (DEU), Французька Республіка (FRA), Фінляндська Республіка (FIN), Чеська Республіка (CZE), Швейцарська Конфедерація (CHE)
Field's length:
business_name varchar(512)
reg_code varchar(64)
vat_code varchar(64)
address varchar(512)
phone varchar(256)
email varchar(256)
additional_info varchar(512)
ref_code varchar(64)

Below you can find the example of how to order and download reports:

STEP 1: Find a company (Online/Offline Order (with search_result_id))

Функція SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Як шукати компанію?

The search allows you to accurately identify the company you wish to place an order for. For example, in some countries, there may be several companies with one registration number, or the same official name may belong to several companies.

STEP 2: Order a report (Online/Offline Order (with search_result_id))

Функція Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 3: Order cancellation (Optional) (Online/Offline Order (with search_result_id))

Функція OrderCancellation
If you wish to cancel the order, you can use this OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

STEP 4: Order confirmation (Online/Offline Order (with search_result_id))

Функція OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.

STEP 5: Check order status (Online/Offline Order (with search_result_id))

Функція ChkStatus
  • - For offline orders checking order status once every 30 minutes is acceptable frequency.
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

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

  • У процесі виконання - Звіт на етапі виробництва
  • Identification pending - Підготовка звіту призупинена. Потребує додаткових даних від клієнта.
  • Canceled - Скасоване замовлення
  • Finished - Звіт готовий
  • Updated - До готового звіту додано інформацію
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - У нашій системі сталася технічна помилка. Це означає, що ми проінформовані про цю помилку і будемо виправляти її якнайшвидше. Про те, коли Ви зможете отримати замовлення, Вас буде повідомлено додатково.

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

STEP 6: Get report (Online/Offline Order (with search_result_id))

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

STEP 1: Order a report (Offline Order (without search_result_id))

Функція Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 2: Order cancellation (Optional) (Offline Order (without search_result_id))

Функція OrderCancellation
If you wish to cancel the order, you can use OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

STEP 3: Order confirmation (Offline Order (without search_result_id))

Функція OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.

STEP 4: Status Checking (Offline Order (without search_result_id))

Функція ChkStatus
For offline orders checking order status once every 30 minutes is acceptable frequency.

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

  • У процесі виконання - Звіт на етапі виробництва
  • Identification pending - Підготовка звіту призупинена. Потребує додаткових даних від клієнта.
  • Canceled - Скасоване замовлення
  • Finished - Звіт готовий
  • Updated - До готового звіту додано інформацію
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - У нашій системі сталася технічна помилка. Це означає, що ми проінформовані про цю помилку і будемо виправляти її якнайшвидше. Про те, коли Ви зможете отримати замовлення, Вас буде повідомлено додатково.

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

STEP 5: Get report (Offline Order (without search_result_id))

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

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

Purchase of an archived report is available for all countries.

Below you can find the example of how to order and download archived reports:

STEP 1: Find a company

Функція SimpleSearch

To order an archived report you need to receive "<search_result_id>" which has an "<archived_reports>" section that contains a product you need.
To do so, please follow the link: Як шукати компанію?

Example companies with archived reports:

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

STEP 2: Order a report

Функція Order

STEP 3: Order cancellation (Optional)

Just like the online/offline reports.

STEP 4: Order confirmation

Just like the online/offline reports.

STEP 5: Check order status

Just like the online/offline reports.

For archived orders checking order status once every 5 seconds is acceptable frequency.

STEP 6: Get report

Just like the online/offline reports.

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

STEP 1: Find a company

Функція SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Як шукати компанію?

The search allows you to accurately identify the company you wish to place an order for. For example, in some countries, there may be several companies with one registration number, or the same official name may belong to several companies.

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

Функція ChkFinance

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

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

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

Функція Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 4: Order cancellation (Optional)

Функція OrderCancellation
If you wish to cancel the order, you can use this OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.
To see the examples of xml request/response, please follow the link: How to cancel the order?

STEP 5: Order confirmation

Функція OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.
To see the examples of xml request/response, please follow the link: How to confirm the order?

STEP 6: Check order status

Функція ChkStatus
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

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

  • У процесі виконання - Звіт на етапі виробництва
  • Identification pending - Підготовка звіту призупинена. Потребує додаткових даних від клієнта.
  • Canceled - Скасоване замовлення
  • Finished - Звіт готовий
  • Updated - До готового звіту додано інформацію
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - У нашій системі сталася технічна помилка. Це означає, що ми проінформовані про цю помилку і будемо виправляти її якнайшвидше. Про те, коли Ви зможете отримати замовлення, Вас буде повідомлено додатково.

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

To see the examples of xml request/response, please follow the link: How to check order status?

STEP 7: Get report

Функція GetReport
Список доступних мов: ar (Arabic), bg (Болгарська), cs (Чеська), da (Данська), de (Німецька), el (Грецька), en (Англійська мова), es (іспанська), et (естонська), fi (Фінська), fr (Французька), he (Hebrew), hu (угорська), id (Індонезійська), it (Італійська), ja (Японський), ko (Корейська), lt (Литовська), lv (латвійська), nb (Норвезький Бокмоль), nl (Голландська), pl (Польська), pt (Португальська), ro (Румунська), ru (російська), sk (Словацька), sl (Словенська), sr (Српски), sv (Шведська), th (Thai), tr (Турецька), uk (Українська), vi (Vietnamese), zh (Китайська)
To see the examples of xml request/response, please follow the link: How to get finished order?

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

Types of standard product: 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. Ваш унікальний хеш, який ми надаємо у відповідь
  3. And fixed part at the end /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, bg, cs, da, de, el, fi, fr, he, hu, id, it, ja, ko, lt, nl, nb, pl, pt, ro, sk, sl, es, sr, sv, th, tr, uk, 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

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

Types of non-standard product: 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. Fixed part https://www.infoproff.com/en/orders/files/
  2. Ваш унікальний хеш, який ми надаємо у відповідь
  3. І нерухома частина на кінці /download

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

Функція CreditOpinionCalculator

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

Функція GetClassifiersFinancialStatements
Функція GetActivityClassificators
Функція GetDictionaryStandardPhrases
Функція GetAvailableProducts

delivery_term:

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

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

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

Всі функції
  • Incorrect username/password or you have no permissions.
    Ви вводите неправильні облікові дані або ваш доступ до API заблоковано.
Функція SimpleSearch
  1. You don't have permissions to search in this country.
    Перелік доступних країн: Ірландія (IRL), Італійська Республіка (ITA), Австралійський Союз (AUS), Австрійська Республіка (AUT), Азербайджанська Республіка (AZE), Алжирська Народна Демократична Республіка (DZA), Аргентинська Республіка (ARG), Багатонаціональна Держава Болівія (BOL), Бейлівік Джерсі (JEY), Боліваріанська Республіка Венесуела (VEN), Боснія і Герцеговина (BIH), Велике Герцогство Люксембург (LUX), Возз'єднання (REU), Гваделупа (GLP), Гвінейська Республіка (GIN), Гонконг (HKG), Гренландія (GRL), Грецька Республіка (GRC), Грузія (GEO), Демократична Соціалістична Республіка Шрі-Ланка (LKA), Держава Ізраїль (ISR), Естонська Республіка (EST), Канада (CAN), Киргизька Республіка (KGZ), Китайська Народна Республіка (CHN), Китайська Народна Республіка (TWN), Князівство Ліхтенштейн (LIE), Князівство Монако (MCO), Колектив Сен-Мартен (MAF), Кооперативна Республіка Гайана (GUY), Королівство Іспанія (ESP), Королівство Бельгія (BEL), Королівство Данія (DNK), Королівство Марокко (MAR), Королівство Норвегія (NOR), Королівство Нідерландів (NLD), Королівство Таїланд (THA), Королівство Швеція (SWE), Косово (XXK), Кот-д'Івуар (CIV), Латвійська Республіка (LVA), Литовська Республіка (LTU), Майотта (MYT), Мальдівська Республіка (MDV), Мартиніка (MTQ), Монголія (MNG), Незалежна Держава Самоа (WSM), Нова Зеландія (NZL), Об'єднана Республіка Танзанія (TZA), Острів Мен (IMN), Португальська Республіка (PRT), Південно-Африканська Республіка (ZAF), Республіка Ісландія (ISL), Республіка Албанія (ALB), Республіка Ангола (AGO), Республіка Бенін (BEN), Республіка Болгарія (BGR), Республіка Ботсвана (BWA), Республіка Білорусь (BLR), Республіка Гамбія (GMB), Республіка Еквадор (ECU), Республіка Замбія (ZMB), Республіка Зімбабве (ZWE), Республіка Казахстан (KAZ), Республіка Кенія (KEN), Республіка Конго (COG), Республіка Кіпр (CYP), Республіка Маврикій (MUS), Республіка Мадагаскар (MDG), Республіка Мальта (MLT), Республіка Молдова (MDA), Республіка Намібія (NAM), Республіка Парагвай (PRY), Республіка Перу (PER), Республіка Польща (POL), Республіка Руанда (RWA), Республіка Сан-Марино (SMR), Республіка Сейшельські острови (SYC), Республіка Сербія (SRB), Республіка Словенія (SVN), Республіка Сінгапур (SGP), Республіка Таджикистан (TJK), Республіка Узбекистан (UZB), Республіка Філіппіни (PHL), Республіка Хорватія (HRV), Республіка Чилі (CHL), Російська Федерація (RUS), Румунія (ROU), Словацька Республіка (SVK), Сполучене Королівство Великої Британії та Північної Ірландії (GBR), Східна Республіка Уругвай (URY), Тоголезька Республіка (TGO), Угорська Республіка (HUN), Федеративна Демократична Республіка Ефіопія (ETH), Федеративна Республіка Бразилія (BRA), Федеративна Республіка Нігерія (NGA), Федеративна Республіка Німеччина (DEU), Французька Гвіана (GUF), Французька Республіка (FRA), Фінляндська Республіка (FIN), Чеська Республіка (CZE), Швейцарська Конфедерація (CHE), Японія (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.
    This error only appears if you are trying to order online report without search_result_id.
    It is important yo use order_details_by_id in OrderReportRequest
  4. Business Name or Reg Code is required
    При замовленні офлайн звіту (delivery_term = "n", "f" або "s") обов'язковим є заповнення поля "Назва підприємства" або "Код ЄДРПОУ".
  5. Reg Code is required when delivery term is Online
    При замовленні онлайн звіту (delivery_term = "o") обов'язковим є "Reg Code".
Функція GetReport
  1. This language is not supported.
    Список доступних мов для онлайн-звітів: ar (Arabic), bg (Болгарська), cs (Чеська), da (Данська), de (Німецька), el (Грецька), en (Англійська мова), es (іспанська), et (естонська), fi (Фінська), fr (Французька), he (Hebrew), hu (угорська), id (Індонезійська), it (Італійська), ja (Японський), ko (Корейська), lt (Литовська), lv (латвійська), nb (Норвезький Бокмоль), nl (Голландська), pl (Польська), pt (Португальська), ro (Румунська), ru (російська), sk (Словацька), sl (Словенська), sr (Српски), sv (Шведська), th (Thai), tr (Турецька), uk (Українська), 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

Огляд

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

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

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

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

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

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

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

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

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

Ось приклад корисного навантаження:
Приклад корисного навантаження нового статусу замовлення
Можливі значення поля "new_status":
  • "Finished" - замовлення сформовано. Замовлення можна забрати;
  • "Updated" - оновлено замовлення, додано дані до завершеного замовлення;
  • "Canceled" - замовлення скасовується на прохання (або за згодою) клієнта;
  • "Rejected" - замовлення відхиляється. Зазвичай через те, що неможливо ідентифікувати компанію.
  • "Identification pending" - нам потрібно більше інформації від клієнта, перш ніж ми зможемо підготувати замовлення..

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

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

Підпис Опис

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

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

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

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

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