iiko

iiko — система ресторанного учёта. Смартомато работает с ней через iikoTransport (API iikoCloud): заказы с сайта, из приложения и от операторов уходят на кассовый терминал iikoFront, а меню, стоп-листы, курьеры и столы приходят из iiko. Настройку на стороне iiko обычно делает дилер iiko клиента. По статье Syrve — иностранная ветка iiko с такими же настройками, её тоже подключают.

Что нужно до подключения

• Версия iiko совместима с iikoCloud API (iikoTransport) и не ниже 8.3.7.
• Лицензии:
  • iikoAPI Cloud для интеграции с сайтами;
  • iikoDelivery для работы кассы на доставку.
  • На тарифах iikoCloud Pro и iikoCloud Enterprise обе лицензии уже включены, отдельно их покупать не нужно.
  • На LifeTime iikoCloud API покупают отдельно на весь чейн, а iikoDelivery — на каждый iikoFront, который будет принимать заказы. Стоимость — на сайте iiko, в прайс-листе лицензия называется iikoDelivery.
  • Наличие лицензии проверяют в iiko BackOffice: «Администрирование» → «Установить лицензию».
• Если iikoDelivery купить нельзя (LifeTime, см. «Пробелы»), все заказы можно отправлять в iiko как заказы «за стол». Для этого в iiko нужен модуль TableService и отдельные столы под доставку и под самовывоз. Если модуля нет и докупить его нельзя, остаётся только переход на облачное решение iiko.
• Меню ведут по правилам (подробнее — «Меню» ниже). Если меню делается для агрегаторов, в том числе Яндекс.Еды, размеры блюд заводят модификаторами (Яндекс.Еда с размерами не работает).
• Плагин iiko для iikoFront доступен на тарифе Смартомато «Бизнес» и выше.

Шаги на стороне iiko

Общая инструкция по iikoTransport есть в базе знаний iiko. Ниже порядок из чек-листа Смартомато.

iikoTransport и API-ключ

1. Подключить iikoTransport и модуль iikoDelivery, если их ещё нет. С этим помогает дилер iiko.
2. Сгенерировать API-ключ (api login) в личном кабинете iikoWeb, в настройках iikoTransport. Посмотреть ключ в iikoOffice можно так: «Обмен данными» → «Настройка iikoTransport» → «Настройки Cloud API» → нажать на название ключа.
3. Подключить к ключу все точки, на которые будут приниматься заказы. Все они должны быть доступны под одним API-ключом и отдаваться запросом api-ru.iiko.services/api/1/organizations. Зачем: по этому ключу Смартомато видит организации и терминалы iiko и связывает их со своими ресторанами, см. Подключение к кассе.
4. Веб-хуки в iikoTransport не настраивать: Смартомато пропишет их сам, когда получит ключ.
5. Источник заказа можно оставить пустым. Если нужно, чтобы сервису не были доступны заказы, созданные в обход него, указать источник заказа Smartomato.

Типы оплат

Общая информация — в базе знаний iiko.

• Нужны типы оплат для наличных, для банковских карт и для оплаты на сайте. Названия любые; если такие типы уже есть, их достаточно выгрузить в API.
• Каждый тип доступен извне. Тип для оплаты на сайте допускает проведение оплаты извне.
• У каждого типа задан алфавитно-цифровой код в верхнем регистре, например CASH, BANK, SITE.
• Порядок в iikoOffice: «Розничные продажи» → «Типы оплат» → «Добавить».
  • Оплата на сайте:
    • тип «Банковские карты», в чеке — «Оплата на сайте»;
    • включены «Можно комбинировать с другими типами оплаты», «Применять для всех категорий блюд», «Открывать денежный ящик» и «Может приниматься извне»;
    • «Проведение оплаты» — как внешний, так и на стороне ресторана;
    • код, например SITE;
    • платёжная система — внешняя.
  • Картой курьеру — те же настройки, код, например CUR, и отмечено «Является фискальным».
  • Картой на внешнем сервисе (по одному типу на агрегатор: Яндекс, Delivery, Сбермаркет и т. д.) — те же настройки, код, например YA, DC, SBERM.
  • «Является фискальным» у оплаты на сайте и у оплаты на внешнем сервисе отмечают, только если у заведения нет онлайн-кассы. С онлайн-кассой чек пробивается на стороне ресторана. При интеграции с Яндекс.Чеком тип оплаты создают нефискальным.
