Ошибка 401 в iiko: что это и как исправить

Официальная карточка

Код
401
Система
iiko
Описание
Не аутентифицирован:- не передан параметр key в запросе или в cookie- истек таймаут сессии (обычно 1 час) с момента входа или момента последнего запроса, если работает "обновление токена" (не реализовано в REST API v1/v2)- сервер iikoRMS/iikoChain был перезагружен- сервер iikoRMS/iikoChain находится в процессе (пере)запуска и не может проверить пароль — List

Почему возникает эта ошибка

  • Истекло время активной сессии (обычно 1 час) с момента последнего входа в систему.
  • Сервер iiko (iikoRMS или iikoChain) был внезапно перезагружен.
  • Сервер iiko находится в процессе запуска и временно не может проверить данные для входа.
  • В запросе к системе не передан обязательный ключ авторизации (токен).

Как исправить

  1. Подождите 5-10 минут, если сервер iiko находится в процессе перезагрузки или планового обновления.
  2. Проверьте физический статус работы сервера iikoRMS или iikoChain (включен ли компьютер, где установлена база).
  3. Выполните повторную авторизацию в системе или приложении, чтобы получить новый ключ доступа.
  4. Убедитесь, что логин и пароль для доступа введены корректно и не были изменены администратором.
  5. Проверьте стабильность локальной сети и интернет-соединения между вашим устройством и сервером iiko.
  6. Если после перезагрузки сервера ошибка сохраняется, обратитесь к системному администратору для проверки логов.

Частые вопросы

Что означает ошибка 401 в iiko?

Эта ошибка означает, что система не может вас авторизовать. Чаще всего это происходит из-за истекшего времени сессии, отсутствия ключа доступа или перезагрузки сервера iiko.

Помогает ли DocsInBox предотвратить ошибку 401 в iiko?

Нет, так как это инфраструктурная ошибка на стороне самого сервера iiko (например, техническая перезагрузка базы или истечение времени сеанса). DocsInBox не может запретить серверу iiko перезагружаться, но при восстановлении связи интеграция продолжит работу.

Как часто нужно обновлять токен доступа?

Обычно сессия в iiko длится около 1 часа. Если интеграция или приложение не поддерживает автоматическое обновление токена, авторизацию потребуется выполнять заново.

Похожие ошибки

  • 400Либо ошибка в запросе (параметры не того типа, ошибки десериализации), либо внутренняя ошибка, связанная с неполнотой полученных в запросе, либо хранящихся в базе данных:- Wrong date format: 2019-0513
  • 403Доступ запрещён (аутентифицирован, но нет прав):- На сервере нет лицензии на данный API или подсистему API (сотрудников, событий...) (Module %s is blocked within current license)- Превышено разрешенно
  • 404Объект не найден, некорректный путь — Уведомить пользователя или автора клиента/интеграции.
  • 409Произошла ошибка бизнес-логики, сервер вернул сообщение для пользователя:- "Доступ запрещен КОД.ПРАВА"- "Операция создает приход на отрицательные остатки..."- "У вас нет права изменять документы задни
  • 500Произошла внутренняя ошибка:- User represents store, but no linked store found: %s - Unknown client type for outgoing invoice: %s - Operation is allowed only in %s's thread. Current thread: %s - Opera
  • Внешнее менюВнешнее меню

Устали разбираться с ошибками вручную?

DocsInBox автоматизирует работу с iiko — проверяет данные до отправки, ошибки не возникают.

Данные синхронизированы 25.05.2026, 18:19