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