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