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