Приложение № 32Технические сервисы
Актуальные справочники НМ
Актуальные версии справочников налогового мониторинга по запросу — с датой, ссылкой на архив и MD5.
Получение актуальных версий архивов справочников налогового мониторинга
Справочники налогового мониторинга, например SPVDOC с видами документов, нужны для заполнения кодов в сообщениях налоговому органу. Сервис запрашивает у АИС «Налог-3» перечень актуальных архивов справочников: версию, дату, ссылку на скачивание и контрольную сумму.
Что это даёт
- Всегда понятно, какая версия справочника актуальна и с какой даты
- Ссылка на архив и MD5-сумма для проверки целостности — в одном месте
- Коды в сообщениях налоговому органу можно сверить с актуальной версией справочника
- История запросов справочников сохраняется в журнале
Как проходит обмен
Упрощённая карта сценария по регламенту: кто кого вызывает, какие проверки проходят сообщения и где в процесс включается сотрудник.
- TM · сотрудникСотрудник нажимает «Запросить справочники»
- TM · getDirectoriesGET-запрос с актуальным токеном в заголовке
- НО · проверкаПроверка токенаошибка401 / 500 — ошибка в журнале, запрос можно повторить
- НО · принято200 — перечень справочников: версия, дата, ссылка, MD5
- TM · автоматическиРезультат сохранён и показан в списке, обмен — в журнале
- TM · итогКоманда видит актуальные версии справочников НМ
- вызов сервиса
- проверка
- работа сотрудника
- автоматически
- принято
- ошибка
Что делает система
- Кнопка «Запросить справочники» вызывает getDirectories с актуальным токеном
- Показывает по каждому справочнику версию, дату актуальности, ссылку на архив и MD5
- Сохраняет результат каждого запроса и пишет обмен в «Журнал запросов»
- Исходящий вызов — с клиентским сертификатом, токен обновляется автоматически

Методы сервиса
| Метод | Направление | Назначение |
|---|---|---|
| getDirectories | компания → НО | GET-запрос перечня актуальных архивов справочников НМ |
Коды ответов
- 200
- операция успешна, перечень справочников в ответе
- 401
- неверный, просроченный или неактуальный токен
- 500
- непредвиденная ошибка
Связанные сервисы
Обсудим этот сервис в вашей инфраструктуре
Путь требования от АИС «Налог-3» до результата, витрина данных и администрирование — на демонстрационных данных.