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