Infoproff API Документация - 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. Пользователь регистрирует новый заказ (функция «Order»). Система возвращает детали заказа, список дубликатов, размещенных за последние 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") необходимо указать название компании или регистрационный код.
  5. Рег-код требуется, если срок доставки - Online
    При заказе онлайн-отчета (delivery_term = "o") регистрационный код обязателен.
Функция GetReport
  1. Этот язык не поддерживается.
    Список доступных языков для Онлайн-отчетов: en (English), et (Estonian), ru (Russian), de (German)
Функции GetReport ChkStatus
  1. Неверный идентификатор заказа.
    Идентификатор заказа не может быть найден. Вы получаете идентификатор заказа, когда используете функцию 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