Документация за API на Infoproff - v2

Версия на превключвателя V2

Започване на работа

Уеб услугата wsdl и схемите се намират тук:

http://wsdfn.infoproff.com/v2/

Основни функции на уеб услугата:

  • SimpleSearch - Търсене на информация за компании в различни държави.
  • Order - Създава order_id и връща дубликати. Дубликатите се избират по следващите параметри: country, product, delivery_term and 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 - Калкулаторът за кредитно становище помага да се определи кредитно становище за дадена компания.

API предоставя няколко услуги:

  1. Онлайн кредитни доклади за следните държави: Република Финландия (FIN), Кралство Швеция (SWE)
  2. Офлайн доклади за следните държави: Всички държави
  3. Калкулатор на кредитното мнение

Как да търсим компания?

Търсенето на фирма се състои от 2 опции:

  1. Търсене по име на компания,
  2. Търсене по регистрационен код.
Списък на наличните държави: Република Финландия (FIN), Кралство Швеция (SWE), Кралство Норвегия (NOR), Кралство Дания (DNK)
Важна информация:
Регистърът на Норвегия не позволява търсене на заличени дружества по имена. Поради това не можем да предоставим SimpleSearch по имена в рамките на заличените дружества в Норвегия.
Field's length:
company_name varchar(512)
company_code varchar(64)

По-долу можете да намерите примера:

Функция SimpleSearch

Опция 2: Търсене по регистрационен код

Функция SimpleSearch

Как да поръчате кредитен отчет?

Редът от регистрацията до получаването на доклада се състои от следните стъпки:

  1. Потребителят регистрира нова поръчка (функция "Поръчка"). Системата връща подробна информация за поръчката, списък на дубликатите, направени през последните 60 дни, и очаква потвърждение на поръчката.
  2. Потребителят потвърждава поръчка (функция "OrderConfirmation"). Системата изпраща поръчката за производство и връща текущото състояние на производството.
  3. Потребителят проверява състоянието на поръчката (функция "ChkStatus").
  4. Ако поръчката е готова, потребителят може да изтегли отчета (функция "GetReport").
Списък на наличните държави: Република Финландия (FIN), Кралство Швеция (SWE)
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)

По-долу можете да намерите примера:

СТЪПКА 1: Поръчайте доклад

Потребителите, които смятат, че стъпката за потвърждаване на поръчката не е необходима, могат да използват елемента "confirm_order" и да предадат стойността "TRUE".

Обикновено изготвянето на кредитния доклад в онлайн режим отнема 10-20 секунди.
Ето защо при онлайн отчетите трябва да правите проверки на всеки 5 или повече секунди.

Списък на наличните компании за тестова сметка:

01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
Освен това за онлайн отчетите (delivery_term = "o"), можете да използвате образци, генерирани за всяка държава (използвайте: регистрационен код "00000000"). Тези отчети са безплатни и могат да бъдат поръчани, като се използва тестовият акаунт.
Функция Order
Функция OrderCancellation

СТЪПКА 2. Потвърждаване на поръчката

Функция OrderConfirmation

СТЪПКА 3. Проверка на състоянието

Функция ChkStatus

СТЪПКА 4. Получаване на отчет

Списък на наличните езици за онлайн отчети: en (English), et (Estonian), ru (Russian), de (German)
Изтеглянето на онлайн доклада във формат pdf все още не е достъпно.
Функция GetReport

За отчетите се използват следните състояния:

  • В процес на изпълнение - Доклад на етап производство
  • Canceled - Отменена поръчка
  • Finished - Докладът е готов
  • Updated - В готовия доклад е добавена информация
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - В нашата система е възникнала техническа грешка. Това означава, че сме информирани за тази грешка и ще я отстраним възможно най-скоро. Ще бъдете информирани кога ще можете да получите поръчката.

Ако статусът на изпълнение е Finished или Updated, тогава можете да получите поръчка.

Как да изтеглите офлайн доклад?

Можете да изтеглите директно офлайн отчети. Ето инструкциите как да го направите:

Искането се състои от 3 части:

  1. Фиксирана част https://www.infoproff.com/en/orders/files/
  2. Вашия уникален хеш код, който предоставяме в отговор.
  3. И фиксирана част в края /download

