Поиск ИНН физических лиц через форму ФНС
| Атрибут | Значение |
|---|---|
| Название | 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