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


Почетак


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

http://wsdfn.infoproff.com/v3/

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)
  2. Офлајн извештаји за следеће земље: Све земље
  3. Калкулатор кредитног мишљења

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


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

  1. Претражите по називу компаније,
  2. Search by company code.
Листа доступних земаља: Георгиа (GEO), Гренланд (GRL), Ирска (IRL), Италијанска Република (ITA), Киргиз Републиц (KGZ), Краљевина Белгија (BEL), Краљевина Данска (DNK), Краљевина Норвешка (NOR), Краљевина Холандија (NLD), Краљевина Шведска (SWE), Краљевина Шпанија (ESP), Монголија (MNG), Народна Република Кина (CHN), Португалска Република (PRT), Република Азербејџан (AZE), Република Белорусија (BLR), Република Казахстан (KAZ), Република Кипар (CYP), Република Молдавија (MDA), Република Пољска (POL), Република Узбекистан (UZB), Република Финска (FIN), Републике Аустрије (AUT), Републике Естоније (EST), Уједињено Краљевство Велике Британије и Северне Ирске (GBR), Федеративна Република Немачка (DEU), Француска Република (FRA), Хонг Конг (HKG), Швајцарска конфедерација (CHE)
Важна информација:

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

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

Како наручити кредитни извештај?


List of available countries for online credit reports: Киргиз Републиц (KGZ), Краљевина Белгија (BEL), Краљевина Холандија (NLD), Краљевина Шведска (SWE), Народна Република Кина (CHN), Република Казахстан (KAZ), Република Пољска (POL), Република Финска (FIN), Републике Естоније (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.

Следећи статуси се користе за извештаје:

  • У току - Извештај у фази производње
  • 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
Листа доступних језика: bg (бугарски), cs (чешки), da (дански), de (Немачки), el (грчки), en (енглески језик), es (Шпански), et (естонски), fi (фински), fr (Француски), hu (мађарски), id (индонезијски), it (Италијан), ja (јапански), ko (корејски), lt (литвански), lv (летонски), nb (норвешки бокмал), nl (холандски), pl (Пољски), pt (португалски), ro (румунски), ru (Руски), sk (словачки), sl (словеначки), sr (Српски), sv (Шведски), tr (турски), uk (украјински), 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.

Следећи статуси се користе за извештаје:

  • У току - Извештај у фази производње
  • 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
Листа доступних језика: bg (бугарски), cs (чешки), da (дански), de (Немачки), el (грчки), en (енглески језик), es (Шпански), et (естонски), fi (фински), fr (Француски), hu (мађарски), id (индонезијски), it (Италијан), ja (јапански), ko (корејски), lt (литвански), lv (летонски), nb (норвешки бокмал), nl (холандски), pl (Пољски), pt (португалски), ro (румунски), ru (Руски), sk (словачки), sl (словеначки), sr (Српски), sv (Шведски), tr (турски), uk (украјински), zh (кинески)

Како наручити онлајн финансијске извештаје?


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.

Следећи статуси се користе за извештаје:

  • У току - Извештај у фази производње
  • 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
Листа доступних језика: bg (бугарски), cs (чешки), da (дански), de (Немачки), el (грчки), en (енглески језик), es (Шпански), et (естонски), fi (фински), fr (Француски), hu (мађарски), id (индонезијски), it (Италијан), ja (јапански), ko (корејски), lt (литвански), lv (летонски), nb (норвешки бокмал), nl (холандски), pl (Пољски), pt (португалски), ro (румунски), ru (Руски), sk (словачки), sl (словеначки), sr (Српски), sv (Шведски), tr (турски), uk (украјински), 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, bg, cs, da, de, el, fi, fr, hu, id, it, ja, ko, lt, nl, nb, pl, pt, ro, sk, sl, es, sr, sv, tr, uk, 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.
    Листа доступних земаља: Георгиа (GEO), Гренланд (GRL), Ирска (IRL), Италијанска Република (ITA), Киргиз Републиц (KGZ), Краљевина Белгија (BEL), Краљевина Данска (DNK), Краљевина Норвешка (NOR), Краљевина Холандија (NLD), Краљевина Шведска (SWE), Краљевина Шпанија (ESP), Монголија (MNG), Народна Република Кина (CHN), Португалска Република (PRT), Република Азербејџан (AZE), Република Белорусија (BLR), Република Казахстан (KAZ), Република Кипар (CYP), Република Молдавија (MDA), Република Пољска (POL), Република Узбекистан (UZB), Република Финска (FIN), Републике Аустрије (AUT), Републике Естоније (EST), Уједињено Краљевство Велике Британије и Северне Ирске (GBR), Федеративна Република Немачка (DEU), Француска Република (FRA), Хонг Конг (HKG), Швајцарска конфедерација (CHE)
Функција 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.
    Листа доступних језика за онлајн извештаје: bg (бугарски), cs (чешки), da (дански), de (Немачки), el (грчки), en (енглески језик), es (Шпански), et (естонски), fi (фински), fr (Француски), hu (мађарски), id (индонезијски), it (Италијан), ja (јапански), ko (корејски), lt (литвански), lv (летонски), nb (норвешки бокмал), nl (холандски), pl (Пољски), pt (португалски), ro (румунски), ru (Руски), sk (словачки), sl (словеначки), sr (Српски), sv (Шведски), tr (турски), uk (украјински), 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'.

СОАП (верзија 3) се мења у поређењу са СОАП-ом (верзија 2)


СОАП (верзија 3) се мења у поређењу са СОАП-ом (верзија 2) [Overview]

1) New function: ChkFinance

