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