Диагностическая инструкция для администратора и поставщика интеграции. Проверки выполняйте последовательно, меняя один параметр за раз. Названия экранов и доступные функции зависят от версии iiko и внешнего приложения; перед изменениями сверяйте их с официальной документацией. Здесь изложен авторский порядок поиска причины, а не гарантированное исправление любого похожего сообщения.
Как проявляется проблема
- На кассе есть открытый заказ, а интеграция возвращает пустой список.
- Заказы находятся у одних столов, но не находятся у других.
Что проверить сначала
- Использован номер вместо UUID либо стол из другой секции.
- Не совпадают организация, терминальная группа и стол.
- Подготовительный этап обмена не завершён или не проверен.
Три точки наблюдения
Полная формулировка из статьи
Проверьте соответствие всей тройки: организация, терминальная группа, стол. Удалённые и созданные заново столы могут сохранить знакомое название, но получить другую техническую связь. Если карта столов менялась, обновите справочник приложения и выясните, какие старые значения сохранились на планшетах или в постоянных QR-ссылках. Проверьте различие тел запросов. init_by_table принимает organizationId, terminalGroupId и массив tableIds. by_table принимает массивы organizationIds и tableIds; также могут применяться фильтры. Не копируйте тело первого метода во второй целиком. Сверьте доступность методов для установленной версии iiko и поставьте контроль на конкретный UUID стола. Если сценарий требует подготовительной операции, сохраните её ответ и проверьте завершение предусмотренным способом. Получение correlationId само по себе не означает, что нужные данные уже готовы для следующего чтения. Разработчику следует проследить последовательность вызовов и исключить слишком ранний запрос результата.
Маршрут диагностики
Маршрут проверок
Полная формулировка из статьи
Шаг 1. Зафиксируйте открытый заказ вместе с сотрудником: ресторан, секцию, видимый номер стола и время проверки. Затем получите соответствующий UUID штатным способом интеграции. Не угадывайте идентификатор по номеру на плане. Один и тот же видимый номер может существовать в разных секциях или разных ресторанах. Шаг 2. Проверьте соответствие всей тройки: организация, терминальная группа, стол. Удалённые и созданные заново столы могут сохранить знакомое название, но получить другую техническую связь. Если карта столов менялась, обновите справочник приложения и выясните, какие старые значения сохранились на планшетах или в постоянных QR-ссылках. Шаг 4. Если сценарий требует подготовительной операции, сохраните её ответ и проверьте завершение предусмотренным способом. Получение correlationId само по себе не означает, что нужные данные уже готовы для следующего чтения. Разработчику следует проследить последовательность вызовов и исключить слишком ранний запрос результата. Шаг 6. Проверьте, что приложение не показывает старый пустой результат из кэша после появления заказа. Затем повторите сценарий после изменения состава заказа. Если данные так и не появляются, передайте специалисту временную последовательность, идентификаторы и обезличенные ответы. Не расширяйте права наугад и не редактируйте кассовую базу напрямую.
Скриншоты и фрагменты документации
Фрагмент окна заказа с номером стола в шапке. На снимке не показан UUID стола и не подтверждена связь API. Источник: официальное руководство iikoFront 8.1, с. 106. В установленной версии вид и названия элементов могут отличаться. Руководство пользователя iikoFront 8.1 · стр. 106. Нажмите на изображение, чтобы открыть отдельно. Сверяйте источник с версией и настройками своей системы.
Редакционная визуализация фрагмента OpenAPI, не скриншот интерфейса iikoCloud API — официальный справочник OpenAPI. Нажмите на изображение, чтобы открыть отдельно. Сверяйте источник с версией и настройками своей системы.
Редакционная визуализация фрагмента OpenAPI, не скриншот интерфейса iikoCloud API — официальный справочник OpenAPI. Нажмите на изображение, чтобы открыть отдельно. Сверяйте источник с версией и настройками своей системы.
Пошаговое решение
Отмечайте выполненные проверки. Отметки действуют до перезагрузки страницы.
Иллюстрация рабочего процесса; сгенерированное фото, не интерфейс iiko. 
Иллюстрация рабочего процесса; сгенерированное фото, не интерфейс iiko.
Развилка результата
Полная формулировка из статьи
Критерий результата: Интеграция различает свободный стол и согласованный открытый заказ в нужной секции, а результат обновляется после штатного изменения. На планшете и сервере сохранён один и тот же UUID стола. Проверка не создала дополнительный заказ или счёт. Передача специалисту: Если минимальный контрольный запрос остаётся неуспешным, передайте поставщику интеграции версию приложения, время, адрес метода и обезличенный ответ. Укажите, что уже проверено и какой результат ожидался. Секреты передавайте только предусмотренным защищённым способом; в обычное обращение достаточно идентификатора корреляции и описания сценария.
Как понять, что проблема решена
Интеграция различает свободный стол и согласованный открытый заказ в нужной секции, а результат обновляется после штатного изменения. На планшете и сервере сохранён один и тот же UUID стола. Проверка не создала дополнительный заказ или счёт.
Как снизить риск повторения
После изменений плана зала проверяйте соответствие столов на всех устройствах. Сохраняйте UUID отдельно от отображаемого номера. Предусмотрите обновление справочников и диагностику подготовительных операций в интеграции.
Если проблема осталась
Если минимальный контрольный запрос остаётся неуспешным, передайте поставщику интеграции версию приложения, время, адрес метода и обезличенный ответ. Укажите, что уже проверено и какой результат ожидался. Секреты передавайте только предусмотренным защищённым способом; в обычное обращение достаточно идентификатора корреляции и описания сценария.
Что передать в поддержку
Скопируйте шаблон и заполните его без паролей, API-ключей, данных карт и сведений о гостях.
Проблема: iiko API возвращает пустые заказы по столу: проверяем ID и сценарий обмена Версия и компонент iiko: Ресторан / рабочее место: Время сбоя и часовой пояс: Точный текст сообщения: Что ожидалось / что произошло: Какие проверки выполнены: Результат каждой проверки: Идентификатор операции (если допустимо):
Где помогает Menu 360
Menu 360 интегрируется с iiko и даёт ресторану цифровое меню с автоматическими продажами и допродажами. В зале сначала проверьте связь планшета с реальным столом. После этого можно тестировать предложение напитка или десерта: гость должен увидеть свою корзину, а сотрудник — тот же состав на правильном столе.
Вопросы и ответы
Почему одинаковое тело не подходит init_by_table и by_table?
У них разная задача и схема: подготовка использует одну организацию и терминальную группу, чтение — массив организаций и столов. Названия singular/plural имеют значение. Сравните готовый JSON по каждому endpoint отдельно, а не только содержимое переменных в программе.
Стол точно выбран правильно, что ещё может дать пустой список?
Проверьте фильтры статусов и дат, фактическое завершение подготовки, поддерживаемую версию и кэш результата приложения. Затем сравните заведомо свободный стол с подтверждённым открытым заказом. Только после этих проверок пустой массив можно интерпретировать в контексте вашей операции.
Источники и применимость
Официальная документация служит основой проверки возможностей iiko. Последовательность диагностики и контрольные примеры разработаны редакцией Menu 360; это не подтверждение ошибки именно в вашей конфигурации.
Обсуждения похожих ситуаций
Вопросы пользователей подтверждают наличие похожих ситуаций. Советы в обсуждениях могут относиться к старым версиям или другому модулю.
- Обсуждение: iiko API возвращает пустые заказы по столу: проверяем ID и сценарий обмена
Вопрос описывает HTTP 200 и пустой orders при наличии заказа; комментарии касаются tableIds и подготовительного вызова.