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