Интеграция приложения с iiko

Подключение приложения ресторана к iiko: меню, стоп-листы, заказы

Связываем мобильное приложение и сайт ресторана с iiko: меню и стоп-листы приходят из кассовой системы по расписанию, заказ из приложения попадает на кассу нужной точки, а статус готовности возвращается гостю. Для отдельного ресторана и для сети с десятками точек на разных юрлицах.

Обсудить проект Смотреть кейс One Price Coffee

Интеграция мобильного приложения ресторана с iiko: меню в смартфоне и кассовый терминал, связанные обменом данных

Зачем это нужно

Зачем связывать приложение ресторана с iiko

Если приложение живёт отдельно от кассы, меню в нём ведут вручную, заказы переносят на кассу руками, а гость может оплатить позицию, которая закончилась ещё утром.

Интеграция с iiko убирает этот разрыв: меню, цены и стоп-листы берутся из кассовой системы, заказ попадает в iiko нужной точки, а статус готовности возвращается гостю.

Приложение разрабатываем на модульной Flutter-платформе FITTIN, связку с iiko настраиваем под формат заведения. Обзор интеграций с кассовыми системами — в статье «Интеграция приложения с iiko, r_keeper и Poster».

Кейс One Price Coffee

Обмен данными

Что синхронизируется между приложением и iiko

Приложение не обращается к кассе напрямую. Между ними работает серверная часть: она забирает данные из облачного API iiko, хранит их и отдаёт в приложение, поэтому обмен выдерживает час пик и не зависит от того, сколько гостей одновременно открыли меню.

Данные	Направление	Как это работает
Организации и точки	iiko → приложение	Список организаций и терминальных групп сети хранится на сервере; к ним привязаны график, адрес на карте и настройки оплаты каждой точки.
Номенклатура и цены	iiko → приложение	Выгрузка по расписанию и инкрементально: сервер забирает только позиции, изменившиеся с прошлой ревизии, а не весь каталог.
Модификаторы и комбо	iiko → приложение	Объёмы, добавки, группы модификаторов и комбо-наборы переносятся из iiko, поэтому сумма в корзине совпадает с кассой.
Фото и описания	админка → приложение	Фотографии, видео и описания блюд ведутся в админке приложения, и очередная выгрузка из iiko их не перезаписывает.
Стоп-листы	iiko → приложение	Отдельное расписание, чаще, чем у меню: в проекте One Price Coffee — каждые 15 минут по всем точкам сети.
Заказы	приложение → iiko	Заказ создаётся в iiko выбранной точки с составом, модификаторами, типом оплаты и временем выдачи.
Статусы заказа	iiko → приложение	Сервер отслеживает статусы кухни и кассы и переводит их в понятные гостю этапы — от «принят» до «готов к выдаче».
Кассовые смены	iiko → приложение	Через iikoServer видно, открыта ли смена на терминале: точка без открытой смены не принимает заказы из приложения.
Гость и лояльность	в обе стороны	Профиль гостя связывается с его карточкой в iiko и в программе лояльности — через iikoCard или внешнюю систему, которой уже пользуется заведение.

Одному ресторану обычно хватает меню, стоп-листов и заказов, сети с доставкой и программой лояльности нужен весь список. Если помимо кассы приложение связывают с CRM или учётной системой, посмотрите услуги интеграция приложения с CRM и ERP-интеграция.

Путь заказа

Как заказ из приложения попадает на кассу iiko

Для гостя это несколько касаний. На сервере каждый шаг сверяется с данными iiko, чтобы заказ не пришёл туда, где его не смогут приготовить.

ШАГ 01

Выбор точки

Приложение показывает только точки с открытой кассовой сменой и работающим терминалом.

ШАГ 02

Корзина

Позиции из стоп-листа выбранной точки недоступны, модификаторы и комбо считаются по ценам iiko.

ШАГ 03

Время выдачи

Слоты строятся по графику точки в её часовом поясе и не раньше, чем кухня успеет приготовить заказ.

