Поиск ИНН физических лиц через форму ФНС

Атрибут Значение
Название fns-web-inn
Тип Адаптер для стороннего web-api
Наименование Поиск ИНН физических лиц через форму ФНС
Версия Отсутствует. Реализовано 18.03.2020

Переменные окружения

Переменные окружения используемый для конфигурации сервиса:

Название Описание Пример
FNS_WEB_INN_ENDPOINT Адрес для выполнения запроса  
FNS_WEB_INN_PROXYLIST Список прокси (только SOCKS5) для выполнения запроса
=direct
direct;8.8.8.8:1234;7.7.7.7:4321
FNS_WEB_INN_REQUEST_TIMEOUT Общий таймаут на всю обработку запроса
=5
10
особенности эксплуатации

Сервис имеет ограниченную пропускную способность: 1 сообщение за каждый элемент PROXYLIST в 2 секунды. Таким образом максимальный поток составляет около 40000 сообщений в сутки при использовании одного прокси.

Принимаемые параметры

Параметр Название Обязательное Пример
service Имя сервиса. Всегда указывается значение fns-web-inn + fns-web-inn
surname Фамилия + Иванов
name Имя + Иван
patronymic Отчество - Иванович
birthdate Дата рождения + 01.01.2020
doc_code Код вида документа, удостоверяющего личность (из Справочника видов документов, удостоверяющих личность налогоплательщика) + 21
doc_series_number Серия и номер документа, удостоверяющего личность + 0404 776947
doc_issuer_date Дата выдачи документа, удостоверяющего личность - 01.01.2020

Параметры ответа

Параметр Название Обязательное Пример
inn ИНН физ лица - 520205004556
success Статус обработки запроса + true
message Сообщение об ошибке - Timeout
ERRORS Ошибки с портальной формы -  
treatment_message Сообщение об отсутствии ИНН (устарело) - Не найдено
treatment_code Код ошибки отсутствии ИНН (устарело) - 01

Примеры

Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:

{
  "service": "fns-web-inn",
  "surname": "Иванов",
  "name": "Иван",
  "patronymic": "Иванович",
  "birthdate": "09.03.1985",
  "doc_code": "21",
  "doc_series_number": "04 04 776947",
  "doc_issue_date": "15.03.1999"
}

Если найден ИНН должен прийти следующий ответ:

{
  "success": true,
  "inn": "520205004556",
}

Если ИНН не найден:

{
  "success": true,
  "treatment_message": "Не найдено",
  "treatment_code": "01"
}

В случае некорректной настройки в ответе должен быть ключ success cо значением false

  • Поиск ИНН физических лиц через форму ФНС
  • Переменные окружения
  • Принимаемые параметры
  • Параметры ответа
  • Примеры
  • Подавай заявку сейчас

    Оставьте свои контактные данные и наш менеджер свяжется с вами в ближайшее время