Диагностическая инструкция для администратора и поставщика интеграции. Проверки выполняйте последовательно, меняя один параметр за раз. Названия экранов и доступные функции зависят от версии iiko и внешнего приложения; перед изменениями сверяйте их с официальной документацией. Здесь изложен авторский порядок поиска причины, а не гарантированное исправление любого похожего сообщения.
Как проявляется проблема
- API возвращает TerminalGroupDisabled.
- Часть филиалов принимает заказы, один ресторан перестал принимать.
Что проверить сначала
- Группа недоступна или её регистрация требует проверки специалистом.
- Терминальная группа принадлежит другой организации.
- В интеграции осталась старая привязка после переноса оборудования.
Три точки наблюдения
Полная формулировка из статьи
Проверьте, что выбранная группа действительно относится к выбранной организации. Сравните справочники, а не названия полей в кабинете. В сетях одинаковые названия терминалов особенно легко перепутать. Если пара несовместима, исправляйте выбор адресата в интеграции; переустановка кассы в такой ситуации не решает причину. Уполномоченный специалист должен проверить состояние группы и её регистрацию в инфраструктуре iiko. Уточните, не менялись ли главный терминал, сервер, лицензия или схема ресторана. Не выполняйте повторную регистрацию вслепую в рабочую смену. Сначала сохраните текущие параметры и согласуйте порядок восстановления с обслуживающим партнёром. Если адресат определяется автоматически, проследите один заказ от ввода адреса до готового тела запроса. Запишите отдельно выбранную организацию и группу. Данные из старого кэша и свежего расчёта не должны смешиваться. Проверка особенно важна после изменения зон или добавления нового филиала в общую сеть.
Маршрут диагностики
Маршрут проверок
Полная формулировка из статьи
Шаг 1. Сохраните оригинальный текст ошибки и параметры адресата. В журнале должны остаться идентификаторы организации, терминальной группы и корреляции, а также местное время ресторана. Отдельно запишите, работает ли касса для обычных действий сотрудников. Это позволит не смешивать локальную работоспособность кассы и облачный приём заказов. Шаг 2. Проверьте, что выбранная группа действительно относится к выбранной организации. Сравните справочники, а не названия полей в кабинете. В сетях одинаковые названия терминалов особенно легко перепутать. Если пара несовместима, исправляйте выбор адресата в интеграции; переустановка кассы в такой ситуации не решает причину. Шаг 4. Если адресат определяется автоматически, проследите один заказ от ввода адреса до готового тела запроса. Запишите отдельно выбранную организацию и группу. Данные из старого кэша и свежего расчёта не должны смешиваться. Проверка особенно важна после изменения зон или добавления нового филиала в общую сеть. Шаг 6. Когда состояние восстановлено, выполните согласованный тест и проверьте конечный результат у кассира. Затем проверьте очередь неуспешных заказов: некоторые могут требовать ручной сверки, а не автоматического повтора. Зафиксируйте, какие обращения уже обработаны сотрудниками, чтобы исключить повторную готовку и повторный расчёт.
Скриншоты и фрагменты документации
Редакционная визуализация фрагмента OpenAPI, не скриншот интерфейса iikoCloud API — официальный справочник OpenAPI. Нажмите на изображение, чтобы открыть отдельно. Сверяйте источник с версией и настройками своей системы.
Редакционная визуализация фрагмента OpenAPI, не скриншот интерфейса iikoCloud API — официальный справочник OpenAPI. Нажмите на изображение, чтобы открыть отдельно. Сверяйте источник с версией и настройками своей системы.
Редакционная визуализация фрагмента OpenAPI, не скриншот интерфейса iikoCloud API — официальный справочник OpenAPI. Нажмите на изображение, чтобы открыть отдельно. Сверяйте источник с версией и настройками своей системы.
Пошаговое решение
Отмечайте выполненные проверки. Отметки действуют до перезагрузки страницы.
Иллюстрация рабочего процесса; сгенерированное фото, не интерфейс iiko. 
Иллюстрация рабочего процесса; сгенерированное фото, не интерфейс iiko.
Развилка результата
Полная формулировка из статьи
Критерий результата: Ошибка больше не появляется в новом контрольном запросе, заказ относится к ожидаемой организации и виден на её кассе. Сотрудник подтверждает единственный экземпляр. Старые обращения сверены отдельно и не отправлены повторно без проверки. Передача специалисту: Подключайте обслуживающего специалиста, если требуется изменение регистрации терминала, прав организации или логики отправки. Подготовьте один воспроизводимый пример вместо большого архива без пояснений. Укажите исходное и ожидаемое состояние, точку назначения и последовательность действий. Для повторной отправки сначала установите судьбу первоначального обращения.
Как понять, что проблема решена
Ошибка больше не появляется в новом контрольном запросе, заказ относится к ожидаемой организации и виден на её кассе. Сотрудник подтверждает единственный экземпляр. Старые обращения сверены отдельно и не отправлены повторно без проверки.
Как снизить риск повторения
Согласовывайте изменение схемы терминалов с поставщиками внешних сервисов. После изменения оборудования обновляйте таблицу соответствий и проверяйте облачную передачу заказов до начала следующего пикового периода.
Если проблема осталась
Подключайте обслуживающего специалиста, если требуется изменение регистрации терминала, прав организации или логики отправки. Подготовьте один воспроизводимый пример вместо большого архива без пояснений. Укажите исходное и ожидаемое состояние, точку назначения и последовательность действий. Для повторной отправки сначала установите судьбу первоначального обращения.
Что передать в поддержку
Скопируйте шаблон и заполните его без паролей, API-ключей, данных карт и сведений о гостях.
Проблема: iiko: TerminalGroupDisabled — группа отключена или не зарегистрирована Версия и компонент iiko: Ресторан / рабочее место: Время сбоя и часовой пояс: Точный текст сообщения: Что ожидалось / что произошло: Какие проверки выполнены: Результат каждой проверки: Идентификатор операции (если допустимо):
Где помогает Menu 360
Работа Menu 360 с iiko требует правильной точки назначения заказа. После восстановления группы проверьте на одном примере и основной товар, и автоматическую допродажу: например, десерт к ужину. Так запуск цифрового меню и автоматических продаж опирается на подтверждённый маршрут, а персонал видит полный состав в привычной системе.
Вопросы и ответы
Работающая касса исключает TerminalGroupDisabled?
Нет. Возможность сотрудника работать на кассе не доказывает, что запрос направлен в правильную зарегистрированную группу. Сначала сопоставьте UUID организации и группы. Затем проверьте состояние облачной связи; эти проверки относятся к разным частям цепочки.
Как отличить неверную группу от недоступной связи?
Сверьте возвращаемый справочник групп с выбранной организацией, включая отключённые записи при поддержке используемого метода. Если группа правильная, проверяйте доступность выбранного терминала штатной диагностикой поставщика. Ошибку нельзя надёжно определить по одному только названию ресторана в интерфейсе.
Источники и применимость
Официальная документация служит основой проверки возможностей iiko. Последовательность диагностики и контрольные примеры разработаны редакцией Menu 360; это не подтверждение ошибки именно в вашей конфигурации.
Обсуждения похожих ситуаций
Вопросы пользователей подтверждают наличие похожих ситуаций. Советы в обсуждениях могут относиться к старым версиям или другому модулю.
- Обсуждение: iiko: TerminalGroupDisabled — группа отключена или не зарегистрирована
В длинной теме показана ошибка TerminalGroupDisabled и отдельно разобрана несовместимая пара ресторана и группы.