ШАГ 04

Оплата и отправка

Корзина повторно сверяется со стоп-листом, после оплаты заказ создаётся в iiko точки с нужным типом оплаты.

ШАГ 05

Статус гостю

Сервер следит за статусом заказа в iiko и присылает гостю push-уведомление, когда заказ готов.

Третий шаг появился из практики: iiko отклоняет заказ, если время выдачи наступает раньше, чем кухня успевает его приготовить. Поэтому слоты и вариант «приготовить сейчас» рассчитываются заранее, до оплаты, а не выясняются отказом кассы. Если заведению нужна ещё и доставка с зонами и курьерами, посмотрите услугу приложения для доставки еды.

Опыт поддержки

Где интеграция с iiko даёт сбои и как мы их закрываем

Большинство проблем возникает не в самом приложении, а на стыке с кассовой системой. Эти ситуации мы разбирали на поддержке работающих проектов и закладываем в новые интеграции с первого этапа.

Ситуация

Что делаем

Заказ оплачен, но не дошёл до кассы

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

Касса недоступна в момент оплаты

Приём платежа и отправка заказа в iiko разнесены: сбой кассовой системы не ломает обработку оплаты, а возвраты проходят по событиям платёжной системы.

Большое меню выгружается с обрывами

Выгрузка идёт по ревизиям и с повторными попытками. При обрыве соединения в приложении остаётся последнее актуальное меню.

Сессия iikoServer завершилась

Авторизация и состояние смен под мониторингом: сессия восстанавливается, а пока данных о смене нет, точка не принимает заказы.

Точки не совпадают со справочником

Регулярно сверяем организации, терминальные группы и типы оплат в iiko с настройками приложения, чтобы гость не видел дубли и закрытые точки.

iiko обновляет методы API

Переход на новые версии методов — например, новую версию выгрузки меню — планируем заранее и проверяем на тестовой точке до переключения.

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

Подготовка

Что нужно от ресторана для подключения к iiko

Разработку и настройку обмена ведёт команда, но несколько вещей есть только у заведения.

Доступ к облачному API iiko

Ключ API с правами на организации заведения. Если ключа ещё нет, его выпускают в веб-кабинете iiko или через интегратора, который обслуживает ресторан.

Настройки точек

Актуальные организации и терминальные группы, типы оплат для заказов из приложения, время приготовления и график работы каждой точки.

Решение по сценариям

Что синхронизируем: меню, заказы, самовывоз или доставку, программу лояльности, историю заказов гостя.

Тестовая точка

Точка или терминал, на котором обмен проверяется на реальных заказах до подключения всей сети.

Когда правил много — у сети несколько юрлиц, разные схемы оплаты и своя логика лояльности, — их удобно зафиксировать в техническом задании или разобрать на бизнес-анализе проекта.

Как ведём проект

Пять этапов подключения приложения к iiko

На модульной платформе отдельная фаза ТЗ не нужна: согласованные макеты и схема обмена с iiko становятся техническим заданием для договора. Договор подписывается после второго этапа.

ЭТАП 1 · СХЕМА ОБМЕНА

Проектирование

Разбираем настройки iiko: организации, терминалы, типы оплат, меню. Фиксируем, какие данные и как часто синхронизируются.

ЭТАП 2 · МАКЕТЫ И ДОГОВОР

UX/UI-дизайн

Кастомизация под бренд, экраны меню, корзины и выбора точки. После согласования макетов и схемы обмена — договор.

ЭТАП 3 · РАБОТАЮЩИЙ ОБМЕН

Разработка и интеграция

Настройка модулей платформы, выгрузка меню и стоп-листов, отправка заказов и получение статусов из iiko.

ЭТАП 4 · ПРОВЕРКА НА ТОЧКЕ

Тестирование

Реальные заказы на тестовом терминале: оплата, отмена, возврат, стоп-лист, закрытая смена, разные часовые пояса.

ЭТАП 5 · ЗАПУСК

Релиз и мониторинг