Как да получите кредитно становище?

Функция CreditOpinionCalculator

Как да получите допълнителна информация?

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

Възможни грешки

Тези грешки могат да възникнат при подаване на заявка към нашата уеб услуга..

Всички функции
  • Неправилно потребителско име/парола или нямате разрешения.
    Въвеждате грешни идентификационни данни или достъпът ви до API е блокиран.
Функция SimpleSearch
  1. Нямате разрешения за търсене в тази страна.
    Списък на наличните държави: Република Финландия (FIN), Кралство Швеция (SWE)
Функция Order
  1. Този продукт не е наличен.
    Такъв продукт не може да бъде намерен и не е възможно да бъде поръчан.
  2. Не можете да поръчате доклад за дружество с правна форма: "legal_form"
    Тази грешка се отнася само за: Кралство Швеция (SWE)
    В Швеция не е възможно да поръчате онлайн доклад (delivery_term = "o") със следващите правни форми:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. Тази компания не е в списъка за изпитване.
    Регистрационният код на фирмата не е в нашия списък с тестове.
    Списък на наличните компании за тестова сметка:
    01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
  4. Изисква се фирмено име или рег. код
    При поръчка на офлайн отчет (delivery_term = "n", "f" или "s") се изисква "Business Name" или "Reg Code".
  5. Регистрационният код се изисква, когато срокът на доставка е Онлайн
    При поръчка на онлайн отчет (delivery_term = "o") се изисква "Reg Code".
Функция GetReport
  1. Този език не се поддържа.
    Списък на наличните езици за онлайн отчети: en (English), et (Estonian), ru (Russian), de (German)
Функции GetReport ChkStatus
  1. Неправилен order_id.
    Идентификаторът на поръчката не може да бъде намерен. Можете да получите ID на поръчката, когато използвате функцията Order.
Функция OrderCancellation
  1. Your order is already canceled.
    Вече нямате разрешение да отмените поръчката.
Функция OrderConfirmation
  1. Вече нямате разрешение да потвърдите поръчката. Потвърждението може да бъде извършено в рамките на един час след получаването на 'order_id'.

Промени в SOAP (версия 3) в сравнение със SOAP (версия 2)

Промени в SOAP (версия 3) в сравнение със SOAP (версия 2) [Преглед]

1) Нова функция: ChkFinance

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

2) Функция: SimpleSearch

- Changes in list of available countries: Finland (FIN), Sweden (SWE), Norway (NOR), Denmark (DNK), Belgium (BEL), Estonia (EST), Netherlands (NLD), United Kingdom (GBR), Ireland (IRL), France (FRA), Spain (ESP), Portugal (PRT), Germany (DEU), Italy (ITA), Austria (AUT), Switzerland (CHE), Cyprus (CYP)

- 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) Функция: Order
Identification is required!

За да направите онлайн поръчка, трябва да получите 'search_result_id' от функцията 'SimpleSearch' и едва след това можете да направите онлайн (delivery_term = 'o') поръчка.

- Промени в списъка с държави, от които могат да се получават онлайн кредитни доклади: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Налични за изтегляне на финансови отчети (с помощта на продукта: finances) в онлайн режим: Estonia (EST), Sweden (SWE)

3) Функция: GetReport

- Changes in of available languages: en (English), et (Estonian), ru (Russian), de (German), zh (Chinese), ja (Japanese), bg (Bulgarian), cs (Czech), da (Danish), el (Greek), fi (Finnish), fr (French), hu (Hungarian), it (Italian), lv (Latvian), lt (Lithuanian), nl (Dutch), pl (Polish), pt (Portuguese), ro (Romanian), sk (Slovak), sl (Slovenian), es (Spanish), sv (Swedish)


Промени в SOAP (версия 3) в сравнение със SOAP (версия 2) [WSDL and XSD]

File: report.xsd

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

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Нова функция:

- 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

Нов елемент:

- preferable_finances

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

3) SimpleSearchRequest

Премахнат елемент:

search_block.reg_code

Нов елемент:

search_block->company_code

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

4) SimpleSearchResponse

Премахнати елементи

- code

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

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