• Зачем: Смартомато передаёт в заказе тип оплаты, и касса должна принять его извне, см. Фискальные параметры чека.

Типы заказов

• В интеграции используются типы «Доставка курьером», «Самовывоз» и «Заказ за стол». Обычно в iiko они есть по умолчанию и сразу доступны в API.
• Если типов для доставки курьером и самовывоза нет, их создают самостоятельно. Подробнее — в базе знаний iiko.

Меню

Меню для Смартомато ведут во внешнем меню iikoWeb: с 01.11.2026 iiko не отдаёт номенклатуру iikoOffice, и меню из iiko можно загрузить только из внешнего меню, см. Синхронизация меню, цен и стоп-листов с кассой. Смартомато импортирует его из API. Инструкции iiko: выгрузка меню, внешнее меню iikoWeb.

• Требования к меню:
  • позиции заведены как «Блюдо» (type: "Dish"), а не как товар (Good);
  • модификаторы — групповые (modifierGroups), см. справку iiko;
  • размеры блюд (обычно пиццы) заведены модификаторами с мин/макс 1/1, а не размерами (itemSizes);
  • вложенность папок не рекурсивная;
  • внешнее меню выглядит так, как его должен увидеть гость: без технических модификаторов («с собой», «здесь», «жарить»), с понятными названиями вместо складских вроде «П/Ф Блины греч.с черн.икр.30г», без лишних папок.
• iikoOffice — устарело. С 01.11.2026 iiko не отдаёт номенклатуру iikoOffice, и импорт меню из неё в Смартомато завершается ошибкой; ниже — как это было устроено. Меню выгружали в iikoCloud на каждом RMS: «Обмен данными» → «Выгрузка меню» → добавить категории или блюда → «Сохранить». Фото и описание можно поправить прямо в выгрузке, двойным кликом по блюду. Порядок категорий и блюд в выгрузке меняют стрелками, и этот порядок приходит в Смартомато.
• iikoChain. Если на всех точках доставки меню одинаковое, рекомендуется включить репликацию внешнего меню из iikoChain.
• iikoWeb. «Внешнее меню» → выбрать меню → «Список блюд» → добавить категорию или блюдо в категорию. Порядок меняют перетаскиванием.
• Когда изменения доходят до Смартомато. Обновление выгрузки приходит в API в течение 30 минут, после этого в Смартомато можно запускать импорт. Фото и описания в крупных меню доходят до API за время до часа.
• Доступность блюда на точке задаётся ценами по организациям. Если на точке блюдо продаваться не должно, при работе через приказы цена в приказе остаётся пустой (null). Если блюдо просто исключают из меню конкретного RMS, об этом нужно сказать Смартомато. Зачем: по цене в каждой организации Смартомато решает, продаётся ли блюдо на точке, см. Цены и наличие блюд по точкам.
• Групповой модификатор:
  • в номенклатуре создают папку (например, «Начинка»);
  • в ней заводят позиции с типом номенклатуры «Модификатор», с ценой и прайс-листом;
  • в карточке блюда нажимают «Добавить» → «Добавить групповой модификатор».
  • Тип модификатора задают ограничениями группы:
    • обязательный выбор одного (Select) — «Мин» и «Макс» равны 1;
    • степпер (Stepper) — «Макс» равно N; жёсткий лимит на каждый модификатор ставят галочкой «Ограничение на минимум и максимум у дочерних модификаторов»;
    • чекбокс — выбор одного или нескольких.
