Подключение iiko (ресторан, кафе, бар)
Связать iiko с кабинетом одним ключом: чеки с себестоимостью, меню, залы и гости из заказов.
Что даёт интеграция
- чеки iiko попадают в кабинет с позициями, оплатами и себестоимостью каждой строки — маржа в аналитике считается сама, без ручного ввода;
- гости из заказов (у кого в кассе указан телефон) появляются в «Подписчиках», и чеки ложатся на их карточки — база кассы и подписчики бота становятся одной базой;
- меню с ценами и себестоимостью подтягивается в «Прайс»;
- залы и столы из iiko появляются в «Бронях» — бронь садится на реальный стол;
- гость получает карту Wallet, бота и гостевое приложение — со стороны заведения дорабатывать ничего не нужно.
Обмен идёт в одну сторону: мы читаем iiko и ничего в кассе не меняем.
Что понадобится
Один ключ — API-ключ облачного API iiko (в iiko его ещё называют apiLogin). Cloud API входит в облачные тарифы iikoCloud Pro и Enterprise; на младших тарифах и у локальной кассы облачных сервисов нет — уточните тариф у своего дилера iiko.
Ключ создаётся в бэк-офисе iikoWeb: раздел «Настройки Cloud API» (быстрее всего найти поиском по слову «API» в шапке) → вкладка «Интеграции» → «Добавить интеграцию»:
- имя — любое, например «axle·app», email — ваш;
- шаблон прав — «Все права»;
- на вкладке «Подключённые точки» → «Добавить точку» отметьте своё заведение;
- срок действия ключа iiko ставит сам, максимум два года.
Сохраните и скопируйте ключ кнопкой рядом с ним.
И ещё одна галочка, без которой iiko не отдаст ни столов, ни заказов: там же, на вкладке «Организации», откройте свою организацию и в блоке «Разрешить доступ к терминальным группам» отметьте группу терминалов (кассу) заведения. Сохраните.
Адрес сервера и часовой пояс не нужны: облако одно на всех, а время заказов касса отдаёт уже во времени вашей точки.
Шаг 1. Подключите ключ
Кабинет → Интеграции → карточка iiko → Подключить. Вставьте apiLogin → Проверить и сохранить.
Если ключ верный, появится список организаций iiko, доступных этому ключу.
Ошибки под формой говорят сами за себя:
- «iiko не принял API-ключ» — ключ с опечаткой, отозван или истёк его срок: пересоздайте в iikoWeb → «Настройки Cloud API» → «Интеграции»;
- «лицензия Cloud API истекла» — тариф без Cloud API или не оплачен: решается через вашего дилера или поддержку iiko;
- «не заданы appId и clientSecret» — это на нашей стороне, напишите в поддержку Axle.
Шаг 2. Выберите организацию
У одиночного заведения организация одна — отметьте её и нажмите Привязать организацию. У сети ключ может видеть несколько организаций — выберите ту, что соответствует этой точке.
Статус сменится на «подключён» — связь работает.
Если вместо этого написано, что iiko не даёт доступ к кассам, — не стоит галочка «Разрешить доступ к терминальным группам» (см. выше). Поставьте её в iikoWeb и нажмите Привязать организацию ещё раз.
Шаг 3. Посмотрите «Проверку подключения»
Сразу под соединением — блок Проверка подключения: он спрашивает iiko и нашу базу и показывает строками, что работает (✅), где теряются данные (⚠️) и что сломано (❌). У каждой строки — что сделать. Что значат строки:
| Строка | Что значит и что делать |
|---|---|
| Ключ принят | Всё в порядке. ❌ — ключ с опечаткой, отозван или истёк: создайте новый в iikoWeb → «Настройки Cloud API» → «Интеграции» |
| К ключу не подключена ни одна точка | В интеграции iikoWeb → «Подключённые точки» → «Добавить точку» |
| Нет доступа к кассам | Не стоит галочка «Разрешить доступ к терминальным группам» (см. «Что понадобится») |
| Касса не на связи | iikoFront выключен или нет интернета — новые заказы доедут, когда касса выйдет в сеть |
| Версия iiko не отдаёт заказы с кассы | Нужна версия 7.7.1 или новее — обновление через дилера |
| Часовой пояс кассы и точки разный | Поправьте пояс точки в «Точках» или часы кассового компьютера |
| Облако не видит столов, меню не загружено | Справочники ещё не выгрузились с вашего сервера: iikoWeb → организация → «Обмен данных» |
| За 3 дня не пришло ни одного заказа | Нажмите «Синхронизировать чеки»; если заведение работало, а чеков нет — напишите нам |
| Официанты почти не добавляют гостя в заказ | Без гостя в заказе не считаются визиты и бонусы — см. «Как гостя узнают на кассе» |
| Не подключена программа гостей iikoCard | Без неё мы не найдём гостя в iiko по телефону — подключается через дилера iiko |
| Мгновенные события не включены | Ключ уже отдаёт события другой программе — мы их не трогаем. Создайте для axle·app отдельный ключ |
Раз в сутки проверка идёт сама; если есть ⚠️ — придёт уведомление в колокольчик.
Шаг 4. Загрузите данные
На странице подключения кнопки:
- Загрузить меню — группы и позиции с ценой и себестоимостью → «Прайс»;
- Синхронизировать чеки — заказы столов и доставки за выбранный период (до 90 дней) → аналитика, смены, карточки гостей;
- Залы и столы — схема залов из iiko → «Брони».
Дальше всё обновляется само. При привязке мы включаем для вашего ключа мгновенные события iiko: закрытый заказ приходит сразу, а гость, которого официант добавил в заказ, получает сценарий «Гость за столом». Раз в час мы всё равно перечитываем заказы — на случай, если событие не дошло. Гости собираются из чеков автоматически: как только в заказе указан гость, он появляется в «Подписчиках».
Если ключ уже отдаёт события другой программе ресторана, мы их не трогаем: у ключа адрес событий один, и мы сломали бы ту программу. Тогда данные приходят раз в час, а «Проверка подключения» подскажет создать для axle·app отдельный ключ.
Гости в кассу
Облако iiko не отдаёт гостей списком, поэтому подписчиков бота и гостей iiko связываем по телефону. Блок Гости в кассу показывает три числа: гостей с телефоном, сколько из них связано с iiko и сколько нет.
Связать по телефону ищет подписчиков среди гостей iiko по номеру. Найденный связывается: его чеки, визиты и официант начинают находиться. В iiko при этом ничего не меняется. Кнопка проходит всю базу сама — не закрывайте страницу, пока идёт.
Искать гостей iiko умеет, только если у заведения подключена программа гостей iikoCard. Подключена ли она, видно в «Проверке подключения»; подключается iikoCard через вашего дилера iiko.
Как гостя узнают на кассе
Гостя в iiko ищут по телефону — он же закодирован в QR гостевого приложения и в штрихкоде карты Wallet. Официант добавляет гостя в заказ штатным поиском iiko, и следующий синк принесёт чек прямо на его карточку у нас. В карточке гостя кнопка Обновить из кассы перечитывает его профиль из iiko сразу.
Кто обслуживает стол
Чтобы вызов официанта из приложения уходил тому, кто открыл заказ, а не всей смене: Пользователи → сотрудник → раздел «Касса» → выберите его в списке «Сотрудник в кассе». В списке — официанты, открывавшие заказы в iiko за 90 дней.
Если что-то сломалось
Откройте страницу iiko в Интеграциях — под статусом написана причина словами. Та же причина с шагами приходит в колокольчик. Чаще всего помогает Проверить соединение после пересоздания ключа в iikoWeb.