Инфопрофф 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 - Бүх санхүүгийн баримт бичгүүдийг row_number, row_formated_description, row_lang_key болон row_order бүхий бүх бүрэлдэхүүн хэсгүүдтэйгээр аваарай.
  • GetLegalForms - Боломжтой бүх орнуудын бүх хууль ёсны маягтуудыг аваарай.
  • GetActivityClassificators - Тодорхой үйл ажиллагааны ангилагчийн бүх код болон тайлбаруудыг аваарай.
  • GetDictionaryStandardPhrases - Бүх стандарт хэлц үгс, түлхүүрүүд болон хэлний хувилбаруудыг аваарай.
  • GetAvailableProducts - Боломжит бүтээгдэхүүнүүдийн жагсаалтыг аваарай.
  • CreditOpinionCalculator - Credit Opinion Calculator нь компанид зээлийн үнэлгээний санал тогтоох боломжийг олгодог.

API нь хэд хэдэн үйлчилгээг санал болгодог:

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

Компанийг хэрхэн хайх вэ?

Компанийн хайлт нь 2 сонголттой:

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

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

Хэрэв гүйцэтгэлийн статус {дууссан} эсвэл {шинэчлэгдсэн} бол та захиалгыг авч болно.

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 - Манай системд техникийн алдаа гарлаа. Энэ нь бид энэ алдааг мэдэж байгаа бөгөөд аль болох хурдан засна гэсэн үг. Захиалгыг хүлээн авах боломжтой болсон үед танд мэдэгдэнэ.

Хэрэв гүйцэтгэлийн статус {дууссан} эсвэл {шинэчлэгдсэн} бол та захиалгыг авч болно.

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

Вебхук тохируулах

Таны програмын webhook-ийг тохируулахын тулд програмын тохиргооны хуудас руу орж, 'Webhooks Settings' хэсгийг хайж олно. Дараах мэдээллийг өгнө үү:

  1. "Webhook URL" нь таны сервер webhook POST хүсэлтүүдийг хүлээн авах URL хаяг юм.
  2. "Delivery max attempts" нь анхны хүргэлтийн оролдлого бүтэлгүйтсэн тохиолдолд вэбхук үйл явдлыг хүргэхэд хийх дахин оролдлогын хамгийн их тоог тодорхойлдог тохиргоо юм.
  3. "Delivery retry timeout" нь вэбхук хүргэлтийн оролдлого амжилтгүй болсон үед дахин оролдох хоорондох хугацааны зайг зааж өгөх тохиргоо юм.

Эдгээр мэдээллийг оруулсны дараа 'Хадгалах' товчийг дарна уу.

Вебхук үйл явдлын төрөлүүд

  1. Захиалгын шинэ статус

Вебхукын ачаа

Үйл явдал тохиолдох үед бид үйл явдлын талаарх мэдээллийг агуулсан JSON биетэй HTTP POST хүсэлтийг payload URL хаягаар илгээнэ.

Энд нэг жишээ ачаа байна:
Захиалгын шинэ статусын ачаа тээврийн жишээ
"new_status" талбарын боломжит утгууд:
  • "Finished" - Захиалга бүрэн болсон. Захиалгыг авч болно.;
  • "Updated" - захиалга шинэчлэгдсэн, дууссан захиалгад өгөгдөл нэмэгдсэн;
  • "Canceled" - захиалгыг үйлчлүүлэгчийн хүсэлтээр (эсвэл зөвшөөрлөөр) цуцлана;
  • "Rejected" - захиалгыг няцаасан байна. Ихэвчлэн компанийг тодорхойлох боломжгүй байдаг учир.
  • "Identification pending" Бид захиалгыг бэлдэхийн өмнө үйлчлүүлэгчээс илүү мэдээлэл авах шаардлагатай байна..

Вэбхукүүдийнхээ аюулгүй байдлыг хангах

Payload URL-д илгээсэн POST хүсэлтүүд манай програмаас ирж байгааг баталгаажуулах нь чухал. Үүнд туслахын тулд бүх webhook хүсэлт X-Signature толгой мэдээллийг агуулдаг.

Гар бичгийн тайлбар

Гарын үсэг зурхад бид SHA512 алгоритмтай HMAC-ийг ашигладаг.

Нууц нь вэбхук тохиргооноос авсан App ID болон Нууц түлхүүрийн нийлбэр юм.

Шаардлагатай бол илгээгчийг тодорхойлохын тулд endpoint-д өөрийн get param-уудыг нэмэх боломжтой.

Алдаа оношлох

Сервер 10 секундын дотор хариу өгч, 2XX HTTP код буцаах ёстой; эс бөгөөс webhook илгээлт амжилтгүйд тооцогдоно. Амжилтгүй болсон тохиолдолд уг функц дахин илгээх бодлогын дагуу хүсэлтийг дахин илгээх оролдлого хийнэ.