Приложение № 32Технические сервисы

Актуальные справочники НМ

Актуальные версии справочников налогового мониторинга по запросу — с датой, ссылкой на архив и MD5.

Получение актуальных версий архивов справочников налогового мониторинга

Справочники налогового мониторинга, например SPVDOC с видами документов, нужны для заполнения кодов в сообщениях налоговому органу. Сервис запрашивает у АИС «Налог-3» перечень актуальных архивов справочников: версию, дату, ссылку на скачивание и контрольную сумму.

Что это даёт

  • Всегда понятно, какая версия справочника актуальна и с какой даты
  • Ссылка на архив и MD5-сумма для проверки целостности — в одном месте
  • Коды в сообщениях налоговому органу можно сверить с актуальной версией справочника
  • История запросов справочников сохраняется в журнале

Как проходит обмен

Упрощённая карта сценария по регламенту: кто кого вызывает, какие проверки проходят сообщения и где в процесс включается сотрудник.

  1. TM · сотрудникСотрудник нажимает «Запросить справочники»
  2. TM · getDirectoriesGET-запрос с актуальным токеном в заголовке
  3. НО · проверкаПроверка токена
    ошибка401 / 500 — ошибка в журнале, запрос можно повторить
  4. НО · принято200 — перечень справочников: версия, дата, ссылка, MD5
  5. TM · автоматическиРезультат сохранён и показан в списке, обмен — в журнале
  6. TM · итогКоманда видит актуальные версии справочников НМ
  • вызов сервиса
  • проверка
  • работа сотрудника
  • автоматически
  • принято
  • ошибка
Регламент АИС «Налог-3», редакция 06.2026 · Directories-1.0.0

Что делает система

  1. Кнопка «Запросить справочники» вызывает getDirectories с актуальным токеном
  2. Показывает по каждому справочнику версию, дату актуальности, ссылку на архив и MD5
  3. Сохраняет результат каждого запроса и пишет обмен в «Журнал запросов»
  4. Исходящий вызов — с клиентским сертификатом, токен обновляется автоматически
Справочники налогового мониторинга (Прил. 32): журнал запросов
Журнал запросов справочников

Методы сервиса

МетодНаправлениеНазначение
getDirectoriesкомпания → НОGET-запрос перечня актуальных архивов справочников НМ

Коды ответов

200
операция успешна, перечень справочников в ответе
401
неверный, просроченный или неактуальный токен
500
непредвиденная ошибка

Обсудим этот сервис в вашей инфраструктуре

Путь требования от АИС «Налог-3» до результата, витрина данных и администрирование — на демонстрационных данных.