Проверка недействительности ИНН физического лица через форму ФНС
| Атрибут | Значение |
|---|---|
| Название | fns-web-invalid-inn |
| Тип | Адаптер для стороннего web-api |
| Наименование | Проверка недействительности ИНН физического лица через форму ФНС |
| Версия | Отсутствует. Реализовано 18.03.2020 |
Переменные окружения
Переменные окружения используемый для конфигурации сервиса:
| Название | Описание | Пример |
|---|---|---|
| FNS_WEB_INVALID_INN_ENDPOINT | Адрес для выполнения запроса | |
| FNS_WEB_INVALID_INN_PROXYLIST | Список прокси (только SOCKS5) для выполнения запроса=direct |
direct;8.8.8.8:1234;7.7.7.7:4321 |
| FNS_WEB_INVALID_INN_REQUEST_TIMEOUT | Общий таймаут на всю обработку запроса=5 |
10 |
особенности эксплуатации
Сервис имеет ограниченную пропускную способность: 1 сообщение за каждый элемент PROXYLIST в 2 секунды. Таким образом максимальный поток составляет около 40000 сообщений в сутки при использовании одного прокси.
Принимаемые параметры
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| service | Имя сервиса. Всегда указывается значение fns-web-invalid-inn |
+ | fns-web-invalid-inn |
| inn | ИНН | + | 604656369902 |
Параметры ответа
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| success | Статус обработки запроса | + | true |
| in_list | Признак наличия ИНН в списке недействительных ИНН | - | true |
| date | Дата признания недействительным | - | 24.08.2023 |
| message | Сообщение об ошибке | - | Timeout |
| errors | Ошибки с портальной формы | - |
Примеры
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:
{
"service": "fns-web-invalid-inn",
"inn": "604656369902"
}
Если ИНН является недействительным придет ответ вида:
{
"success": true,
"in_list": true,
"date": "16.02.2024"
}
Если ИНН не является недействительным:
{
"success": true,
"in_list": false
}
В случае возникновения ошибок придет ответ следующего вида:
{
"errors": {
"inn": [
"Некорректный ИНН ФЛ"
]
},
"success": false,
"message": "Get error response"
}