Все примеры «персональных данных», представленные на данном портале, являются тестовыми (не реальными)! Примеры представлены разработчикам для тестирования ИТ-систем. Доступ к реальным данным осуществляется в соответствии с законами РФ согласно «Методическим рекомендациям». Подробнее.
Если у вас есть законные основания для подключения к Виду сведения, мы можем проконсультировать по техническим и организационным моментам подключения. Связаться с нами
Поиск ИНН физических лиц через форму ФНС
| Атрибут | Значение |
|---|---|
| Название | fns-web-inn |
| Тип | Адаптер для стороннего web-api |
| Наименование | Поиск ИНН физических лиц через форму ФНС |
| Версия | Отсутствует. Реализовано 18.03.2020 |
Доступные продукты
| Продукты |
|---|
| УПРИД Директ |
Принимаемые параметры
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| 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_issuer_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 и другие типы запросов.
- Параметры запросов: параметры пути, параметры запроса, тело запроса, заголовки запроса и другие параметры.
- Ожидаемые ответы: коды ответов, тела ответов и заголовки ответов.
- Тесты: наборы скриптов, которые используются для проверки правильности ответов на запросы.
- Переменные: значения переменных, которые могут использоваться в разных запросах, чтобы избежать повторений.
Загрузить файл с набором HTTP запросов