Интеграция мобильного приложения с iiko, r_keeper и Poster
Чтобы приложение ресторана показывало актуальное меню, а заказы попадали прямо на кассу, его подключают к системе автоматизации заведения через её программный интерфейс (API). iiko, r_keeper и Poster — три самые распространённые системы в России, и у каждой свой набор возможностей для такой интеграции.
Что такое интеграция приложения с системой автоматизации
Система автоматизации ресторана — это касса и учётная система заведения: в ней заведено меню, считаются заказы, ведётся склад и программа лояльности. Интеграция приложения с такой системой — это связь между мобильным приложением и кассой через её программный интерфейс (API): набор методов, по которым внешняя программа получает и передаёт данные.
На человеческом языке: приложение и касса начинают говорить на одном языке. Гость видит в приложении то же меню и цены, что и на кассе, его заказ сразу попадает в систему заведения, а бонусы считаются по той же базе, что и при оплате в зале. Без интеграции эти данные пришлось бы вести вручную в двух местах.
Зачем ресторану интеграция приложения с кассой
Интеграция убирает ручной труд и расхождения. Эффект для заведения складывается из нескольких вещей:
- Меню всегда актуально. Цены и блюда меняются в одном месте — в кассовой системе, — и сразу отражаются в приложении.
- Заказы сразу в работе. Заказ из приложения попадает на кассу и кухню без переноса вручную, без потерь и опечаток.
- Лояльность по одной базе. Баллы и акции считаются одинаково в зале и в приложении — гость не видит разных цифр.
- Стоп-листы работают. Если блюдо закончилось, оно пропадает из приложения, и гость не заказывает то, чего нет.
- Прозрачная отчётность. Все заказы — и в зале, и из приложения — сходятся в одной системе.
Как устроена интеграция и что синхронизируется
Приложение не обращается к кассе напрямую. Между ними работает серверная часть: приложение отправляет запрос на сервер, сервер обращается к API системы автоматизации, получает или передаёт данные и возвращает результат в приложение. Такая схема надёжнее и безопаснее прямого доступа и позволяет добавить свою логику — например, расчёт зоны доставки.
Через интеграцию обычно синхронизируются:
- Меню и стоп-листы — состав, цены, наличие блюд.
- Заказы — из приложения в кассу, с составом и комментариями.
- Оплата — онлайн-оплата заказа и её отражение в системе.
- Программа лояльности — баллы, уровни, акции по единой базе.
- Остатки и статусы — наличие позиций и этапы готовности заказа.
Конкретный набор зависит от того, что отдаёт API системы и какие сценарии нужны заведению. Поэтому на старте полезно сопоставить желаемые сценарии в приложении с тем, какие методы должна предоставлять система автоматизации:
| Сценарий в приложении | Что должно быть в API системы |
|---|---|
| Актуальное меню и цены | Метод получения меню и стоп-листов |
| Оформление заказа из приложения | Метод создания заказа на кассе |
| Онлайн-оплата | Передача оплаты и её отражение в системе |
| Программа лояльности | Доступ к бонусам и клиентам (например, iikoCard в iiko) |
| Наличие позиций и статусы | Методы остатков и статусов заказа |
Если какого-то метода у системы нет, сценарий либо реализуется иначе, либо переносится на сторону приложения и сервера — это решается до старта разработки.
iiko, r_keeper и Poster: что даёт интеграция с каждой
Все три системы позволяют подключить приложение через API, но различаются масштабом и набором готовых возможностей.
iiko
iiko — система для сетей и крупных заведений с развитой облачной экосистемой и сотнями готовых интеграций. Через облачный API приложение получает меню и стоп-листы, отправляет заказы, работает с доставкой, а программа лояльности подключается через iikoCard. Это удобно, когда у сети много точек и активная доставка.
r_keeper
r_keeper — одна из старейших систем автоматизации, распространённая в крупных и сетевых заведениях. Интеграция идёт через API и интерфейсы системы: меню, передача заказов и чеков, программа лояльности. Состав доступных методов зависит от версии и согласуется на старте проекта.
Poster
Poster — облачная система, популярная у кафе и небольших сетей. У неё открытый REST-API с понятной документацией: меню и продукты, заказы и чеки, клиенты и лояльность, складские остатки. За счёт этого интеграция обычно проходит быстрее и предсказуемее.
| Система | Для кого чаще | Что даёт интеграция приложения |
|---|---|---|
| iiko | Сети и крупные заведения, доставка | Облачный API и экосистема готовых интеграций; меню и стоп-листы, заказы и доставка, лояльность через iikoCard, остатки |
| r_keeper | Крупные и сетевые заведения | Интеграция через API и интерфейсы системы; меню, передача заказов и чеков, лояльность |
| Poster | Кафе и небольшие сети | Открытый REST-API; меню и продукты, заказы и чеки, клиенты и лояльность, складские остатки |
Выбор обычно уже сделан за вас — приложение подключается к той системе, на которой работает заведение. Задача интеграции — связать приложение именно с ней и взять из её API максимум для нужных сценариев.
Не знаете, какие сценарии отдаёт ваша система? Опишите задачу — разберём доступный API и составим план интеграции. Прикинуть бюджет можно на калькуляторе стоимости разработки.
Типичные ошибки интеграции
Чаще всего проблемы возникают не в самом приложении, а на стыке с кассовой системой. Вот что важно не упустить:
- Меню ведут вручную в двух местах. Без синхронизации по API цены в приложении и на кассе расходятся — гость видит одно, платит другое.
- Заказ не доходит до кассы. Если приложение только принимает заказ, но не передаёт его в систему, персонал переносит его руками — теряется смысл интеграции.
- Лояльность считается отдельно. Баллы в приложении и в кассе по разным базам — гость недоволен, бонусы не сходятся.
- Нет обработки стоп-листов. Закончившееся блюдо остаётся в приложении, и заказ приходится отменять.
- Игнорируют ограничения API. У систем есть лимиты на частоту запросов; без их учёта обмен сбоит в час пик.
Как измерить эффект интеграции
Интеграция окупается не ощущениями, а измеримыми изменениями. На что смотреть после запуска:
- Доля заказов через приложение в общем потоке заведения — показывает, что канал реально работает.
- Время на обновление меню. При синхронизации по API оно стремится к нулю: поменяли в кассе — обновилось в приложении.
- Расхождения цен и остатков между приложением и кассой — после интеграции должны быть нулевыми.
- Повторные заказы и активность в лояльности. Единая база бонусов обычно поднимает повторные визиты.
- Доля ручных переносов заказов персоналом — после интеграции стремится к нулю.
Как проходит интеграция и что нужно от заведения
Интеграция — часть проекта по разработке приложения, а не отдельная «коробка». От заведения нужен доступ к API системы автоматизации, дальше работает команда.
Что нужно от ресторана
- Доступы к API системы — ключи и права. Обычно они есть у заведения или запрашиваются у поставщика системы.
- Решение, что синхронизируем — меню, заказы, оплата, лояльность, остатки.
- Тестовая точка или среда, на которой проверяется обмен до запуска.
Как идёт работа
Сначала разбираем, какой API доступен у вашей системы и какие сценарии он закрывает. Затем настраиваем обмен между приложением, сервером и кассой, тестируем на реальных заказах и выводим в работу. В тарифе ПРО команда FITTIN использует готовые методы интеграции, которые предоставляет заведение; в тарифе ПРО+ интеграцию обеспечивает команда FITTIN под ключ, в том числе когда готовых методов нет.
Если приложение уже есть и его нужно подключить к кассе, начните с аудита мобильного приложения: он покажет, какие сценарии можно закрыть через API вашей системы.
Сколько стоит интеграция
Отдельной цены «за интеграцию» нет — она входит в проект по разработке приложения и зависит от двух вещей: есть ли у системы готовый доступ к API и какой набор сценариев нужен. В тарифе ПРО подключение идёт на готовых методах заведения, в тарифе ПРО+ — под ключ силами команды; нестандартные сценарии считаются как доработки по Time & Materials. Ориентиры по тарифам — на странице тарифов, предварительную оценку под задачу даёт калькулятор стоимости разработки.
Кейс: приложение сети ресторанов
Как интеграция приложения с системами заведения выглядит на практике — в проекте для сети ресторанов.
Сыроварня — полноценное приложение за 2 месяца
Приложение сети ресторанов на Flutter: меню настраивается отдельно по каждому городу присутствия, заказ и онлайн-оплата, доставка отдельным разделом, бронирование столиков и программа лояльности. Приложение работает с системами заведения, чтобы меню, заказы и оплата шли единым потоком.
Другие проекты — в разделе кейсов, а услуга целиком — на странице мобильных приложений для бизнеса.
Итог
Интеграция приложения с системой автоматизации превращает приложение из отдельной витрины в рабочий канал заведения: меню, заказы, оплата и лояльность идут единым потоком с кассой. iiko, r_keeper и Poster закрывают большинство сценариев через свои API — конкретный набор зависит от системы и её версии и выясняется на старте.
С чего начать:
- Зафиксировать сценарии. Что синхронизируем — меню, заказы, лояльность — описывается в техническом задании.
- Оценить бюджет. Прикиньте срок и стоимость на калькуляторе разработки.
- Проверить готовое приложение. Если приложение уже есть — аудит покажет, как подключить его к кассе.
Опишите заведение и систему автоматизации, на которой оно работает, — разберём доступный API и предложим план интеграции. Публичная сетка цен — на странице тарифов.
Частые вопросы
С какими системами автоматизации ресторана вы интегрируете приложение?
Приложение подключается к системе автоматизации заведения через её API. Чаще всего это iiko, r_keeper и Poster — три самые распространённые системы в России. Интеграция возможна и с другими системами, у которых есть программный интерфейс. На старте проекта мы проверяем, какой API доступен у вашей системы и в какой версии.
Что синхронизируется между приложением и кассовой системой?
Обычно через интеграцию синхронизируются меню и стоп-листы, заказы из приложения в кассу, оплата, программа лояльности и бонусы, остатки и статусы заказа. Конкретный набор зависит от того, что поддерживает API системы и какие сценарии нужны заведению.
Нужны ли доступы к API от ресторана?
Да. Для интеграции нужны доступы к API системы автоматизации — ключи и права. Обычно они уже есть у заведения или запрашиваются у поставщика системы. В тарифе ПРО заказчик предоставляет готовые методы интеграции, команда FITTIN использует их при настройке; в тарифе ПРО+ интеграцию берёт на себя команда FITTIN.
Можно ли подключить программу лояльности из кассовой системы?
Да, если система это поддерживает. Например, в iiko лояльность работает через iikoCard, в Poster — через раздел клиентов и бонусов. Тогда баллы и акции в приложении и на кассе считаются по одной базе, без расхождений. Если в системе лояльности нет, её можно реализовать на стороне приложения.
Что будет, если у системы нет нужного API?
Если у системы или её версии нет нужного метода, сценарий выходит за рамки готовой интеграции и обсуждается отдельно: иногда метод появляется в более новой версии системы, иногда часть логики переносится на сторону приложения и сервера. Это выясняется на старте, чтобы не обещать функцию, которую система не отдаёт.
Сколько стоит интеграция приложения с системой автоматизации?
Стоимость зависит от того, есть ли у системы готовый доступ к API (тариф ПРО) или интеграцию нужно обеспечить под ключ (тариф ПРО+), и от набора сценариев. Ориентиры по тарифам — на странице тарифов, предварительную оценку под ваши задачи даёт калькулятор стоимости разработки.
Материал носит информационно-аналитический характер, отражает оценку команды FITTIN на дату публикации. iiko, r_keeper и Poster — товарные знаки их правообладателей; упоминаются как системы автоматизации, с которыми возможна интеграция.