Allows you to search for available financial statements.
Currently available only in EST (Estonia), SWE (Sweden)

2) Function: SimpleSearch

- Changes in list of available countries: Георгиа (GEO), Гренланд (GRL), Ирска (IRL), Италијанска Република (ITA), Киргиз Републиц (KGZ), Краљевина Белгија (BEL), Краљевина Данска (DNK), Краљевина Норвешка (NOR), Краљевина Холандија (NLD), Краљевина Шведска (SWE), Краљевина Шпанија (ESP), Монголија (MNG), Народна Република Кина (CHN), Португалска Република (PRT), Република Азербејџан (AZE), Република Белорусија (BLR), Република Казахстан (KAZ), Република Кипар (CYP), Република Молдавија (MDA), Република Пољска (POL), Република Узбекистан (UZB), Република Финска (FIN), Републике Аустрије (AUT), Републике Естоније (EST), Уједињено Краљевство Велике Британије и Северне Ирске (GBR), Федеративна Република Немачка (DEU), Француска Република (FRA), Хонг Конг (HKG), Швајцарска конфедерација (CHE)

- Each time you place an request we asaign a new 'search_result_id' for each company. You need to use this 'search_result_id' to place online orders.

Also you can place offline (delivery_term = 'n', 'f' or 's') orders with 'search_result_id', if you desire.

3) Function: Order
Identification is required!

To place an online order, you need to recieve 'search_result_id' from function 'SimpleSearch', and only after that you can place an online (delivery_term = 'o') order.

- Changes in list of available countries for online credit reports: Киргиз Републиц (KGZ), Краљевина Белгија (BEL), Краљевина Холандија (NLD), Краљевина Шведска (SWE), Народна Република Кина (CHN), Република Казахстан (KAZ), Република Пољска (POL), Република Финска (FIN), Републике Естоније (EST)

- Available to download financial statements (using product: finances) in online mode: Estonia (EST), Sweden (SWE)

3) Function: GetReport

- Changes in of available languages: bg (бугарски), cs (чешки), da (дански), de (Немачки), el (грчки), en (енглески језик), es (Шпански), et (естонски), fi (фински), fr (Француски), hu (мађарски), id (индонезијски), it (Италијан), ja (јапански), ko (корејски), lt (литвански), lv (летонски), nb (норвешки бокмал), nl (холандски), pl (Пољски), pt (португалски), ro (румунски), ru (Руски), sk (словачки), sl (словеначки), sr (Српски), sv (Шведски), tr (турски), uk (украјински), zh (кинески)


СОАП (верзија 3) се мења у поређењу са СОАП-ом (верзија 2) [WSDL and XSD]

File: report.xsd

New elements:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

New function:

- ChkFinance

Function that allows you to search for available financial statements.

NB: This function is only needed when ordering a product: finances (Financial statements) with delivery_term = 'o'.
File: order.xsd

1) OrderReportRequest has a choice:

- order_details:

Using general information: business_name, reg_code, vat_code, address, phone, email, additional_info

NB:
* Business Name or Registration Code is required
* Only for orders with delivery_term: 'n', 'f' and 's' (credit reports in offline mode)

- order_details_by_id:

Using 'search_result_id'

NB:
* 'search_result_id' can be obtained with function: 'SimpleSearch'
* each new search generates new 'search_result_id'

2) order_details

New element:

- preferable_finances

NB: This element is required only ordering a product: finances (Financial statements) with delivery_term = 'o'.

3) SimpleSearchRequest

Removed element:

search_block.reg_code

New element:

search_block->company_code

NB: in some countries we allow to search companies by vat_code.

4) SimpleSearchResponse

Removed elements

- code

Нови елементи:

  • - search_result_id (is required for order with delivery_term = 'o')
  • - name_transliteration
  • - reg_code
  • - vat_code
  • - unified_legal_form

Webhooks Settings


Преглед

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

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

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

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

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

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

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

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

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

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

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

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

Опис потписа

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

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

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

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

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