Инфопрофф API құжаттамасы - 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 - Барлық financial documents элементтерін row_number, row_formated_description, row_lang_key және row_order мәндерімен алыңыз.
  • GetLegalForms - Барлық қолжетімді елдер үшін барлық заңды формаларды алыңыз.
  • GetActivityClassificators - Белгілі бір әрекет классификаторы үшін барлық кодтар мен сипаттамаларды алыңыз.
  • GetDictionaryStandardPhrases - Барлық стандартты тіркестерді кілттері мен тілімен алыңыз.
  • GetAvailableProducts - Қолжетімді өнімдер тізімін алыңыз.
  • CreditOpinionCalculator - Кредиттік пікір калькуляторы компанияға кредиттік пікір тағайындауға көмектеседі.

API бірнеше қызметтерді ұсынады:

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

Компанияны қалай іздеуге болады?

Компанияны іздеу 2 нұсқадан тұрады:

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

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.

Норвегия тіркеуі жойылған компанияларды атаулары бойынша іздеуге мүмкіндік бермейді. Сондықтан біз Норвегиядағы жойылған компаниялар бойынша атаулар бойынша қарапайым іздеу ұсына алмаймыз.

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: Австрия (AUT), Бельгия (BEL), Болгария (BGR), Венгрия (HUN), Германия (DEU), Грекия (GRC), Дания (DNK), Ирландия (IRL), Испания (ESP), Италия (ITA), Латвия (LVA), Люксембург (LUX), Мальта (MLT), Молдова (MDA), Моңғолия (MNG), Нидерланды (NLD), Норвегия (NOR), Польша (POL), Португалия (PRT), Ресей (RUS), Словакия (SVK), Словения (SVN), Финляндия (FIN), Франция (FRA), Хорватия (HRV), Чехия (CZE), Швейцария (CHE), Швеция (SWE), Эстония (EST), Қазақстан (KAZ), Қырғызстан (KGZ), Қытай (CHN), Ұлыбритания (GBR), Әзірбайжан (AZE)
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), az (Azerbaijani), bg (Болгар тілі), cs (Чех), da (Даниялық), de (Неміс), el (Грекше), en (Ағылшынша), es (Испанша), et (Эстондық), fi (Финдік), fr (Французша), he (Hebrew), hi (Hindi), hu (Венгр тілі), hy (Armenian), id (Индонезиялық), it (Итальяндық), ja (Жапонша), ka (Georgian), kk (Kazakh), ko (Корейше), lt (Литвалық), lv (Латвиялық), mn (Mongolian), ms (Malay), nb (Норвегиялық букмол), nl (Голландша), pl (Польша тілі), pt (Португалша), ro (Румынша), ru (Ресейлік), sk (Словакша), sl (Словениялық), sr (Српски), sv (Шведше), th (Thai), tr (Түрікше), uk (Украин тілі), uz (Uzbek), vi (Vietnamese), zh (Қытайша)

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), az (Azerbaijani), bg (Болгар тілі), cs (Чех), da (Даниялық), de (Неміс), el (Грекше), en (Ағылшынша), es (Испанша), et (Эстондық), fi (Финдік), fr (Французша), he (Hebrew), hi (Hindi), hu (Венгр тілі), hy (Armenian), id (Индонезиялық), it (Итальяндық), ja (Жапонша), ka (Georgian), kk (Kazakh), ko (Корейше), lt (Литвалық), lv (Латвиялық), mn (Mongolian), ms (Malay), nb (Норвегиялық букмол), nl (Голландша), pl (Польша тілі), pt (Португалша), ro (Румынша), ru (Ресейлік), sk (Словакша), sl (Словениялық), sr (Српски), sv (Шведше), th (Thai), tr (Түрікше), uk (Украин тілі), uz (Uzbek), vi (Vietnamese), zh (Қытайша)

