Подключение iiko (ресторан, кафе, бар)
Связать iiko с кабинетом одним ключом: чеки с себестоимостью, меню, залы и гости из заказов.
Что даёт интеграция
- чеки iiko попадают в кабинет с позициями, оплатами и **себестоимостью каждой строки** — маржа в аналитике считается сама, без ручного ввода;
- гости из заказов (у кого в кассе указан телефон) появляются в «Подписчиках», и чеки ложатся на их карточки — база кассы и подписчики бота становятся одной базой;
- меню с ценами и себестоимостью подтягивается в «Прайс»;
- залы и столы из iiko появляются в «Бронях» — бронь садится на реальный стол;
- гость получает карту Wallet, бота и гостевое приложение — со стороны заведения дорабатывать ничего не нужно.
Обмен идёт в одну сторону: мы читаем iiko и ничего в кассе не меняем.
Что понадобится
Один ключ — apiLogin облачного API iiko:
- касса на облачном тарифе iiko (Pro или Enterprise): ключ создаётся в бэк-офисе iikoWeb → Интеграции → API-ключи — «Создать ключ», скопируйте строку;
- локальная касса (лицензия или сервер у дилера): ключ вместе с модулем «Cloud API» выдаёт ваш дилер iiko — попросите «apiLogin для внешней интеграции». Модуль платный (обычно несколько сотен рублей в месяц), это оплата в адрес iiko/дилера, не наша.
Адрес сервера и часовой пояс не нужны: облако одно на всех, а время заказов касса отдаёт уже во времени вашей точки.
Шаг 1. Подключите ключ
Кабинет → Интеграции → карточка iiko → Подключить. Вставьте apiLogin → Проверить и сохранить.
Если ключ верный, появится список организаций iiko, доступных этому ключу.
Ошибки под формой говорят сами за себя:
- «iiko не принял apiLogin» — ключ с опечаткой или отозван: пересоздайте в iikoWeb → Интеграции → API-ключи;
- «лицензия Cloud API истекла» — модуль не оплачен: продлевается через вашего дилера или поддержку iiko.
Шаг 2. Выберите организацию
У одиночного заведения организация одна — отметьте её и нажмите Привязать организацию. У сети ключ может видеть несколько организаций — выберите ту, что соответствует этой точке.
Статус сменится на «подключён» — связь работает.
Шаг 3. Загрузите данные
На странице подключения три кнопки:
- Загрузить меню — группы и позиции с ценой и себестоимостью → «Прайс»;
- Синхронизировать чеки — заказы столов и доставки за выбранный период (до 90 дней) → аналитика, смены, карточки гостей;
- Залы и столы — схема залов из iiko → «Брони».
Дальше всё обновляется само, раз в час. Гости собираются из чеков автоматически: как только в заказе указан телефон, гость появляется в «Подписчиках».
Как гостя узнают на кассе
Гостя в iiko ищут по телефону — он же закодирован в QR гостевого приложения и в штрихкоде карты Wallet. Официант добавляет гостя в заказ штатным поиском iiko, и следующий синк принесёт чек прямо на его карточку у нас.
Если что-то сломалось
Откройте страницу iiko в Интеграциях — под статусом написана причина словами. Та же причина с шагами приходит в колокольчик. Чаще всего помогает Проверить соединение после пересоздания ключа в iikoWeb.