Как настроить доставку в iikoCloud: пошаговый гайд

Доставка в iiko — это не одна кнопка, а связка из номенклатуры, зон, типов оплаты и курьеров. Разбираем по шагам, что настроить внутри системы, что подключается через API iikoCloud и где на этом можно потерять заказы и деньги.

Если вы уже работаете на iiko и решили запустить или навести порядок в доставке, у вас есть два слоя настройки. Первый — то, что вы делаете руками в бэк-офисе iikoOffice и в облаке. Второй — то, что подключается через API iikoCloud (iikoTransport), когда заказы прилетают с сайта, из приложения или от ИИ-администратора. Ниже — честный разбор обоих слоёв без воды, с чек-листом и типичными граблями.

Что нужно на старте: минимальный набор

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

• Организация и терминальная группа. В iikoCloud каждое юрлицо — это organization, а каждая точка с кассой — terminal group. Именно на терминальную группу «приземляется» заказ на доставку.
• Актуальная номенклатура (меню). Блюда, цены, размеры, модификаторы, стоп-листы. Всё, что клиент увидит и закажет.
• Типы оплаты. Наличные, карта курьеру, онлайн-оплата. Каждый тип должен быть заведён и разрешён для доставки.
• Типы заказов. Как минимум «Доставка курьером» и «Самовывоз» — это разные order types, и их коды нужны при интеграции.
• Зоны доставки и прайс. Районы, стоимость доставки, минимальная сумма заказа, бесплатная доставка от N рублей.

Пошаговая настройка доставки в iiko

Шаг 1. Включите модуль доставки

Доставка в iiko работает как отдельный функционал. В iikoOffice проверьте, что у вашей лицензии активен модуль доставки (iikoDelivery / iikoCloud), и что у сотрудников есть права на работу с доставочными заказами. Без прав кассир просто не увидит вкладку «Доставка» на фронте.

Шаг 2. Наведите порядок в номенклатуре

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

Шаг 3. Настройте адреса и справочник улиц

Ахиллесова пята любой доставки. iiko хранит адрес заказа структурно: город, улица, дом, квартира. Улица должна существовать в справочнике улиц (streets) вашего региона, иначе адрес не привяжется и заказ уедет на самовывоз или вовсе не создастся. При интеграции по API адрес передаётся объектом, а не строкой, — поля важно заполнять корректно, иначе курьер получит «дом без улицы».

Шаг 4. Задайте зоны и стоимость доставки

Здесь вы описываете правила: какие районы обслуживаете, сколько стоит доставка в каждый, какая минимальная сумма заказа и с какой суммы доставка бесплатная. Разумная практика — 2–4 зоны с разной ценой вместо единого тарифа: так вы не возите за 150 рублей блюдо на другой конец города в убыток.

Частая ошибка: единый тариф доставки на весь город. В итоге ближние заказы вы «переоцениваете» и теряете клиентов, а дальние возите в минус. Зоны с шагом цены окупают полчаса настройки за первую же неделю.

Шаг 5. Заведите курьеров и статусы

Курьеры в iiko — это сотрудники с ролью «Курьер». Настройте цепочку статусов заказа: Новый → Готовится → Готов → В пути → Доставлен. Эти статусы потом можно отдавать клиенту (по SMS или в мессенджер) и использовать как триггер — например, после статуса «Доставлен» автоматически спросить гостя об отзыве.

Подключение iikoCloud через API: что реально происходит

Когда заказы приходят не с кассы, а извне — с вашего сайта, из приложения, из чата или голосом — работает iikoTransport API (домен api-ru.iiko.services). Скажу честно, чтобы вы понимали границу «руками / через API»:

Логика API-интеграции такая: сервис авторизуется по apiLogin и получает токен (живёт около часа), затем запрашивает список организаций и терминальных групп, тянет меню, а при заказе вызывает метод создания доставки (deliveries/create) с составом, адресом, типом оплаты и типом заказа. Ключевой нюанс — apiLogin берётся в личном кабинете iiko и относится к iikoTransport; его часто путают с ключом модуля лояльности, это разные ключи для разных задач.

Три вещи, на которых спотыкаются чаще всего

• Обязательные модификаторы. Если у блюда есть обязательная группа модификаторов, а внешний заказ её не передал — iiko отклонит заказ. Меню на сайте и в iiko должны совпадать один в один.
• Адрес объектом, а не строкой. Улица должна матчиться со справочником. Поэтому серьёзные интеграции подключают геокодер (например, DaData), чтобы превратить «ул. Ленина 5» в структурный адрес с корректным ID улицы.
• Токен и терминал. Заказ уходит на конкретную terminal group. Если точка офлайн или указана не та группа — заказ «повиснет». Всегда проверяйте, что нужный терминал онлайн.

Кто принимает заказ, пока вы заняты кухней

Даже идеально настроенная доставка в iiko упирается в человека, который отвечает клиенту. Вечер пятницы, поток заявок в WhatsApp и Telegram, а администратор один — и часть гостей просто не дожидается ответа. По отраслевым оценкам, до 30% обращений в общепите остаются без ответа в часы пик, и это прямые потерянные заказы.

Здесь как раз закрывает боль ИИ-администратор. Людочка подключается к вашей iiko как раз через iikoTransport: принимает заказ в чате или голосом, подтягивает актуальное меню и стоп-листы, уточняет адрес и сам оформляет доставку прямо в iiko — без ручного переноса «из переписки в кассу». То, что вы настроили выше (зоны, типы оплаты, модификаторы), она использует автоматически. А после статуса «Доставлен» может сама спросить гостя об отзыве и вернуть его за повторным заказом.

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

Чек-лист перед запуском

1. Модуль доставки активен, у сотрудников есть права.
2. Меню с ценами для доставки, модификаторами и стоп-листами выверено.
3. Справочник улиц заполнен, адреса привязываются.
4. Зоны и тарифы доставки заданы, есть минимальная сумма заказа.
5. Типы оплаты (наличные, карта, онлайн) заведены и разрешены для доставки.
6. Типы заказов «Доставка» и «Самовывоз» созданы, коды известны.
7. Курьеры добавлены, цепочка статусов настроена.
8. Для внешних каналов: получен apiLogin iikoTransport, проверено создание тестового заказа.

Пройдите этот список сверху вниз — и первый реальный заказ на доставку не превратится в разбор «почему касса его не видит». А дальше решайте, кто будет отвечать гостям в пиковые часы: ещё один администратор в штат или ИИ, который работает 24/7 и не уходит на обед.