Архивтелген несиелік есепті қалай сұратуға болады?

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), az (Azerbaijani), bg (Болгар тілі), cs (Чех), da (Даниялық), de (Неміс), el (Грекше), en (Ағылшынша), es (Испанша), et (Эстондық), fi (Финдік), fr (Французша), he (Hebrew), hi (Hindi), hu (Венгр тілі), hy (Armenian), id (Индонезиялық), it (Итальяндық), ja (Жапонша), ka (Georgian), kk (Kazakh), ko (Корейше), lt (Литвалық), lv (Латвиялық), mn (Mongolian), ms (Malay), nb (Норвегиялық букмол), nl (Голландша), pl (Польша тілі), pt (Португалша), ro (Румынша), ru (Ресейлік), sk (Словакша), sl (Словениялық), sr (Српски), sv (Шведше), th (Thai), tr (Түрікше), uk (Украин тілі), uz (Uzbek), vi (Vietnamese), zh (Қытайша)
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, 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

Стандартты емес өнімдерді қалай жүктеуге болады?

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.
    Қолжетімді елдер тізімі: Австралия (AUS), Австрия (AUT), Албания (ALB), Алжир (DZA), Ангола (AGO), Аргентина (ARG), Беларусь (BLR), Бельгия (BEL), Бенин (BEN), Болгария (BGR), Боливия (BOL), Босния және Герцеговина (BIH), Ботсвана (BWA), Бразилия (BRA), Венгрия (HUN), Венесуэла (VEN), Гайана (GUY), Гамбия (GMB), Гваделупа (GLP), Гвинея (GIN), Германия (DEU), Гонконг (HKG), Грекия (GRC), Гренландия (GRL), Грузия (GEO), Дания (DNK), Джерси (JEY), Жапония (JPN), Жаңа Зеландия (NZL), Замбия (ZMB), Зимбабве (ZWE), Израиль (ISR), Ирландия (IRL), Исландия (ISL), Испания (ESP), Италия (ITA), Канада (CAN), Кения (KEN), Кипр (CYP), Конго (COG), Косово (XXK), Кот-д'Ивуар (CIV), Латвия (LVA), Литва (LTU), Лихтенштейн (LIE), Люксембург (LUX), Маврикий (MUS), Мадагаскар (MDG), Майотта (MYT), Мальдив (MDV), Мальта (MLT), Марокко (MAR), Мартиника (MTQ), Молдова (MDA), Монако (MCO), Моңғолия (MNG), Мэн аралы (IMN), Намибия (NAM), Нигерия (NGA), Нидерланды (NLD), Норвегия (NOR), Оңтүстік Африка (ZAF), Парагвай (PRY), Перу (PER), Польша (POL), Португалия (PRT), Ресей (RUS), Реюньон (REU), Руанда (RWA), Румыния (ROU), Самоа (WSM), Сан-Марино (SMR), Сейшел (SYC), Сент-Мартен (MAF), Сербия (SRB), Сингапур (SGP), Словакия (SVK), Словения (SVN), Таиланд (THA), Тайвань (TWN), Танзания (TZA), Того (TGO), Тәжікстан (TJK), Уругвай (URY), Филиппин (PHL), Финляндия (FIN), Франция (FRA), Француз Гвианасы (GUF), Хорватия (HRV), Чехия (CZE), Чили (CHL), Швейцария (CHE), Швеция (SWE), Шри-Ланка (LKA), Эквадор (ECU), Эстония (EST), Эфиопия (ETH), Қазақстан (KAZ), Қырғызстан (KGZ), Қытай (CHN), Ұлыбритания (GBR), Әзірбайжан (AZE), Өзбекстан (UZB)
Функция 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") "Business Name" немесе "Reg Code" көрсету қажет.
  5. Reg Code is required when delivery term is Online
    Онлайн есепті тапсырыс берерде (delivery_term = "o") "Reg Code" талап етіледі.
Функция GetReport
  1. This language is not supported.
    Онлайн есептер үшін қолжетімді тілдер тізімі: ar (Arabic), az (Azerbaijani), bg (Болгар тілі), cs (Чех), da (Даниялық), de (Неміс), el (Грекше), en (Ағылшынша), es (Испанша), et (Эстондық), fi (Финдік), fr (Французша), he (Hebrew), hi (Hindi), hu (Венгр тілі), hy (Armenian), id (Индонезиялық), it (Итальяндық), ja (Жапонша), ka (Georgian), kk (Kazakh), ko (Корейше), lt (Литвалық), lv (Латвиялық), mn (Mongolian), ms (Malay), nb (Норвегиялық букмол), nl (Голландша), pl (Польша тілі), pt (Португалша), ro (Румынша), ru (Ресейлік), sk (Словакша), sl (Словениялық), sr (Српски), sv (Шведше), th (Thai), tr (Түрікше), uk (Украин тілі), uz (Uzbek), vi (Vietnamese), zh (Қытайша)