Публикация в целевых сторах, подключение точек волнами, мониторинг обмена с iiko и поддержка по лицензии.

Интеграция платформы под бренд вместе с подключением к iiko занимает до 30 рабочих дней: третий и четвёртый этапы частично идут параллельно, обмен проверяется по мере подключения. Если у заведения нестандартная схема — франшиза с разными юрлицами, сложная матрица цен, несколько систем лояльности, — проект идёт по тарифу Индивидуальный: от 30 рабочих дней, точный срок фиксируем после согласования объёма работ.

Кейсы

Интеграция с iiko в проектах FITTIN

Основной проект с iiko в нашей практике — приложение федеральной сети кофеен по франшизе. Метрики — со страницы кейса.

HoReCa · сеть кофеен по франшизе

One Price Coffee — iiko в сети из 350+ кофеен

Точки сети принадлежат разным франчайзи, а меню, лояльность и приложение общие. Через iiko работают номенклатура с модификаторами, стоп-листы, приём заказов к выбранному времени, часовые пояса точек и контроль кассовых смен.

350+точек сети

15 минутобновление стоп-листов

По ревизиямвыгрузка каталога

Что закрывает интеграция в проекте

Задачи, которые команда вела в разработке и на поддержке приложения сети.

Меню и комбо по ревизиям iiko
Стоп-листы по всем организациям
Заказ к времени с учётом готовки
Кассовые смены через iikoServer
Сверка точек терминалы и оплаты
Новая версия API меню в поддержке

В другом ресторанном проекте на данных iiko построена история заказов гостя: блюда из кассовой системы сопоставляются с каталогом приложения по артикулу iiko, а профиль гостя связан с его карточкой в кассе и в CRM. Другие проекты — в портфолио FITTIN.

Экраны приложения One Price Coffee, связанного с iiko: каталог напитков из номенклатуры кассы, выбор времени самовывоза и программа лояльности

Отзывы

Отзывы о нас

Сыроварня

«Сотрудничество с Fittin — находка для нашего бизнеса. Премиальное и высокотехнологичное решение и сервис: быстрая обработка запросов, мгновенное решение техпроблем».

DaisyKnit

«Команда Fittin — это не просто подрядчик, а настоящий партнёр. Профессионализм, вовлечённость, скорость решения задач — и положительная динамика по всем метрикам приложения.»

Gulliver

«После года работы над мобильным приложением мы доверили FITTIN перевод сайта с Битрикс на Flutter — нужно было выстроить единую экосистему с приложением. Задача нетривиальная, но команда довела её до результата.»

Стоимость

Сколько стоит интеграция приложения с iiko

Отдельного прайса за подключение к iiko нет: интеграция входит в проект приложения на платформе, а модель оплаты состоит из трёх частей. Суммы по тарифам опубликованы на странице тарифов.

Интеграция платформы

единоразовая оплата

Кастомизация под бренд, настройка модулей, подключение к iiko, оплате и лояльности, публикация в сторах.

Лицензия с поддержкой

ежемесячный платёж

Использование платформы. В лицензионные платежи включены затраты на техподдержку команды FITTIN, мониторинг обмена с iiko, обновления модулей и безопасности.

Доработки по T&M

смета перед стартом задачи

Сценарии вне базовых модулей — конструктор блюд, история заказов из iiko, нестандартная лояльность — по модели Time & Materials с оценкой по часам.

Тариф	Подключение к iiko	Что входит
ПРО	Заказчик предоставляет доступ к облачному API iiko и настроенные точки: терминальные группы, типы оплат, график. Команда FITTIN использует их при настройке приложения	Приложение под бренд на готовых модулях, меню и стоп-листы из iiko, приём заказов, публикация в сторах, поддержка по лицензии
ПРО+	Под ключ силами команды FITTIN: сверка настроек iiko, работа с интегратором заведения, подключение оплаты и лояльности	Весь объём ПРО и интеграции с кассовой системой, лояльностью и эквайрингом под ключ
Индивидуальный	Индивидуальная схема для сетей с франшизой, несколькими юрлицами и уникальными механиками, как в кейсе One Price Coffee	Дополнительные интеграции и функционал; цена и состав работ — по результатам аудита задач, срок от 30 рабочих дней

