Сколько стоит?

Подсказки входят в дневной лимит тарифа: на бесплатном плане это 10 000 запросов в сутки на все подсказки вместе.

Подойдёт ли, чтобы найти инспекцию по коду из ИНН?

Это уровень региональных управлений, для кода инспекции нужен другой источник. Справочник закрывает задачу, когда в документе указывают налоговый орган субъекта.

Можно ли искать по названию региона, а не по коду?

Да. Запрос «москв» приводит к «УФНС России по г. Москве» — пользователь вводит то, что помнит.

Долго ли подключать?

Ключ выдаётся в личном кабинете, а подсказки вешаются на уже существующее поле формы.

справочник

Управления ФНС
по регионам

Справочник региональных управлений ФНС: 85 управлений — четырёхзначный код, официальное наименование и код субъекта РФ.

Документация →

управлений

знака кода

~3мс

ответ

POST

↵ enter

200 OKapplication/json · 7ms

{ "query": "УФНС России по г. Москве", "suggestions": [ { "value": "УФНС России по г. Москве", "code": "7700", "region": "77" } ] }

что вы получаете

Возможности управления фнс

Код

Четырёхзначный код управления.

Название

Официальное наименование управления.

Регион

Привязка к субъекту РФ.

Поля ответа 3

Нативный формат — структурированный JSON со всеми полями. Для перехода с DaData есть совместимый плоский ответ: подсказки, поиск по идентификатору доступны по привычным адресам — меняются базовый адрес и заголовок авторизации, тело запроса остаётся прежним.

/suggestions/api/4_1/rs/suggest/fns_unit/suggestions/api/4_1/rs/findById/fns_unit

Готовое значениеКодРегион

Источник: ФНС России, справочник СОУН — открытые данные.

о сервисе

Что такое справочник налоговых органов

Справочник управлений ФНС по всем 85 регионам страны. Нужен там, где в анкете, договоре или карточке контрагента требуется назвать налоговый орган — и назвать официально. Человек вводит код или первые буквы региона, форма подставляет наименование управления, его код и регион. «7700» и «москв» одинаково приводят к «УФНС России по г. Москве». В учётной системе копится одно написание вместо десятка вариантов.

Как подключить справочник налоговых органов

Подсказки подключают к полю формы: пользователь набирает код или регион, ниже выпадает список, выбранное значение уходит в вашу базу вместе с кодом. Накопленные данные можно сверять точным поиском по коду. Если сейчас работаете с DaData, переход не требует переписывать код: формат запроса и ответа тот же, меняются адрес сервиса и ключ.

Что важно знать про справочник налоговых органов

Справочник охватывает управления по субъектам — это уровень региона, а не отдельной территориальной инспекции. Он закрывает задачу, когда в документе указывают налоговый орган субъекта: официальное наименование, код и номер региона — ровно то, что просят анкеты и шаблоны договоров. Для платёжного поручения понадобится источник с банковскими реквизитами.

тарификация

Подсказки

Подсказки входят в дневной лимит тарифа и доступны на всех планах, включая бесплатный.

в подпискепо дневному лимиту

Все тарифы и цены →

сценарии

Где это полезно

// fin

Платёжки

Реквизиты ИФНС в платёжных поручениях.

// reg

Регистрация

Инспекция по коду из ИНН.

// docs

Декларации

Код налогового органа в отчётности.

вопросы

Частые вопросы про справочник налоговых органов

Сколько стоит?: Подсказки входят в дневной лимит тарифа: на бесплатном плане это 10 000 запросов в сутки на все подсказки вместе.
Подойдёт ли, чтобы найти инспекцию по коду из ИНН?: Это уровень региональных управлений, для кода инспекции нужен другой источник. Справочник закрывает задачу, когда в документе указывают налоговый орган субъекта.
Можно ли искать по названию региона, а не по коду?: Да. Запрос «москв» приводит к «УФНС России по г. Москве» — пользователь вводит то, что помнит.
Долго ли подключать?: Ключ выдаётся в личном кабинете, а подсказки вешаются на уже существующее поле формы.

по теме