Интеграция с iiko

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

Для чего

Если ваша точка работает на iiko, вам не нужно переносить заказы вручную. Клиент оформил заказ в WhatsApp или на сайте — он автоматически уходит в iiko на приготовление.

Что можно делать

• Передавать заказы на кухню. Заказ из платформы создаётся в iiko как доставка или самовывоз.
• Синхронизировать меню. Блюда и цены из iiko используются в каталоге.
• Отслеживать судьбу заказа. Платформа проверяет, принял ли iiko заказ, и сообщает, если что-то пошло не так.
• Принимать предзаказы. Заказ на время, когда точка ещё закрыта, ставится в очередь с нужным временем.

Как это работает

Создание заказа в iiko — асинхронное. Платформа не просто «отправляет и забывает», а доводит дело до конца:

Заказ оформлен в платформе
        ↓
Отправка в iiko → заказ принят в обработку
        ↓
Платформа проверяет результат (принято / отклонено)
        ↓
✅ Принято → готовится на кухне
❌ Отклонено → вы сразу узнаёте (и клиент видит «заминку»)

Это важно: iiko может отклонить заказ (например, точка закрыта или блюдо недоступно). Платформа отслеживает такие случаи и не даёт заказу «потеряться» — уведомляет точку и показывает клиенту статус.

Предзаказы вне часов работы

Если клиент оформляет заказ, когда точка закрыта по расписанию, платформа не отклоняет его, а оформляет предзаказ: iiko примет его к нужному времени (к открытию + время на приготовление). Клиент видит понятное сообщение: «Сейчас закрыто — примем предзаказ, откроемся в 10:00».

Обновили меню или добавки в iiko, а на сайте по-старому?

Самая частая причина — и она не в платформе. Разберём на пальцах.

В iiko на самом деле два меню:

1. Внутреннее меню (номенклатура в справочнике iiko) — то, с чем работают кухня и касса. Здесь вы заводите блюда, добавки (модификаторы), цены.
2. Внешнее меню (в iikoWeb, раздел «Внешние меню») — специальная «витрина», которую iiko отдаёт наружу: сайту, приложению, агрегаторам доставки.

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

Хитрость в том, что изменения из справочника не попадают во внешнее меню сами по себе. Вы поменяли добавки у блюда, в iiko всё выглядит обновлённым — но внешнее меню («витрина») осталось старым, пока его не сохранили заново. И тогда старую версию видит не только наш сайт, а вообще все, кто получает меню от iiko.

Что сделать (2 минуты)

1. Зайдите в iikoWeb → раздел «Внешние меню» → откройте ваше меню (например, «Меню Сайта»).
2. Найдите блюдо и проверьте: новые добавки видны именно здесь? Если нет — обновите состав блюда в этом меню.
3. Нажмите Сохранить / Опубликовать.
4. Подождите до 15 минут — платформа подтянет изменения автоматически. Хотите быстрее — откройте в проекте карточку интеграции iiko и нажмите «Синхронизировать меню».

Как понять, где именно застряло

Откройте внешнее меню в iikoWeb и посмотрите на блюдо глазами. Если новых добавок нет во внешнем меню — их не получит ни один сайт, дело в публикации на стороне iiko (шаги выше). Если во внешнем меню всё правильно, а на сайте через 15 минут по-прежнему старое — напишите нам в поддержку, посмотрим со своей стороны.

Как подключить

1. В кабинете iiko (iikoWeb / у вашего интегратора) получите доступ к iiko Cloud API и нужные права.
2. В проекте откройте Интеграции → карточку iiko и введите доступы.
3. Синхронизируйте меню и проверьте, что блюда появились в каталоге.
4. Оформите тестовый заказ и убедитесь, что он дошёл до iiko.

Права доступа настраиваются на стороне iiko

Что именно может интеграция (создавать заказы, читать статусы, подтверждать), зависит от прав, выданных вашему API-ключу в iiko. Если создание заказов работает, а управление статусами — нет, нужно расширить права ключа на стороне iiko (в кабинете, где он выдан, или через вашего интегратора). Платформа этими правами управлять не может.

Заметка

Запуск «в производство» (готовку) управляется кухней в iikoFront/KDS, а не через API. Платформа передаёт заказ и отслеживает его приём; дальнейшее приготовление — на стороне iiko.