Документація 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_formed_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. Користувач підтверджує замовлення (функція "Підтвердження замовлення"). Система відправляє замовлення у виробництво і повертає поточний статус виробництва.
  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. Ви не можете замовити звіт по компанії з такою організаційно-правовою формою: "організаційно-правова_форма"
    Ця помилка стосується тільки: Королівство Швеція (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") обов'язковим є заповнення поля "Назва підприємства" або "Код ЄДРПОУ".
  5. Рег код необхідний, якщо термін доставки Онлайн
    При замовленні онлайн звіту (delivery_term = "o") обов'язковим є "Reg Code".
Функція GetReport
  1. Ця мова не підтримується.
    Список доступних мов для онлайн-звітів: en (English), et (Estonian), ru (Russian), de (German)
Функції GetReport ChkStatus
  1. Неправильний order_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)

- Доступне завантаження фінансової звітності (за допомогою продукту: фінанси) в онлайн-режимі: 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