POS-сервер iiko недоступен: причины и порядок диагностики

Когда на кассовом терминале зависает программа или система сообщает, что iiko сервер недоступен, работа ресторана замедляется. Чтобы быстро возобновить продажи, важно понимать, как устроен iiko сервер и почему возникают сбои. В этой статье мы разберем основные причины неполадок, настроим правильный порядок диагностики оборудования и восстановим обмен данными. Компания POSBazar — официальный дилер iiko в России — помогает рестораторам быстро устранять подобные сбои, поддерживать непрерывную работу касс и избегать простоев заведения.

1. Что такое iiko сервер и почему возникает ошибка

В экосистеме iiko термин «сервер недоступен» относится к двум разным архитектурным компонентам. Различайте их при диагностике, чтобы администратор или ресторатор быстро находил источник проблемы.

Главный кассовый сервер (служба iikoTomcat) — это центральное звено локальной системы ресторана. Данная служба обеспечивает обмен данными между кассовыми терминалами (iikoFront) и бэк-офисом (iikoOffice). Если этот iiko сервер отключается, на кассовом терминале в правом нижнем углу загорается красный индикатор. Это указывает на потерю связи со службой Tomcat. В этот момент касса автоматически переходит в автономный режим.

POS-сервер iikoCard (служба iikoCard5POS) — это локальная служба лояльности, которую технические специалисты разворачивают на сервере или главной кассе. Данная служба связывает кассу с облачным сервером лояльности iiko.biz. Если этот компонент не работает, гости не могут авторизоваться по номерам телефонов, списать бонусы или применить внешние маркетинговые программы. Обычные продажи при этом продолжаются, но на экране появляется ошибка «pos сервер недоступен iiko» при этом отключает автоматические скидки.

Автономный режим (offline) — это специальный режим работы кассы iikoFront при потере связи с главным сервером Tomcat. В этом режиме кассиры продолжают фиксировать продажи. Система записывает транзакции локально в базу данных кассы по пути:
%HOMEPATH%\AppData\Roaming\iiko\CashServer\EntitiesStorage

После того как инженер восстановит связь, служба очереди автоматически отправит накопленные транзакции на iiko сервер. За этим процессом следите через файл update-tasks-queue.log.

Можно ли пробивать чеки гостям, если отключился iiko сервер? Да, касса автоматически переходит в автономный режим. Кассиры продолжают формировать заказы и закрывать столы. Система сохраняет все данные локально на кассовом терминале. Как только связь восстановится, система автоматически синхронизирует продажи с сервером.

Срок. Касса в автономном режиме без передачи данных в ОФД работает не более 30 дней, после чего фискальный накопитель заблокирует проведение платежей.

2. Различия между локальным RMS и POS-сервером iikoCard

Сравним эти два компонента, чтобы вы быстро определяли, какая именно служба дала сбой в вашем ресторане.

Каждый сервер выполняет свои задачи. Если касса работает исправно, но гости жалуются, что не могут списать бонусы, — проблема кроется в службе iikoCard5POS. Если же касса горит красным индикатором и не видит бэк-офис — проверяйте iiko сервер и службу iikoTomcat.

3. Основные причины, почему POS-сервер iiko недоступен

Сбои в работе серверов автоматизации происходят по разным причинам. Мы разделили их на три основные категории: сетевые неполадки, системные сбои Windows и внешние факторы.

Сетевые проблемы и блокировки портов

Часто связь пропадает из-за случайной смены IP-адреса. Если системный администратор не присвоил серверу статический IP-адрес в локальной сети, роутер после перезагрузки выдает ему новый адрес. В результате кассовые терминалы отправляют запросы на старый IP-адрес и не находят iiko сервер.

Другая причина — блокировки брандмауэра или антивируса. Защитное ПО Windows или сторонний антивирус внезапно блокируют порты 8080 (RMS Tomcat), 7001 (POS iikoCard) или 5672 (RabbitMQ для синхронизации). Обычно это происходит после обновлений операционной системы или изменения политик безопасности.