• Технический модификатор, например упаковка, которая должна уходить с блюдом всегда, но гостю не показываться:
  • обязательная группа (мин/макс 1) с опознавательным префиксом в названии, пример из статьи — ~~~фальг.упаковка;
  • внутри группы — один модификатор;
  • если технических модификаторов несколько, заводят несколько групп;
  • одну и ту же группу нельзя привязать к одному блюду как 1/1, а к другому как 0/1.
  • Префикс согласуют со Смартомато. Зачем: см. Конфигуратор модификаторов.
• Весовое блюдо заводят с ценой за 1 кг при любом шаге. Минимальный вес и шаг задаются уже в Смартомато, а iiko считает цену по переданному весу, см. Весовые блюда.
• Служебные позиции со свободной ценой. Их заводят как «Блюдо» с галочкой «Свободная цена» и добавляют во внешнее меню iikoWeb, а в Смартомато они скрыты от гостя. Шаги — ниже, в «Блюдо „Доставка" со свободной ценой».
  • «Доставка» — Зачем: без неё стоимость доставки в iiko не передаётся, она приезжает этим блюдом в составе заказа.
  • «Сервисный сбор» — по той же схеме, см. Итоги заказа и сервисный сбор.
  • Позиция приборов — если приборы нужны отдельными строками в чеке, см. Приборы, комментарий и опции доставки.

Акции и бонусы

• Каждую акцию Смартомато заводят в BackOffice как скидку с такими же условиями: «Дисконтная система» → «Скидки и надбавки» → «Добавить» → название и «Название в пречеке» → параметры скидки → активировать. Скидка должна отдаваться запросом api-ru.iiko.services/api/1/discounts (документация iiko). Это зона ответственности дилера iiko. Зачем: акции связываются по id скидки iiko и попадают в отчёты iiko, см. Конструктор акций.
• Скидка для бонусов Смартомато. Тип — скидка, фиксированная сумма, с галочкой «Назначить сумму». Статья советует назвать её «Бонусы». Зачем: списанные бонусы Смартомато приезжают в iiko этой скидкой.
• Подарочное блюдо настраивают одним из двух способов, см. Подарки в акциях:
  • завести в iiko отдельное блюдо по нулевой цене (например, «Пицца в подарок») и выгрузить его. Минус: отчёты iiko по продажам и скидкам будут некорректными;
  • передавать блюдо по полной цене вместе со скидкой на его сумму.
• Статья рекомендует держать акционные блюда в отдельной категории, например «Акции», которую в меню Смартомато скрывают.

Прочее в iiko

• SMS и Push-уведомления iiko отключить: «Доставка» → «Sms и Push уведомления» → снять галочки со всех событий. Зачем: гость и так получает эту информацию на сайте и в приложении.
• Подготовить КЛАДР: добавить город в разделе «Города», затем правой кнопкой по городу → «Обновить улицы из КЛАДР».
• Адрес ресторана должен быть заведён в КЛАДР так же, как его укажут в Смартомато. Точный вариант уточняют у дилера.
• Адрес доставки одной строкой ("Россия, г Ижевск, ул Песочная, д 16") включают в iiko в «Настройках корпорации». Работает с версии 8.9.7.
• Маркетинговые источники заводят в iiko, если заказы должны приходить с ними; Смартомато привязывает их к своим источникам заказа, см. Консолидация источников заказа.
• Несколько ценовых категорий под разные точки — Смартомато нужно сообщить, из какой брать цены.
• Автоперевод заказа из «Ждёт готовки» в «Пора готовить» по времени доставки работает с iiko 8.8.6+.

Курьеры

