Скилл iiko в Aizor: как подключить iikoCloud API и работать с меню и заказами

Вы держите кафе. Гость звонит и спрашивает, где его доставка, а чтобы ответить, вам или администратору нужно открыть кабинет, найти заказ и посмотреть статус. Утром то же самое со стоп-листом: надо зайти и выяснить, что сегодня закончилось.

Скилл iiko подключает агента Aizor к iikoCloud API, и такие справки он даёт по вашей просьбе. Ниже разберём, как это настроить, на примере того же кафе.

Что агент умеет в iiko?

Официальное описание от команды Aizor: iikoCloud API для ресторанов и кафе. Меню, стоп-листы, создание доставок и заказов в зале прямо на кассу, отслеживание статусов и вебхуки.

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

Что нужно подготовить?

Для вашего кафе понадобится следующее:

• Рабочая система iiko и доступ к iikoWeb. Документация iiko говорит, что ключ задаётся именно там.
• Права, чтобы создать ключ API. Кто в организации может это делать, в справочнике API не описано: уточните у администратора iiko или в поддержке.
• Для новой схемы входа (v2) ещё регистрация на портале разработчика iiko: оттуда берутся appId и clientSecret.
• Приложение Aizor для macOS или Windows и скилл iiko из каталога.

Цена API в справочнике не указана, так что условия подключения уточните у менеджера iiko.

Где взять ключ API?

Ключ вы создаёте сами в iikoWeb. Схем входа в справочнике iikoCloud API две. Старый метод получения токена по apiLogin помечен как устаревший, вместо него рекомендован метод версии 2, по нему и идут шаги.

1. Откройте iikoWeb и найдите раздел «Интеграции» → «API-ключи». Название пункта в вашей версии может отличаться.
2. Создайте ключ API. Он определяет, к каким организациям получит доступ токен.
3. Для схемы v2 зарегистрируйтесь на портале разработчика iiko (public-api.iikoweb.ru/portal) и заполните данные компании.
4. Создайте там приложение. Вы получите appId и clientSecret. Секрет показывается один раз.
5. Метод получения токена принимает три значения: appId, clientSecret и ключ API. В ответ приходит токен.

Токен живёт 1 час и сам не продлевается, так что агент будет время от времени запрашивать новый. Потерянный секрет перевыпускают на портале: прежний сразу перестаёт работать. В Aizor установите скилл iiko из каталога и вставьте ключ в его настройки. Какие именно поля он просит, смотрите в самом скилле.

Как проверить, что всё работает?

Первые три запроса только читают данные, а последний готовит заказ, но не отправляет его на кассу:

• «Покажи, какие организации доступны по моему ключу» (только чтение).
• «Что сейчас в стоп-листе на кухне?»
• «Покажи доставки за сегодня со статусом "В пути"».
• «Подготовь доставку: две пиццы на улицу Ленина, 5. Покажи мне и не создавай» (заказ не попадает на кассу).

Как это выглядит в работе?

Как узнать, что сегодня в стоп-листе?

Каждое утро по расписанию агент читает стоп-лист и присылает список позиций, которые недоступны. Это только чтение, так что права на создание заказов не нужны.

Что ответить гостю, который спрашивает про доставку?

Гость звонит и спрашивает, где заказ, а вы просите агента найти доставки по номеру телефона и назвать статус. Вот статусы из справочника (переведены): «Не подтверждена», «Ждёт приготовления», «Готовится», «Приготовлена», «В ожидании», «В пути», «Доставлена», «Закрыта», «Отменена».

Можно ли создавать заказ из чата?

Можно. Менеджер пишет агенту состав заказа и адрес. Агент готовит доставку, показывает вам и создаёт её на кассе только после подтверждения. В документации создание доставки называется командой, и прошла ли она, агент проверяет отдельным запросом. Если заказы приходят через мессенджер, посмотрите настройку Telegram-бота.

Как получать уведомления о событиях?

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

Что делать, если iiko вернул ошибку?

Агент покажет код, а таблица подскажет, что с ним делать.

Что видите	Причина	Что делать
401 Unauthorized	Токен не передан, неверный или истёк (живёт 1 час).	Запросите токен заново и проверьте ключ в настройках скилла.
400 Bad Request	Запрос составлен неверно, например, не указана организация.	Уточните задачу, начните с запроса списка организаций.
408 Request Timeout	Сервер не ответил за время ожидания (по умолчанию 15 секунд).	Повторите запрос позже.
429 Too many requests	Слишком частые запросы. Цифра лимита в справочнике не указана.	Подождите и сократите частоту запросов.
410 при проверке команды	Идентификатор команды больше не поддерживается.	Не запрашивайте статус этой команды снова, проверьте заказ отдельным запросом.

Как не получить лишних заказов на кассе?

Всё, что создаёт заказ, попадает на кассу, поэтому ограничения здесь важнее, чем в справках.

• Создайте отдельный ключ API под агента. Ключ определяет доступные организации: не давайте лишних.
• В справочнике методы разбиты на группы ограничений, например «Orders: creating» и «Data: stoplists». Если можно, оставьте ключу только чтение.
• Создание доставок, заказов в зале, отмену и закрытие заказов включайте только через ручное подтверждение в Aizor. Эти действия попадают на кассу.
• Не пересылайте ключ и clientSecret в чатах. Храните их в настройках скилла.
• Если ключ утёк, перевыпустите секрет на портале и удалите ключ в iikoWeb. Точный порядок уточните в поддержке iiko.

Когда всё настроено, на вопрос гостя «где мой заказ» вы отвечаете за время, которое нужно, чтобы продиктовать номер телефона агенту.

Инструкция написана по официальной документации iikoCloud API (api-ru.iiko.services/docs), состояние на октябрь 2026 года. Интерфейс кабинета и условия могут измениться. Автор Aizorlab участвует в партнёрской программе Aizor.