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