Интеграция iiko с мобильным приложением: пошаговое руководство

iiko — одна из двух доминирующих систем автоматизации ресторанов в Казахстане наряду с R-Keeper. По оценкам рынка, iiko используют более 3 500 заведений в РК, и доля системы растёт на 15% ежегодно. Если ваш ресторан работает на iiko и вы хотите запустить мобильное приложение — интеграция между ними критически важна.

Без интеграции ваши сотрудники будут вручную переносить заказы из приложения в iiko, что приводит к ошибкам, задержкам и потере денег. В этом руководстве — пошаговый план интеграции, основанный на опыте подключения более 40 ресторанов в Алматы, Астане и Шымкенте.

Что даёт интеграция iiko с мобильным приложением

Полноценная интеграция обеспечивает автоматическую синхронизацию в реальном времени:

• Меню: блюда, цены, стоп-лист, модификаторы — всё подтягивается из iiko автоматически
• Заказы: заказ из приложения мгновенно попадает на кухонный экран iiko
• Программа лояльности: бонусы, скидки, уровни — единая система для зала и приложения
• Оплата: статус оплаты синхронизируется с кассой iiko
• Аналитика: все заказы из приложения видны в отчётах iiko

Результат: среднее время обработки заказа из приложения сокращается с 4–5 минут (ручной ввод) до 15 секунд (автоматический). Подробнее о полном цикле автоматизации — в статье Автоматизация ресторана: от заказа до выдачи.

Шаг 1: Подготовка iiko к интеграции

Прежде чем подключать API, убедитесь, что ваша iiko настроена корректно:

• Версия iiko: минимум iiko 8.0 для работы с iiko Cloud API (iikoTransport)
• Лицензия: необходим модуль iikoWeb или API-лицензия (от 15 000 тенге/мес)
• Структура меню: все блюда должны иметь заполненные карточки с фото, описанием и модификаторами
• Стоп-лист: настроен и актуален — иначе клиенты будут заказывать отсутствующие блюда

Получение API-ключа

Для доступа к iiko Cloud API вам нужен API Login. Получить его можно в личном кабинете iiko (iiko.biz) или через обращение к вашему дилеру iiko в Казахстане. API Login — это строковый ключ, который используется для получения Bearer-токена при каждом запросе.

Шаг 2: Архитектура интеграции

Существует два подхода к интеграции:

Прямая интеграция (API-to-API): мобильное приложение напрямую обращается к iiko Cloud API. Проще в реализации, но менее гибко и создаёт зависимость от доступности серверов iiko.

Через middleware (рекомендуемый): между приложением и iiko стоит промежуточный сервер, который кеширует меню, обрабатывает заказы и обеспечивает отказоустойчивость.

Мы рекомендуем middleware-подход. Если серверы iiko временно недоступны (а это случается 2–3 раза в месяц на 10–30 минут), промежуточный сервер продолжит принимать заказы и отправит их в iiko, как только связь восстановится.

Шаг 3: Синхронизация меню

Синхронизация меню — первый и самый важный этап. API-метод /api/1/nomenclature возвращает полную номенклатуру ресторана: группы, блюда, модификаторы, размеры, цены.

Ключевые моменты:

• Полная синхронизация — раз в 15 минут (для отлова изменений цен и новых блюд)
• Стоп-лист — каждые 2 минуты через /api/1/stop_lists
• Изображения блюд: iiko хранит только ссылки — фотографии нужно хранить на своём CDN
• Модификаторы: обязательные (выбор гарнира) и опциональные (добавки) — обрабатывать по-разному

Шаг 4: Приём и отправка заказов

Заказ из мобильного приложения отправляется в iiko через метод /api/1/deliveries/create для доставки или /api/1/order/create для заказа в зале.

Обязательные поля заказа:

• Состав заказа с ID блюд из номенклатуры iiko
• Тип заказа: доставка, самовывоз, в зале
• Контакт клиента: телефон (для связи курьера при доставке)
• Способ оплаты: онлайн (предоплата) или при получении
• Комментарий к заказу и адрес доставки (если применимо)

После создания заказа подписывайтесь на вебхуки iiko для отслеживания статуса: «Принят» → «Готовится» → «Готов» → «Выдан». Эти статусы отображаются в реальном времени в приложении гостя.

Шаг 5: Интеграция программы лояльности

iiko имеет встроенную программу лояльности (iikoCard), но для мобильного приложения лучше использовать внешнюю программу с синхронизацией баланса через API. Это даёт больше гибкости в механиках начисления и списания бонусов.

О том, какую программу лояльности выбрать — кэшбэк, скидки или уровневую — читайте в нашем разборе Программа лояльности ресторана: кэшбэк, скидки или уровни.

Шаг 6: Интеграция оплаты

Для Казахстана критически важна интеграция с Kaspi QR — этим способом оплачивают до 70% заказов через мобильные приложения. Также необходимо поддержать оплату банковскими картами через Halyk Bank или Forte Bank.

Схема оплаты:

• Гость оплачивает в приложении → платёж проходит через платёжный шлюз
• Middleware получает подтверждение оплаты
• В iiko заказ создаётся с типом оплаты «Предоплата онлайн»
• Фискальный чек формируется автоматически через кассу iiko

Шаг 7: Тестирование и запуск

Перед боевым запуском обязательно:

• Провести 50+ тестовых заказов через все сценарии (доставка, самовывоз, зал)
• Проверить корректность стоп-листа: заказать блюдо → поставить в стоп → убедиться, что в приложении оно стало недоступно
• Протестировать отказоустойчивость: отключить интернет на сервере iiko и проверить, что заказы буферизуются
• Сверить финансовые отчёты: сумма заказов в приложении должна совпадать с iiko

Типичные проблемы и решения

Проблема: Заказ уходит в iiko, но не появляется на кухонном экране.
Решение: Проверьте привязку типа заказа к кухонному экрану в настройках iiko. Заказы из приложения часто имеют отдельный тип, который не привязан к экрану по умолчанию.

Проблема: Модификаторы не передаются.
Решение: В API iiko модификаторы передаются как отдельный массив внутри позиции заказа. Проверьте, что group_id модификатора указан корректно.

Проблема: Дублирование блюд после синхронизации.
Решение: Используйте ID блюда из iiko как первичный ключ. Никогда не создавайте блюда в приложении вручную — только синхронизация из iiko.

Интеграция iiko с мобильным приложением — это технически несложный, но ответственный процесс. Пакеты услуг DELICIO включают полную интеграцию с iiko «под ключ» — от настройки API до обучения персонала. Мы также работаем с R-Keeper: подробности в статье Интеграция R-Keeper с мобильным приложением. Свяжитесь с нами для расчёта стоимости интеграции.