Функциялар GetReport ChkStatus
  1. Incorrect order_id.
    Тапсырыс идентификаторын табу мүмкін емес. Order функциясын пайдаланған кезде тапсырыс идентификаторын аласыз.
Функция OrderCancellation
  1. Your order is already canceled.
    Сізде тапсырысты енді жоюға рұқсат жоқ.
Функция OrderConfirmation
  1. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

SOAP (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
    xml-ph-0000@deepl.internal бөлімінде:
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

Шолу

Вебхук – бұл бір қосымшаның басқа қосымшаларға нақты уақыттағы ақпаратты беру тәсілі. Біздің вебхук мүмкіндігі URL арқылы конфигурацияланған HTTP кері шақыруларын жүзеге асырады. Белгіленген оқиға болған сайын HTTP POST жүктемесі JSON форматында осы URL-ге жіберіледі. Жобамыздың контекстінде вебхук функциясын нақты оқиғаларды іске қосу үшін жобаладық.

Вебхукты баптау

Қосымшаңызға вебхук орнату үшін қосымшаның баптаулар бетіне өтіп, «Вебхук баптаулары» бөлімін табыңыз. Содан кейін келесі ақпаратты енгізіңіз:

  1. «Webhook URL» — бұл сіздің серверіңіз webhook POST-өтініштерін алатын URL.
  2. «Жеткізудің максималды талпыныстары» — бастапқы жеткізу әрекеті сәтсіз болған кезде вебхук оқиғасын жеткізу үшін жасалатын қайталама талпыныстардың ең көп санын анықтайтын баптама.
  3. «Жеткізуді қайталауға арналған уақыт шегі» – вебхук жеткізу әрекеті сәтсіз болған кезде қайталаулар арасындағы уақыт аралығын көрсетуге мүмкіндік беретін баптау.

Осы мәліметтерді енгізгеннен кейін «Сақтау» түймесін басыңыз.

Вебхук оқиғаларының түрлері

  1. Тапсырыстың жаңа мәртебесі

Вебхук жүктемесі

Оқиға болған кезде біз оқиға туралы ақпаратты қамтитын JSON денесі бар HTTP POST сұранымын payload URL мекенжайына жібереміз.

Міне, мысал ретінде жүк:
Тапсырыстың жаңа мәртебесінің жүктеме мысалы
"new_status" өрісінің мүмкін мәндері:
  • "Finished" - тапсырыс аяқталды. Тапсырысты алуға болады;
  • "Updated" - тапсырыс жаңартылды, аяқталған тапсырысқа деректер қосылды;
  • "Canceled" - тапсырыс тұтынушының сұрауы бойынша (немесе келісімімен) жойылады;
  • "Rejected" - тапсырыс қабылданбайды. Әдетте компанияны анықтау мүмкін еместігінен.
  • "Identification pending" - тапсырысты дайындау үшін бізге тұтынушыдан қосымша ақпарат қажет..

Вебхуктеріңізді қорғау

Payload URL-ге жіберілген POST-сұраулардың біздің қосымшамыздан шыққанын тексеру маңызды. Осы мақсатта әрбір вебхук сұранымы X-Signature басылымын қамтиды.

Қолтаңба сипаттамасы

Қол қою үшін біз SHA512 алгоритмімен HMAC қолданамыз.

Құпия – вебхуктар баптауларындағы App ID мен Secret Key-дің біріктірілген жиынтығы.

Қажет болған жағдайда жіберушіні анықтау үшін endpoint-ке өз get параметрлеріңізді қосуға болады.

Ақауларды жою

Сервер 10 секунд ішінде жауап беріп, 2XX HTTP кодын қайтаруы тиіс; әйтпесе вебхук жеткізілуі сәтсіз деп есептеледі. Қателік болған жағдайда функция жеткізу саясатына сәйкес сұранысты қайта жіберуге тырысады.