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