Инфопрофф АПИ документација - v4

Промени верзију V4

Почетак

Веб сервис всдл и шеме се налазе овде:

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 - Преузмите све финансијске документе са свим елементима: ров_нумбер, ров_форматед_десцриптион, ров_ланг_кеи и ров_ордер.
  • GetLegalForms - Преузмите све правне форме за све доступне земље.
  • GetActivityClassificators - Набавите све кодове и описе за специфичне класификаторе делатности.
  • GetDictionaryStandardPhrases - Преузмите све стандардне фразе са тастерима и језиком.
  • GetAvailableProducts - Добијте листу доступних производа.
  • CreditOpinionCalculator - Калкулатор кредитног мишљења помаже да се додели кредитно мишљење о компанији.

АПИ пружа неколико услуга:

  1. Онлине кредитни извештаји за следеће земље: Република Финска (FIN), Краљевина Шведска (SWE), Краљевина Белгија (BEL), Краљевина Холандија (NLD), Републике Естоније (EST), Република Казахстан (KAZ), Република Пољска (POL), Киргиз Републиц (KGZ), Народна Република Кина (CHN), Монголија (MNG)
  2. Офлајн извештаји за следеће земље: Све земље
  3. Калкулатор кредитног мишљења

Како тражити компанију?

Претрага предузећа се састоји од 2 опције:

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

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: Велико војводство Луксембург (LUX), Ирска (IRL), Италијанска Република (ITA), Киргиз Републиц (KGZ), Краљевина Белгија (BEL), Краљевина Данска (DNK), Краљевина Норвешка (NOR), Краљевина Холандија (NLD), Краљевина Шведска (SWE), Краљевина Шпанија (ESP), Монголија (MNG), Народна Република Кина (CHN), Португалска Република (PRT), Република Азербејџан (AZE), Република Бугарска (BGR), Република Казахстан (KAZ), Република Летонија (LVA), Република Малта (MLT), Република Молдавија (MDA), Република Пољска (POL), Република Словачка (SVK), Република Финска (FIN), Републике Аустрије (AUT), Републике Естоније (EST), Републике Мађарске (HUN), Републике Словеније (SVN), Републике Хрватске (HRV), Руска Федерација (RUS), Уједињено Краљевство Велике Британије и Северне Ирске (GBR), Федеративна Република Немачка (DEU), Француска Република (FRA), Хеллениц Републиц (GRC), Чешка (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?

Како преузети стандардне извештаје (у форматима који нису КСМЛ)?

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. Фиксни део хттпс://ввв.инфопрофф.цом/ен/ордерс/филес/
  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.
    Уносите погрешне акредитиве или је ваш приступ АПИ-ју блокиран.
Функција SimpleSearch
  1. You don't have permissions to search in this country.
    Листа доступних земаља: Јапан (JPN), Јужноафричка Република (ZAF), Аргентинска република (ARG), Баиливицк оф Јерсеи (JEY), Боливарска Република Венецуела (VEN), Босна и Херцеговина (BIH), Велико војводство Луксембург (LUX), Вишенационална држава Боливија (BOL), Георгиа (GEO), Гренланд (GRL), Гуаделоупе (GLP), Демократска Социјалистичка Република Шри Ланка (LKA), Ирска (IRL), Исле оф Ман (IMN), Источна Република Уругвај (URY), Италијанска Република (ITA), Канада (CAN), Киргиз Републиц (KGZ), Кнежевина Лихтенштајн (LIE), Кнежевина Монако (MCO), Колектив Светог Мартина (MAF), Кооперативна Република Гвајана (GUY), Косово (XXK), Краљевина Белгија (BEL), Краљевина Данска (DNK), Краљевина Мароко (MAR), Краљевина Норвешка (NOR), Краљевина Тајланд (THA), Краљевина Холандија (NLD), Краљевина Шведска (SWE), Краљевина Шпанија (ESP), Маиотте (MYT), Мартиник (MTQ), Монголија (MNG), Народна Демократска Република Алжир (DZA), Народна Република Кина (CHN), Независна Држава Самоа (WSM), Нови Зеланд (NZL), Обала Слоноваче (CIV), Португалска Република (PRT), Република Азербејџан (AZE), Република Албанија (ALB), Република Ангола (AGO), Република Белорусија (BLR), Република Бенин (BEN), Република Боцвана (BWA), Република Бугарска (BGR), Република Гамбија (GMB), Република Гвинеја (GIN), Република Еквадор (ECU), Република Замбија (ZMB), Република Зимбабве (ZWE), Република Исланд (ISL), Република Казахстан (KAZ), Република Кенија (KEN), Република Кина (TWN), Република Кипар (CYP), Република Конго (COG), Република Летонија (LVA), Република Литванија (LTU), Република Мадагаскар (MDG), Република Малдиви (MDV), Република Малта (MLT), Република Маурицијус (MUS), Република Молдавија (MDA), Република Намибија (NAM), Република Парагвај (PRY), Република Перу (PER), Република Пољска (POL), Република Руанда (RWA), Република Сан Марино (SMR), Република Сејшели (SYC), Република Сингапур (SGP), Република Словачка (SVK), Република Србија (SRB), Република Таџикистан (TJK), Република Узбекистан (UZB), Република Филипини (PHL), Република Финска (FIN), Република Чиле (CHL), Републике Аустрије (AUT), Републике Естоније (EST), Републике Мађарске (HUN), Републике Словеније (SVN), Републике Хрватске (HRV), Реунион (REU), Румунија (ROU), Руска Федерација (RUS), Савезна Демократска Република Етиопија (ETH), Савезна Република Нигерија (NGA), Тоголесе Републиц (TGO), Уједињена Република Танзанија (TZA), Уједињено Краљевство Велике Британије и Северне Ирске (GBR), Федеративна Република Бразил (BRA), Федеративна Република Немачка (DEU), Федерација Аустралије (AUS), Француска Гвајана (GUF), Француска Република (FRA), Хеллениц Републиц (GRC), Хонг Конг (HKG), Чешка (CZE), Швајцарска конфедерација (CHE), држава Израел (ISR)
Функција Order
  1. This product is not available.
    Такав производ се не може наћи и није могуће наручити.
  2. You can't order report on company with legal form: "legal_form"
    Ова грешка се односи само на: Краљевина Шведска (SWE)
    У Шведској није могуће наручити онлајн извештај (деливери_терм = "о") са следећим правним формама:
    • 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
    Приликом наручивања офлајн извештаја (деливери_терм = "н", "ф" или "с") "Назив предузећа" или "Рег Цоде" је обавезан.
  5. Reg Code is required when delivery term is Online
    Приликом наручивања онлајн извештаја (деливери_терм = "о") "Рег Цоде" је обавезан.
Функција 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

Преглед

Веб-хук је начин на који апликација пружа информације у реалном времену другим апликацијама. Наша вебхоок функција имплементира ХТТП повратне позиве конфигурисане са УРЛ-ом. Корисно оптерећење ХТТП ПОСТ-а се шаље на ову УРЛ адресу у ЈСОН формату кад год се деси одређени догађај. У контексту нашег пројекта, дизајнирали смо вебхоок функцију за покретање одређених догађаја.

Подешавање Вебхоок-а

Да бисте подесили веб-хук за своју апликацију, идите на страницу са подешавањима апликације и потражите одељак „Подешавања веб-хука“. И пружите следеће информације:

  1. „Вебхоок УРЛ“ је УРЛ на који ће ваш сервер примати вебхоок ПОСТ захтеве.
  2. „Максимални број покушаја испоруке“ је подешавање које дефинише максималан број покушаја поновног покушаја који треба да се уради за испоруку веб-хука догађаја када почетни покушај испоруке не успе.
  3. „Временско ограничење поновног покушаја испоруке“ је подешавање које вам омогућава да одредите временски интервал између покушаја када покушај испоруке веб-хука не успе.

Након што унесете ове детаље, кликните на „Сачувај“.

Типови Вебхоок догађаја

  1. Нови статус поруџбине

Вебхоок Паилоад

Када дође до догађаја, послаћемо ХТТП ПОСТ захтев на УРЛ корисног учитавања са ЈСОН телом које садржи информације о догађају.

Ево примера корисног оптерећења:
Пример новог статуса поруџбине
Могуће вредности од "нови_статус" поље:
  • "Готов" - наруџбина је завршена. Наруџбина се може преузети;
  • "Ажуриран" - наруџба је ажурирана, подаци додати у завршену наруџбу;
  • "Отказано" - наруџбина је отказана на захтев (или сагласност) купца;
  • "Одбијен" - налог је одбијен. Обично зато што је немогуће идентификовати компанију.
  • „Идентификација у току“ - потребне су нам додатне информације од купца пре него што можемо да припремимо поруџбину..

Осигуравање ваших Вебхоокова

Важно је да проверите да ли су ПОСТ захтеви послати на УРЛ корисног учитавања из наше апликације. Да би се ово помогло, сваки захтев за веб-хук укључује заглавље Кс-Сигнатуре.

Опис потписа

За потписивање користимо ХМАЦ са СХА512 алгоритмом.

Тајна је спој ИД-а апликације и тајног кључа из подешавања веб-хукова.

Могуће је додати сопствене гет параме крајњој тачки да бисте идентификовали пошиљаоца ако је потребно.

Решавање проблема

Сервер мора одговорити у року од 10 секунди и вратити 2КСКС ХТТП код; у супротном, испорука веб-хука се сматра неуспешном. У случају неуспеха, функција ће покушати да поново пошаље захтев према политици испоруке.