ИНН ФНС

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

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

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

Переменные для конфигурирования подключения к БД и RabbitMq:

DATABASE_URL, CA_CERT, CLIENT_CERT, CLIENT_KEY, MQ_HOST, MQ_PORT

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

особенности эксплуатации

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

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

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

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

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

Примеры

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

{
  "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

Набор HTTP запросов

Файл набора HTTP запросов - это файл, созданный в приложении Postman, который содержит набор HTTP запросов, ответов и сопутствующей информации, связанной с тестированием API.

Коллекция в Postman обычно включает в себя следующую информацию:

HTTP запросы: GET, POST, PUT, DELETE и другие типы запросов.
Параметры запросов: параметры пути, параметры запроса, тело запроса, заголовки запроса и другие параметры.
Ожидаемые ответы: коды ответов, тела ответов и заголовки ответов.
Тесты: наборы скриптов, которые используются для проверки правильности ответов на запросы.
Переменные: значения переменных, которые могут использоваться в разных запросах, чтобы избежать повторений.