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.
| Ошибка | Что сделать в iiko | |----|----| | Payment item can not be externally processed due to payment type settings:
<тип оплаты> | В настройках типа оплаты запрещён приём извне. Сообщить клиенту или дилеру. | | Apilogin has been blocked
| API-логин заблокирован или недоступен, возможно, ключ сменили. К дилеру; после разблокировки интеграция заработает
сама. | | Apilogin's license for using the Cloud API has expired | Истекла лицензия iiko. К дилеру. | | Exception of
type 'iikoTransport.Common.Contracts.ApiException' was thrown | Внешнее меню с этим id недоступно или удалено. Выбрать в
iiko новое внешнее меню, к дилеру. | | Product ... is inactive | Блюдо удалено в iiko. | | Product "..." is excluded
from menu for order's table ... | Блюдо исключено из продажи в iiko. Если клиент не справится сам — к дилеру. | | Order
item modifier "..." has invalid group amount: min = 0, max = 1, actual = 2 | В iiko изменили ограничения модификаторов,
а импорт меню после этого не сделали. | | Product "..." is bound to the template "...", so it should be added using
AddOrderCompoundItem method | У блюда в iiko сетка модификаторов (шаблон). Модификаторы нужно завести как групповые. | |
comment length is 653, but it cannot be greater than 500 | iiko принимает комментарий к заказу не длиннее 500 символов.
| | Cannot find fixed group modifiers '...' in order item '...' | Модификатор обновили в iiko, но не в Смартомато. Нужен
повторный импорт меню. | | undefined method 'reject' for nil:NilClass ... import_all_v2 | Меню в iikoWeb пустое или не
отдаётся. Проверить выгрузку запросом к API. |
- Добавили фото и описание, а в Смартомато ничего не пришло. Данные доходят до 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)
- Конструктор акций
- Подарки в акциях
- Приборы, комментарий и опции доставки
- Итоги заказа и сервисный сбор
- Консолидация источников заказа
- Фискальные параметры чека
- Журнал интеграций
- Мультибренд
- Остановка приёма заказов
- Режим высокого спроса