• Требования к курьерам в iiko:
  • у курьера есть право быть курьером;
  • у курьера есть код. Зачем: из кода собираются логин и пароль курьера в Смартомато, и по нему заказ, назначенный в iiko, находит курьера в Смартомато;
  • у курьера заполнено нормальное имя (как правильно и неправильно — примеры скриншотами в статье «Кейсы при настройке»);
  • курьеры отдаются запросом POST https://api-ru.iiko.services/api/1/employees/couriers;
  • если импортируются не все курьеры, при выгрузке смена должна быть открыта.
• Зачем: Смартомато импортирует курьеров с привязкой к ресторанам и создаёт им доступы в приложение, см. Курьеры и смены. По статье собственное курьерское приложение iiko (iikoDeliveryMan) клиенты оценивают плохо.
• Назначение в iikoFront: карточка заказа → блок «Курьер» → выбрать курьера. Назначение приходит в Смартомато и курьеру в Order Machine: курьер с кодом «3» в iiko — это курьер с тем же кодом в Смартомато, ему придёт оповещение о заказе.

Столы (заказ в зале)

• Завести в iiko залы со столами. Дальше Смартомато импортирует их, и заказ, оформленный на стол, уходит на этот стол в iiko, см. Заказ в зале и QR-меню.
• Комментарий к заказу на стол iiko не принимает. Если комментарий нужен, заказы «за стол» можно передавать как самовывоз: номер стола и комментарий окажутся в комментарии заказа.

Остатки

• Из iikoFront. Количественный остаток задают в стоп-листе на кассе; он приходит в Смартомато вместе со стоп-листом. При остатке 0 блюдо встаёт на стоп.
• Из iikoServer. Сервер iiko должен быть доступен для подключений извне. Для интеграции можно завести отдельную учётную запись администратора, дополнительных настроек она не требует.
• Синхронизация остатков — на тарифе Смартомато «Про +» и выше, см. Учёт остатков блюд.

Несколько точек и чейны

Для сети, где у всех точек одно меню, лучше всего подходит iikoChain с общим меню: на всех точках одинаковые блюда с одинаковыми id.

• Небольшие различия в меню между точками решают приказами внутри чейна.
• Часть ресторанов в чейне, часть нет, или точки не связаны ни чейном, ни RMS:
  • самый простой и дешёвый вариант — объединить всё в чейн;
  • иначе дилер копирует меню в другой RMS с теми же id категорий, блюд и модификаторов. Копирование идёт через серверный участок iikoOffice в виде таблиц. Файл обязательно сохраняют в UTF-8, а Windows по умолчанию сохраняет в ANSI. Документация (1.pdf, 2.pdf) приложена к исходной статье «Эдж кейсы»;
  • при копировании новые позиции заводят только в первом RMS и каждый раз просят дилера перенести их во второй.
• Терминалы в разных iikoChain в одной организации Смартомато допустимы, если у всех блюд во всех чейнах одинаковые id.
• Несколько концепций в одной iiko (категория или папка на концепцию): либо мультибренд — отдельная организация Смартомато на папку, либо дилер переделывает меню под чейн. См. Мультибренд.
• Несколько iikoOffice в одном бренде без чейна: у каждой точки свой API-ключ и своя родительская папка меню в своём офисе.

Блюдо «Доставка» со свободной ценой

Блюдо заводят в номенклатуре iikoOffice и добавляют во внешнее меню iikoWeb.

1. В iikoOffice откройте «Товары и склады» → «Номенклатура» и нажмите «Добавить».

2. Заполните карточку: название — «Доставка», тип номенклатуры — «Блюдо», родительская группа — папка, где будет лежать блюдо, тип места приготовления. Отметьте «Свободная цена» и нажмите «Сохранить и закрыть».

3. В iikoWeb откройте «Внешние меню» и выберите меню, из которого Смартомато загружает меню.

4. На вкладке «Список блюд» выберите папку и нажмите «Добавить блюдо в категорию».

5. Выберите блюдо «Доставка» и нажмите «Добавить» — оно появится в списке блюд внешнего меню.

6. Загрузите меню в Смартомато, см. Синхронизация меню, цен и стоп-листов с кассой.

