Приложение № 10Технические сервисы
Автообновление токена аутентификации
Токен доступа к АИС «Налог-3» обновляется автоматически — обмен с налоговым органом не прерывается.
Обновление токена аутентификации
Каждый вызов сервисов налогового органа идёт с токеном, который действует 24 часа и после обновления сразу перестаёт работать. Tax Monitoring сам обновляет токен каждые 5 часов, поэтому исходящие сообщения не упираются в ошибку 401.
Что это даёт
- Не нужно следить за сроком жизни токена — система обновляет его сама
- Исходящие сообщения не отклоняются из-за просроченного токена
- Начальный токен из рабочего места участника мониторинга вводится один раз
- Каждое обновление видно в журнале запросов
Как проходит обмен
Упрощённая карта сценария по регламенту: кто кого вызывает, какие проверки проходят сообщения и где в процесс включается сотрудник.
- TM · сотрудникОдин раз: начальный токен из рабочего места участника мониторинга
- каждые 5 часовTM · автоматическиПлановое обновление токена
- TM · refreshTokenТекущий токен в теле запроса
- НО · проверкаСхема XSD, актуальность переданного токенаотказ · ошибка304 / 411 — прежний токен сохранён, ошибка в журнале
- НО · принято200 — новый токен, старый больше не действует
- TM · автоматическиНовый токен сохранён и идёт в заголовке всех вызовов
- TM · итогОбмен с налоговым органом без ошибок 401
- вызов сервиса
- проверка
- работа сотрудника
- автоматически
- принято
- ошибка
Что делает система
- Обновляет токен автоматически каждые 5 часов — задолго до 24-часового срока
- Поле токена и кнопка «Обновить токен» — на странице «Статус системы»
- Подставляет актуальный токен в заголовок TOKEN каждого исходящего запроса
- При отказе сохраняет прежний токен и фиксирует ошибку в журнале
Сроки по регламенту
- Срок жизни токена
- 24 часа, затем нужен новый через refreshToken

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