Также к потере связи ведет физический обрыв сети. Повреждение кабеля «витая пара», поломка сетевого коммутатора или сбой Wi-Fi-точки прерывают передачу данных. В этот момент мобильные терминалы официантов iikoWaiter сразу теряют подключение к базе данных, а на экране появляется ошибка, сообщающая, что iiko сервер недоступен.

Сбои системных служб Windows

Операционная система Windows принудительно останавливает службу iikoTomcat или iikoCard5POS, если на сервере заканчивается свободная оперативная память. В этом случае pos сервер iiko перестает отвечать на запросы касс.

При аварийном отключении электричества в ресторане может произойти сбой базы данных MS SQL Server. База данных Resto на SQL-сервере переходит в состояние Emergency или Suspect. Из-за этого служба SQL не запускается, что мешает старту Tomcat.

Иногда возникает рассогласование базы данных POS-сервера. Локальная база данных лояльности теряет синхронизацию с облачным сервисом iiko.biz. Из-за этого служба iikoCard5POS аварийно завершает работу при каждой попытке запуска.

Лицензионные ограничения и внешние факторы

При истечении срока действия лицензии iiko сервер блокирует подключение терминалов iikoFront и бэк-офиса iikoOffice. Владельцу заведения необходимо вовремя продлевать лицензию, чтобы избежать внезапной остановки работы.

Иногда на работу влияют глобальные сбои облака iikoCloud. Например, в июле 2025 года произошла масштабная DDoS-атака на дата-центры iiko в РФ. Это привело к временной недоступности облачных API и сервисов лояльности для тысяч ресторанов. В таких случаях локальные кассы работают, но функции лояльности остаются недоступными, пока разработчики не устранят внешнюю проблему.

4. Пошаговый алгоритм диагностики для ресторатора

Если касса iikoFront сообщает, что pos сервер iiko недоступен, или в углу экрана загорелся красный кружок, следуйте этой инструкции для поиска и устранения неисправности.

1. Проверьте сетевое соединение и IP-адреса. На проблемной кассе вызовите командную строку через комбинацию клавиш Win + R, введите cmd и нажмите Enter. Выполните команду проверки связи: ping <IP-адрес_вашего_сервера_RMS>. Если пакеты данных не доходят, проверьте сетевые провода, исправность коммутатора и настройки роутера. Если пинг идет, убедитесь, что порт открыт, с помощью команды: telnet <IP-адрес_сервера> 8080. Ошибка подключения означает, что брандмауэр заблокировал этот порт.
2. Проверьте системные службы на сервере. Перейдите на компьютер-сервер. Откройте оснастку «Службы» через команду services.msc в окне Win + R. Найдите службу iikoTomcat — она должна иметь статус «Выполняется» и тип запуска «Автоматически». Если служба остановлена, запустите ее вручную. Также убедитесь, что служба базы данных MSSQLSERVER работает стабильно, а при проблемах с лояльностью проверьте запуск службы iikoCard5POS.
3. Проверьте конфигурационные файлы на кассе. Если сеть работает исправно, но терминал iikoFront все равно не подключается, проверьте настройки конфигурации. Откройте на кассе папку по пути %AppData%\iiko\CashServer\. Найдите файл config.xml и откройте его с помощью Блокнота. Убедитесь, что в тегах <serverAddr> и <serverPort> указан актуальный IP-адрес, который имеет ваш iiko сервер, и порт 8080.
4. Проведите диагностику подключения iikoCard. Если возникли проблемы со скидками и бонусами, откройте iikoOffice. Перейдите в раздел «iikoCard», выберите «Настройки iikoCard» и откройте вкладку «Диагностика подключения». Программа автоматически проверит статус связи и версию POS-сервера. Если доступа к iikoOffice нет, зайдите в личный кабинет на портале iiko.biz, перейдите в раздел «Администрирование» и выберите «Состояние POS-ов». Если строка горит красным цветом, прочитайте текст последней ошибки. При повреждении локальной базы данных нажмите на портале кнопку «Сбросить БД POSа», после чего перезапустите службу iikoCard5POS на сервере. Система автоматически создаст новую чистую базу данных.
5. Изучите лог-файлы системы. Если стандартные шаги не помогли найти причину сбоя, изучите логи. Лог-файлы кассового терминала находятся в папке %AppData%\iiko\CashServer\Logs\. Файл error.log содержит ошибки запуска фронтальной части, а файл cash-server.log записывает весь цикл работы приложения кассы. Логи службы лояльности хранятся по пути C:\Windows\ServiceProfiles\iikoCard5POS\AppData\Roaming\iiko\iikoCard5\Logs. Ошибки локальной лояльности система записывает в файл iikoCard5-error.log.