Актуальные суммы — на странице тарифов, ориентир под ваш набор сценариев — на калькуляторе стоимости. Если приложение у заведения уже работает и его делал другой подрядчик, начните с аудита мобильного приложения: он покажет, что нужно доработать для обмена с iiko.

Обсудить проект Посчитать бюджет Тарифы платформы

Частые вопросы об интеграции с iiko

Сколько стоит интеграция приложения с iiko?

Интеграция с iiko входит в проект приложения на платформе FITTIN, отдельного прайса за неё нет. Стоимость складывается из трёх частей: единоразовой интеграции платформы под бренд, ежемесячных лицензионных платежей, в которые включены затраты на техподдержку команды, и доработок нового функционала по Time & Materials со сметой и оценкой по часам перед стартом задачи. В тарифе ПРО подключение идёт на доступах к API iiko, которые предоставляет заведение, в тарифе ПРО+ — под ключ силами команды. Суммы — на странице тарифов, ориентир — на калькуляторе.

Какие данные синхронизируются между приложением и iiko?

Из iiko в приложение приходят организации и точки, номенклатура с ценами, модификаторами и комбо, стоп-листы, статусы заказов и состояние кассовых смен. Из приложения в iiko уходят заказы с составом, типом оплаты и временем выдачи. Профиль гостя связывается с его карточкой в iiko и в программе лояльности. Фото и описания блюд ведутся в админке приложения и не перезаписываются выгрузкой из кассы.

Как часто обновляются меню и стоп-листы из iiko?

Меню и стоп-листы выгружаются по разным расписаниям. Номенклатура обновляется инкрементально: сервер забирает только позиции, изменившиеся с прошлой ревизии. Стоп-листы обновляются чаще — в проекте One Price Coffee каждые 15 минут по всем точкам сети. Перед оплатой корзина дополнительно сверяется со стоп-листом, поэтому закончившаяся позиция не уйдёт в заказ.

Что нужно от ресторана для подключения приложения к iiko?

Доступ к облачному API iiko с правами на организации заведения, актуальные настройки точек — терминальные группы, типы оплат для заказов из приложения, время приготовления и график работы, — и тестовая точка для проверки обмена. В тарифе ПРО+ сверку настроек iiko и работу с интегратором заведения команда FITTIN берёт на себя.

Можно ли подключить к iiko приложение, которое уже работает?

Да. Если приложение делал другой подрядчик, начинаем с аудита мобильного приложения: смотрим, как устроены каталог, корзина и серверная часть и что нужно доработать для обмена с iiko. Дальше приложение можно взять на техническую поддержку и развивать вместе с интеграцией или перенести на модульную платформу FITTIN.

Работает ли интеграция с iiko для сети по франшизе?

Да. Организации и терминальные группы сети хранятся на сервере приложения, а платёжные реквизиты, система налогообложения и доступы к лояльности настраиваются по каждой точке. Заказ уходит в iiko той организации, к которой относится выбранная точка. При смене франчайзи сверяем справочник точек, чтобы в приложении не появлялись дубли. Так устроено приложение сети One Price Coffee на 350+ кофеен.

Сколько времени занимает подключение приложения к iiko?

Интеграция платформы FITTIN под бренд вместе с подключением к iiko занимает до 30 рабочих дней: выгрузка меню и стоп-листов, приём заказов, статусы, оплата и публикация в сторах. Если нужна индивидуальная схема — франшиза с разными юрлицами, сложная матрица цен, история заказов из iiko, — проект идёт по тарифу Индивидуальный, от 30 рабочих дней. Точный срок фиксируется после согласования объёма работ.

Расскажите о ресторане и iiko

Интеграция приложения ресторана с iiko — обсудить проект с командой FITTIN