iiko API: что автоматизировать и как подключить в кафе

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

Что такое iiko API и зачем он владельцу

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

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

Важно сразу разделить понятия, потому что их путают:

• iiko (iikoRMS) — сама касса и учёт на точке.
• iikoOffice — программа-бэкофис: меню, склад, сотрудники, отчёты. Именно тут вы заводите номенклатуру, которую потом видит API.
• iikoWeb / iikoCloud API (iiko Transport) — облачный API для доставки и внешних заказов.
• iikoCard / Loyalty API — программа лояльности: бонусы, скидки, история гостя.
• Biz+ / iikoBiz — старый интеграционный слой, который у части заведений ещё используется.

iiko для общепита исторически заточен под сети и доставку, поэтому API там мощный, но с нюансами доступа. Ниже — что именно он умеет.

Что реально можно автоматизировать через iiko API

Не всё, что обещают интеграторы, стоит внедрять в маленьком кафе. Вот честный список по убыванию пользы для среднего заведения с доставкой.

1. Приём заказов из внешних каналов прямо в кассу

Гость пишет в WhatsApp, Telegram, на сайте или звонит — заказ через API падает в iiko как обычный чек доставки: с адресом, составом, комментарием и способом оплаты. Кухня видит его в общей очереди, курьер получает адрес, ничего не теряется. Это закрывает главную боль: оператор больше не переписывает заказы вручную и не ошибается в модификаторах.

2. Синхронизация меню и стоп-листов

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

3. Статусы заказа и триггеры

iiko умеет присылать вебхуки по событию заказа: принят, готовится, отдан курьеру, доставлен, закрыт. На эти события вешаются автосообщения гостю («ваш заказ выехал») и запрос отзыва после статуса «Доставлен».

4. Программа лояльности

Через Loyalty API начисляются и списываются бонусы, работают персональные скидки и история покупок. Гость называет телефон — система узнаёт его и предлагает то, что он берёт обычно.

5. Отчёты и аналитика

Выручка, средний чек, топ блюд, отмены — всё выгружается по расписанию. Утренний отчёт в чат владельца вместо ручного захода в iikoOffice.

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

Таблица: что подключается и что это даёт

Как подключить iiko API: пошагово

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

1. Определите, какой у вас iiko. Облачный iikoCloud (iiko Transport) или локальный сервер. От этого зависят эндпоинты и способ авторизации. Проще всего спросить у вашего интегратора или в поддержке iiko.
2. Получите доступ к API. Для облака нужен apiLogin — его выдают в личном кабинете iiko (раздел с внешними интеграциями) или через партнёра. Для локального iiko Transport нужны логин интеграции, идентификатор организации (organizationId) и терминал.
3. Получите токен. По apiLogin запрашивается временный токен доступа (access_token), которым подписываются все дальнейшие запросы. Токен живёт ограниченное время и обновляется.
4. Заберите organizationId и terminalGroup. Это адреса ваших точек и касс внутри аккаунта. Без правильной организации заказ уйдёт «в никуда» или на чужой филиал.
5. Проверьте меню. Выгрузите номенклатуру и сверьте ID блюд и модификаторов. Самая частая ошибка интеграции — рассинхрон: на сайте одно название, в кассе другой артикул.
6. Настройте вебхуки. Укажите URL, на который iiko будет слать события заказов, и зарегистрируйте нужные типы событий (обновление доставки, смена статуса).
7. Прогоните тестовый заказ. Создайте заказ через API и убедитесь, что он виден на кассе, с верным составом, адресом и суммой, а статусы приходят обратно.

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

Частые ошибки при интеграции

• Путают organizationId и terminalGroup. Заказ уходит на другую точку сети. Всегда фиксируйте, какая организация «главная».
• Забывают про модификаторы. Соус, размер, «без лука» — это отдельные сущности. Если не передать их ID, кухня получит голое блюдо.
• Игнорируют стоп-листы. Меню кэшируют раз в сутки — и продают то, чего нет. Обновляйте наличие хотя бы раз в несколько минут.
• Не обрабатывают ошибку доставки адреса. Если зоны доставки настроены в iiko, а адрес вне зоны — заказ отклонится. Проверяйте адрес до оформления.
• Держат токен вечно. Токен протухает, интеграция молча падает ночью. Нужен автоперевыпуск.

Где ИИ-администратор снимает рутину поверх iiko

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

Такое умеет автоматизировать, например, Людочка (lyyda.ru): она принимает заказ в чате, мессенджере или по звонку, собирает его по актуальному меню из iiko, заводит чек прямо в кассу, отвечает гостям круглосуточно, после статуса «Доставлен» просит отзыв и мягко возвращает тех, кто давно не заказывал. Зоны доставки и филиалы она учитывает, а на редкие сложные вопросы эскалирует человеку.

Смысл не в том, чтобы уволить менеджера, а в том, чтобы он не сидел ночами в переписке ради трёх заказов. Касса ведёт учёт, API отдаёт данные, ИИ-администратор разговаривает с гостем и нажимает нужные кнопки за оператора.

С чего начать конкретно вам

1. Выпишите, где сотрудники руками переносят данные в iiko или из неё.
2. Уточните тип вашего iiko и запросите apiLogin.
3. Начните с одного сценария — обычно это приём заказов доставки в кассу.
4. Добавьте стоп-листы и уведомления гостю о статусе.
5. Только потом — лояльность, отчёты и допродажи.

iiko для общепита даёт достаточно, чтобы автоматизировать 80% рутины доставки. Не пытайтесь включить всё сразу — считайте по одному сценарию, где вы экономите часы работы или перестаёте терять заказы.