Важно. Если вы редактируете конфигурационный файл лояльности, записывайте изменения только в файл iikoCard5Pos.override.config, иначе программа сотрет их при обновлении.

5. Ошибки администраторов при восстановлении связи

Иногда системные администраторы или владельцы ресторанов пытаются решить проблему самостоятельно, но совершают критические ошибки.

• Редактирование основного конфигурационного файла POS. При обновлении программы система полностью перезаписывает файл iikoCard5.Pos.Host.exe.config. Из-за этого вы потеряете все индивидуальные настройки подключения к базе данных. Чтобы сохранить параметры, записывайте их исключительно в конфигурационный файл iikoCard5Pos.override.config.
• Полное удаление папки CashServer. Некоторые специалисты «в целях профилактики» полностью удаляют папку %AppData%\iiko\CashServer. Это приводит к серьезным последствиям: касса теряет локальные настройки торгового оборудования, сбрасывает привязку к группе касс и закрывает активные смены сотрудников.

Частая ошибка. Полное удаление папки CashServer стирает настройки торгового оборудования, сбрасывает открытые кассовые смены и отвязывает кассу от группы.

• Блокировка DLL-файлов плагинов. Когда администратор обновляет плагины вручную, операционная система Windows может заблокировать скачанные библиотеки. Из-за этого касса выдает ошибки при запуске. Чтобы решить проблему, откройте свойства каждого файла, который вы скопировали в папку Plugins, и нажмите кнопку «Разблокировать».

6. Как POSBazar помогает настроить стабильную работу iiko

Когда в ресторане или кафе зависает касса, каждая минута простоя оборачивается потерей выручки и лояльности гостей. Чтобы быстро починить iiko сервер, ресторатору часто не хватает времени или технических знаний. Самостоятельный поиск сетевых ошибок, настройка брандмауэра или восстановление поврежденных баз данных SQL требуют высокой квалификации.

Компания POSBazar — официальный дилер iiko в России — предлагает услуги по профессиональной настройке и технической поддержке систем автоматизации. Наши инженеры оперативно диагностируют сетевые неполадки, настраивают статические IP-адреса, проверяют работу служб iikoTomcat и iikoCard5POS. Мы помогаем правильно настроить конфигурационные файлы, обновить плагины без блокировок со стороны Windows и восстановить поврежденные базы данных после аварийного отключения электричества.

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

Если ваш iiko сервер недоступен, это неприятно, но проблему легко решить. Чаще всего сбои происходят из-за сетевых настроек, остановки служб Windows или повреждения файлов конфигурации. Зная пошаговый алгоритм диагностики, вы быстро найдете причину неполадки и восстановите обслуживание гостей.

Если вам нужна помощь в настройке iiko, обновлении системы, восстановлении баз данных или подключении торгового оборудования, оставьте заявку на сайте posbazar.ru. Наши специалисты свяжутся с вами и предложат подходящий вариант технической поддержки для вашего заведения.

Коротко о важном

• Касса принимает платежи автономно не более 30 дней, затем фискальный накопитель полностью заблокирует кассу.
• При сбое главного сервера кассиры продолжают продавать блюда, но программа лояльности перестает списывать и начислять бонусы.
• Операционная система отключает службу iikoTomcat, если компьютеру перестает хватать оперативной памяти или зависает база данных SQL.
• Не удаляйте папку CashServer, так как вы сотрете параметры кассовой техники и закроете активные смены персонала.
• Настройте для главного компьютера статический сетевой адрес и откройте порты 8080 и 7001 в защитнике Windows.