Плагин iiko для iikoFront

Плагин открывает в iikoFront окно с board ресторана в Смартомато: из кассы можно выключать и включать ресторан и режим повышенного спроса. Ставят его на все терминалы, где это нужно.

1. Скачать плагин (проект).
2. Распаковать в папку Plugins фронта: C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\.
3. В папке плагина ...\Plugins\Get.Plugins.Smartomato заполнить конфигурационный файл BeOpen.Front.PapaGrillOnWeb.dll.config:
   • URL — ссылка на board ресторана, её выдаёт Смартомато (формат https://smartomato.ru/board2/restaurants/{id_ресторана}?auth_token={auth_токен});
   • Width, Height — размер окна, по умолчанию 1200 × 760.
4. Первый запуск может упасть с ошибкой прав на папку временных файлов. Нужно дать группе «Все» полные права на C:\Program Files\iiko\iikoRMS\Front.Net\Resto.Front.Api.Host.exe.WebView2 и перезапустить iikoFront.
5. Лог плагина: C:\Users\User\AppData\Roaming\iiko\CashServer\Logs\plugin-Get.Plugins.Smartomato.log.

Зачем это нужно, см. Остановка приёма заказов и Режим высокого спроса.

Работа с заказами в iikoFront

• Где искать заказы. Заказы Смартомато приходят в разделы «Доставка» или «Заказы», вручную или автоматически — по настройке отправки. Нужный заказ находят по полю «Комментарий», в нём номер заказа в Смартомато.
• Что видно в заказе доставки:
  • состав и стоимость;
  • номер заказа в Смартомато;
  • имя и телефон гостя;
  • адрес и примечание к нему;
  • комментарий: номер заказа, адрес, количество приборов, комментарий гостя.
  • Применённые скидки открываются кнопкой «Заказ» в левом нижнем углу.
• Статусы.
  • Статусы, выставленные в iiko (например, «Готовить», «Приготовлен»), приходят в Смартомато.
  • Если это включено, статусы курьера «У курьера» и «Доставлен» из Order Machine отображаются в iikoFront.
  • После доставки или выдачи заказ закрывают на кассе. Для самовывоза — «Оплатить».
• Заказ к столу: «Заказы» → стол → «Печать» (состав), «Пречек», «Касса» → «Оплатить». После оплаты заказ в Смартомато переходит в «Доставлен».

Что передать в Смартомато

Передают в техподдержку Смартомато в чате или на support@smartomato.ru.

• API-ключ iikoTransport. Если у точек разные бэкофисы или чейны — ключ для каждой точки.
• Какой терминал iiko обслуживает каждую точку.
• Адрес каждого ресторана в том виде, в каком он заведён в КЛАДР.
• Если нужна синхронизация остатков с iikoServer — хост или домен сервера (доступный извне), порт, логин и пароль администратора.
• В сценарии «все заказы за стол» — какие столы в iiko отведены под доставку и под самовывоз.
• Перед началом настройки должно быть готово:
  • настроено внешнее меню;
  • выгружены организации, терминалы и типы оплат.
• Для плагина Смартомато, наоборот, выдаёт ссылку с токеном ресторана.
• Для импорта курьеров:
  • паттерн для логинов курьеров — лучше с маленькой буквы, например название организации латиницей;
  • нужно ли, чтобы назначение курьера в Смартомато передавалось в iiko и чтобы статусы доставки «у курьера» и «доставлен» уходили в iiko.

Куда обращаться

• Лицензии и настройки iiko — к дилеру iiko клиента.
• Дилер «Лемма»:
  • в обращении дописывают ИНН клиента в формате Инн: цифры, обязательно с двоеточием. По ИНН бот находит ответственную команду;
  • фото отправляют отдельным сообщением;
  • о том, что заявка создана, сообщает бот;
  • если бот не ответил, обращение создают через второго бота, @LemmaTask_bot, и пишут, что клиент не определился автоматически. Инструкция к нему (PDF) приложена к исходной статье.
• Остальным дилерам пишут в свободной форме.
• Справка iiko: ru.iiko.help, документация API.

Типовые ошибки и вопросы клиентов

Текст ошибки виден в логе заказа в Смартомато, обычно в блоке «Error description». Ниже — ошибки, которые чинятся на стороне iiko.

• Добавили фото и описание, а в Смартомато ничего не пришло. Данные доходят до API iiko не сразу, в крупных меню — до часа.
• Блюдо не в стопе, но недоступно для заказа. Проверить цены блюда по организациям в iiko: пустая или нулевая цена в организации означает, что на этой точке блюда нет.
• Стоп-листы iiko присылает сама, Смартомато их не запрашивает.
• Какие данные приходят из iiko при импорте меню:
  • порядок категорий и блюд, названия и описания блюд;
  • КБЖУ, вес, цена;
  • групповые модификаторы и их цены по ресторанам;
  • фото блюд и категорий;
  • признак акциза.
• Что Смартомато передаёт в iiko:
  • номер заказа, телефон и имя гостя;
  • тип доставки, координаты и адрес, комментарий к адресу;
  • комментарий к заказу, состав заказа, комментарии к блюдам и модификаторам;
  • источник заказа, тип оплаты, сумму.
  • В поле «Комментарий» уходят номер заказа, дата, время и адрес. В «Примечание» — адрес, который ввёл гость. «Прочее» не заполняется.
• Как источники заказа видны в iiko. Названия обрезаются: «Витрина (мобильная», «Внешний сайт (мобил», «Мобильное приложени», «Деливери Клаб», «Сбермаркет» и т. д.
• Можно ли связать акции напрямую с iikoCard, чтобы они попадали в отчёты? Нет: в iikoCard нельзя передать id акции или промокод.
• Можно ли одну организацию iiko привязать к нескольким организациям Смартомато? Можно. Если при этом включён импорт заказов из iiko, заказ создаётся во всех этих организациях.
• Работает ли Смартомато с Syrve? Да, настройки аналогичны iiko.
• Проверить, что iiko отдаёт по API (меню, стоп-листы, организации, бонусы), или дать дилеру запрос и ответ по заказу можно через Postman. Коллекция iikoTransport.postman_collection.json приложена к статье «Работа с Postman и коллекцией». В переменные коллекции вписывают API-ключ; если в ключе несколько организаций, подставляют id нужной.
• Какие веб-хуки iiko использует Смартомато:
  • DeliveryOrderUpdate и DeliveryOrderError — статусы и ошибки заказов доставки;
  • TableOrderUpdate и TableOrderError — то же для заказов на стол;
  • StopListUpdate — стоп-листы.
• Как курьеру войти в приложение? Логин — адрес в поле Email курьера (вида <паттерн>-<код в iiko>@smt.bz), пароль — часть логина до «@».
• Статусы доставки не уходят в iiko для самовывоза. Статусы передаются только по заказам с назначенным курьером, то есть только по доставке.

Связанные статьи

• Подключение к кассе
• Редактор настроек интеграции
• Синхронизация меню, цен и стоп-листов с кассой
• Цены и наличие блюд по точкам
• Единое меню на несколько точек
• Стоп-листы
• Учёт остатков блюд
• Конфигуратор модификаторов
• Размеры блюда
• Весовые блюда
• Статусы заказа и их смена
• Отложенный заказ и предзаказ по датам
• Заказ в зале и QR-меню
• Курьеры и смены
• Приложение курьера (Order Machine)
• Конструктор акций
• Подарки в акциях
• Приборы, комментарий и опции доставки
• Итоги заказа и сервисный сбор
• Консолидация источников заказа
• Фискальные параметры чека
• Журнал интеграций
• Мультибренд
• Остановка приёма заказов
• Режим высокого спроса