🧩 Все базовые настройки в iiko

🟠 Предназначение продукта

RBCN - разработчик линейки white-label IT продуктов для кафе, кофеен и ресторанов, предназначенных для цифровизации процесса взаимодействия между заведением и Гостем.

Все продукты выпускаются для каждого заведения индивидуально с использованием бренд-бука, логотипа, фирменных цветов заведения ⚠️

1. Мобильное приложение
   1. для отправки заказов на доставку и самовывоз
   2. для чекина гостя в заказ
   3. комбо из двух пунктов выше
2. Сайт
   для отправки заказов на доставку и самовывоз
3. VK приложение
   для отправки заказов на доставку и самовывоз
4. TG приложение
   для отправки заказов на доставку и самовывоз
5. QR меню
   для публикации меню заведения в формате веб-страницы

Все продукты RBCN могут быть запущены как для заведений с 1 точкой, так и для сетей, а также ресторанных холдингов с несколькими различающимися концепциями ✅

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

Помимо указанного все продукты RBCN имеют дополнительные функции размещения новостей заведения, размещения информации об акциях заведения, форму обратной связи, push-уведомления (в мобильном приложении)

Все продукты являются шаблонными, но имеют возможности кастомизации под конкретных запрос заведения в рамках шаблона 🗒️

🟡 Минимальные технические требования к IIKO

Рекомендуемая версия iiko: 8.5 или выше
Минимальная версия iiko: 8.3

Для стабильной работы всех продуктов RBCN = поступления заказов в iikoFront (кроме QR меню) обязательно наличие устойчивого интернет-соединения на стороне iiko.biz и iikoFront

Все продукты RBCN с функцией отправки заказа или выгрузки меню (Мобильное приложение с блоком Отправка заказа / Сайт / VK приложение / TG приложение / QR меню) используется CloudApi ⚠️

🟢 Пошаговая настройка продукта

Все продукты RBCN — комплекс кастомизируемых настроек.

Мы не просим дилеров что-то настраивать в НАШИХ админках!!! ⚠️

Этим занимается наш отдел запуска вместе с Клиентом

Что настраивается только на стороне RBCN:

• Push-уведомления (как рассылки, так и автоматические) и новостные баннеры
• правила и зоны доставки
• дополнительные поля (например Сдача с / Количество персон)
• запреты на отправку заказов / уведомления и подсказки в корзине
• черный список пользователей

Ниже описан список базовых настроек, которые необходимо провести в iiko, для корректной работы всех продуктов.

Тем не менее, на этапе тестов могут возникнуть ошибки в работе API, которые мы не сможем решить самостоятельно - в этом случае Клиент обращается за помощью к дилеру 🗒️

Помимо этого, обычно под запуск продукта RBCN Клиенту, чаще всего, может понадобиться помощь с настройкой специальной акции для привлечение в продукт пользователей

---

🔴 Настройка на стороне iiko (блок: Отправка заказа)

🔑 Создание и настройка API ключа

🔐 Создание API ключа

1 - Заходим в iikoWeb

2 - Выбираем Настройки Cloud API

3 - Переходим во вкладку Организации и проверяем, что у нас видны все организации, куда мы хотим открыть доступ по API

4 - Переходим во вкладку Интеграции и нажимаем Добавить интеграцию

5 - На вкладке Основное заполняем:

• Имя API логина (например: RBCN)
• Email — help@ru-beacon.ru
• Источник заказа — можно заполнить, можно не заполнять*
  

*если источник будет заполнен - вне зависимости от отправляемых через api данных у всех заказов будет отображаться введенный источник (мы рекомендуем не заполнять, поскольку при подключении более 1 продукта мы шлем разные источники, например: RBCNApp / RBCNSite)

6 - На вкладке Подключенные точки нажимаем Добавить точки

7 - В открывшемся окне выбираем нужные точки

8 - Нажимаем Добавить

9 - Возвращаемся на вкладку Основное

10 - Копируем API-ключ

11 - Нажимаем Сохранить

🖥 Добавление терминальных групп к ключу

1 - Заходим в iikoWeb

2 - Выбираем Настройки Cloud API

3 - Переключаемся на вкладку Организации

4 - Выбираем подключенную к созданному ключу организацию

5 - На вкладке Основное проверяем, что напротив организации стоит галочка

6 - Нажимаем Сохранить

Важно ⚠️ Эту манипуляцию необходимо провести на всех подключенных к ключу организациях, чтобы по API мы получили все нужные терминальные группы.

📦 Выгрузка меню

ВАЖНО понимать 🗒️

• мы работаем на данный момент только с меню, выгружаемым из бэка => работаем только с базовым прейскурантом
• выгрузка меню происходит из каждой организации, подключенной к api ключу
  • если подключается больше одной организации и на них на всех плюс минус одинаковое меню, Клиенту будет удобнее его настраивать в iikoChain => необходимо подключить Клиенту репликацию меню из iikoChain во все RMS (если организация одна - выгрузку меню формируем в iikoOffice)
  • при включенной репликации все продукты добавляются в выгрузку в iikoChain, а доступность продуктов и цены регулируются приказами, настраиваемыми в каждом RMS
  • подробно про репликацию расписали вот тут 👉 🔁 Репликация меню
• модификаторы и группы модификаторов отдельно добавлять в выгрузку не нужно => они выгружаются автоматически, если настроены для продукта в номенклатуре
• размеры продуктов поддерживаются, а ценовые категории — нет
• описание какие картинки оптимально добавлять для продуктов вы найдете в разделе 👉 📸 Оптимальные размеры картинок

ЧТО СЛОМАЕТ выгрузку ❌

• внутри категории не должно быть одновременно и категорий и продуктов
• в выгрузке не должно быть дублей продуктов с одинаковыми id = с одинаковыми артикулами
  (если они будут — это не ошибка, но отображаться такие продукты будут только один раз)
• у одинаковых модификаторов и групп модификаторов не может быть разных настроек
  (минимума / максимума / обязательности) для разных продуктов
  (будет использовано правило, которое пришло первым в выгрузке)
• в выгрузке не должно быть пустых групп модификаторов
• объект номенклатуры, созданный как модификатор, не стоит добавлять в выгрузку как продукт
• весовые продукты

➕ Добавление категорий и продуктов в выгрузку

Где настраиваем ⚠️

Если организация одна — настраиваем в iikoOffice
Если организаций несколько и включена репликация — настраиваем в iikoChain

1 - В боковом меню находим раздел Обмен данными

2 - где выбираем Выгрузка меню

3 - В нижней части выбираем категорию или продукт

4 - Нажимаем Добавить выбранные товары

Обратите внимание 🤓

В верхней части экрана будут категории и продукты, которые будут выгружаться в api.
В нижней части экрана — вся номенклатура, из которой формируется выгрузка.

5 - В верхней части экрана находим категорию или продукт

6 - Нажимаем Переместить

7 - Выбираем новую родительскую категорию

8 - Нажимаем ОК

Ещё обратите внимание 🤓

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

После всех настроек обязательно нажимаем Сохранить, затем Выгрузить

🔄 Изменение порядка категорий или продуктов

Иногда перемещение может не срабатывать - в этом случае просто переоткрываем раздел Выгрузка меню

Тот порядок категорий и продуктов, который настроен в выгрузке, отображается и в продуктах RBCN.

1. Выбираем категорию / продукт в верхней части
2. Используем кнопки ⬆️ или ⬇️ для изменения порядка
   

После всех настроек обязательно нажимаем Сохранить, затем Выгрузить

✏️ Настройка названия, описания и фото продукта

1 - нажимаем 2 раза на продукт

2 - в разделе Название пишем название, которое должно отображаться

3 - в разделе Описание пишем описание, которое должно отображаться

4 - в разделе Фото нажимаем Выбрать (если картинку надо заменить, сначала жмем удалить - Cохранить и закрыть, а потом еще раз отрываем настройку)

5 - в системном окне находим нужное фото продукта

6 - нажимаем Открыть

7 - видим наше фото продукта

8 - нажимаем Сохранить и закрыть

Аналогично добавляются картинки для категории.

Если у категории нет отдельной картинки — автоматически будет использовано фото первого продукта с изображением.

После всех настроек обязательно нажимаем Сохранить, затем Выгрузить

🧩 Модификаторы: что поддерживается в приложении

Настройка модификаторов в iiko подробно описана в официальной инструкции 📘 Инструкция iiko по модификаторам

Главное правило по модификаторам ❌ Выгрузка будет работать не корректно если у разных продуктов настройка одного и того же модификатора, или группы модификаторов НЕ будет совпадать

🔹 Одиночные модификаторы

(в инструкциях iiko называются «Простые»)

В приложении все одиночные модификаторы автоматически объединяются в один блок —
«Добавки» или «На выбор».

Из iiko мы подтягиваем:

• Порядок отображения
• Наименование
• Цену
• Максимальное количество

Минимальное количество для нас всегда = 0

На то они и одиночные — пользователь выбирает их по желанию.

🔸 Групповые модификаторы

Созданные группы также отображаются в приложении.
Количество групп не ограничено.

✅ Поддерживаем настройки группы:

• Наименование
• Порядок отображения
• Обязательность выбора
• Минимум и максимум выборов внутри группы

✅ Поддерживаем настройки чойса внутри группы:

• Порядок отображения
• Наименование
• Цена
• Выбор по умолчанию

❌ Не поддерживаем:

• Минимум и максимум на уровне конкретного чойса

⚙️ Ограничения на дочерние модификаторы

У группы может быть включена настройка
«Ограничения на минимум и максимум у дочерних модификаторов».

Если она включена:

• Вы можете добавить одну и ту же группу в несколько блюд
• У отдельных чойсов можно проставить значение 0
• Чойсы со значением 0 в приложении отображаться не будут

⚠️ Схемы модификаторов — с осторожностью

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

📏 Шкалы размеров

📘 Инструкция iiko по шкалам размеров

Для RBCN наличие у продукта шкалы размеров означает:

• Нужно создать групповой модификатор с названием «Размер»
• Сделать его обязательным
• Разрешить единственный выбор
  
  

Поддерживается выбор размера по умолчанию.

📸 Оптимальные размеры картинок

• размеры фото: 1000х700px слишком большие картинки будут слишком долго загружаться
• мы не рекомендуем делать фото на белом ил черном фоне (при смене цветовой темы телефона будет некрасивый контраст)
• картинки вообще без фона ошибок не вызывают
• блюдо должно находиться по центру и располагаться подальше от краев
• далее необходимо понимать, что в продуктах RBCN продукт отображается в списке продуктов и в открытой карточке
  • существует несколько форматов отображения списков для каждого из которых происходит обрезка изображения

🖼 Большие картинки в списке

• рамка контента: 937×700px
• все, что находится вне этой области на экране списка продуктов будет обрезано (на фото - заблюрено)

🖼 Средние картинки в списке

• рамка контента: 937×700px
• все, что находится вне этой области на экране списка продуктов будет обрезано (на фото - заблюрено)

🖼 Маленькие картинки в списке

• рамка контента: 700×700px
• все, что находится вне этой области на экране списка продуктов будет обрезано (на фото - заблюрено)

🔎 Дополнительные проверки терминалов, если организаций больше одной

Как известно, при отправке заказов через iikoTransport заказ создается сразу в iikoFront, тем не менее Клиенту может быть нужно видеть все заказы в iikoCallCenter.

Для этого необходимо проверить, что все подключенные терминалы доставки зарегистрированы в iikoCallCenter.

1. В iikoOffice того RMS, который выполняет функции КоллЦентра, в боковом меню находим раздел Доставка и выбираем Терминалы доставки
2. Проверяем, что все подключенные точки отображаются в списке зарегистрированных терминалов
3. Если не видны — необходимо зарегистрировать

📘 Подробнее в инструкции iiko

✅ Подтверждение заказов

Бывают случаи, когда Клиент просит, чтобы заказы сначала подтверждались в iikoCallCenter, а только после этого с заказом можно было работать в iikoFront.

Для этого необходимо включить подтверждение доставок.

1. В iikoChain в боковом меню находим раздел Доставка и выбираем Подтверждение доставок
   (если точка одна — настраиваем в iikoOffice)
2. Ставим галочку Включить подтверждение доставок
3. Нажимаем Сохранить и закрыть

💰 Типы оплат

Необходимый список типов заказов сообщим или мы или Клиент

Создавать отдельные типы заказов не обязательно — мы можем использовать уже созданные. Иногда Клиент сам просит создать отдельные специально под продукты RBCN.

Если организация одна — настраиваем в iikoOffice / Если организаций несколько — настраиваем в iikoChain ⚠️

В боковом меню находим раздел Розничные продажи и выбираем Типы оплат

1️⃣ Наличные

1. два раза нажимаем на соответствующий тип оплаты (либо создаем отдельный, если Клиент так просит, через кнопку Добавить)
2. проверяем, что тип оплаты доступен на всех организациях, подключенных по ключу
3. ставим галочку Можно комбинировать с другими типами оплаты
4. ставим галочку Может приниматься извне
5. выбираем тип проведения оплаты Как внешний, так и на стороне ресторана
6. пишем Код типа оплаты CASH
7. нажимаем Сохранить

2️⃣ Картой на месте

1. два раза нажимаем на соответствующий тип оплаты (либо создаем отдельный, если Клиент так просит, через кнопку Добавить)
2. проверяем, что тип оплаты доступен на всех организациях, подключенных по ключу
3. ставим галочку Можно комбинировать с другими типами оплаты
4. ставим галочку Может приниматься извне
5. выбираем тип проведения оплаты Как внешний, так и на стороне ресторана
6. пишем Код типа оплаты PCARD
7. ставим галочку Является фискальным
8. нажимаем Сохранить

3️⃣ Картой курьеру

1. два раза нажимаем на соответствующий тип оплаты (либо создаем отдельный, если Клиент так просит, через кнопку Добавить)
2. проверяем, что тип оплаты доступен на всех организациях, подключенных по ключу
3. ставим галочку Можно комбинировать с другими типами оплаты
4. ставим галочку Может приниматься извне
5. выбираем тип проведения оплаты Как внешний, так и на стороне ресторана
6. пишем Код типа оплаты CCARD
7. ставим галочку Является фискальным
8. нажимаем Сохранить

4️⃣ Онлайн оплата

1. два раза нажимаем на соответствующий тип оплаты (либо создаем отдельный, если Клиент так просит, через кнопку Добавить)
2. проверяем, что тип оплаты доступен на всех организациях, подключенных по ключу
3. ставим галочку Можно комбинировать с другими типами оплаты
4. ставим галочку Может приниматься извне
5. выбираем тип проведения оплаты Как внешний, так и на стороне ресторана
6. пишем Код типа оплаты ECARD
7. ставим галочку Является фискальным
8. нажимаем Сохранить

Настройка фискализации может измениться если Клиент подключит отдельно фискализацию Онлайн оплат — мы или Клиент сообщим, если эту настройку нужно будет изменить ℹ️

5️⃣ Оплата баллами iikoCard

📘 Подробно расписано в документации iiko

1 - два раза нажимаем на соответствующий тип оплаты

2 - проверяем, что тип оплаты доступен на всех организациях, подключенных по ключу

3 - ставим галочку Можно комбинировать с другими типами оплаты

4 - ставим галочку Может приниматься извне

5 - выбираем тип проведения оплаты Только на стороне ресторана

6 - пишем Код типа оплаты INET

7 - во вкладке Основные настройки ставим галочку Проводить как скидку

8 - выбираем Скидку из выпадающего списка (если ее нет — нужно создать)

9 - переходим во вкладку Дополнительные настройки

10 - нажимаем Получить маркетинговые программы с действием оплаты

11 - ставим галочку напротив программы, созданной в iiko.biz маркетинговой программы с начислением и списанием бонусов

12 - нажимаем Сохранить

Клиенту может понадобиться холдирование баллов — в этом случае будет необходимо скорректировать настройки бонусной программы в iiko.biz, а также создать отдельный тип оплаты для холдируемых бонусов ℹ️

Подробнее про настройку холдирования расписали тут 👉 💳 Холдирование баллов

Если ранее не была создана скидка, ее нужно добавить

1. в боковом меню находим раздел Дисконтная система и выбираем Скидки и надбавки
2. нажимаем Добавить
3. заполняем Название и Название в пречеке
4. остальные дефолтные настройки не меняем
5. нажимаем Далее
6. снимаем галочку Можно назначать вручную
7. остальные дефолтные настройки не меняем
8. нажимаем Далее
9. в типе указываем Фиксированная сумма
10. остальные дефолтные настройки не меняем
11. нажимаем Далее
12. проверяем, что галочка Активировать скидку стоит
13. нажимаем ОК

🛍 Типы заказов

Необходимый список типов заказов сообщим или мы или Клиент

Создавать отдельные типы заказов не обязательно — мы можем использовать уже созданные. Иногда Клиент сам просит создать отдельные специально под продукты RBCN.

Если организация одна — настраиваем в iikoOffice / Если организаций несколько — настраиваем в iikoChain ⚠️

В боковом меню находим раздел Розничные продажи и выбираем Типы заказов.

1️⃣ Доставка

1 - проверяем, что у типа заказа Доставка стоит режим обслуживания Доставка курьером

Если Клиент просит создать отдельный тип заказа:

1 - нажимаем кнопку Добавить

2 - пишем Наименование

3 - выбираем режим обслуживания Доставка курьером

4 - нажимаем Сохранить

2️⃣ Самовывоз

1 - проверяем, что у типа заказа Доставка самовывоз стоит режим обслуживания Доставка самовывоз

Если Клиент просит создать отдельный тип заказа:

1 - нажимаем кнопку Добавить

2 - пишем Наименование

3 - выбираем режим обслуживания Доставка самовывоз

4 - нажимаем Сохранить

3️⃣ На месте

Обычно для типа заказа Обычный заказ стоит режим обслуживания Обычный заказ — это значит, что при использовании этого типа заказа при его создании из api заказ будет создаваться на стол ℹ️

Чаще всего Клиенту это не нужно => необходимо создать отдельный тип заказа:

1 - нажимаем кнопку Добавить

2 - пишем Наименование

3 - выбираем режим обслуживания Доставка самовывоз

4 - нажимаем Сохранить

🏙 Выгрузка городов и улиц

Важно ⚠️

Если организация одна — настраиваем в iikoOffice.
Если организаций несколько — настраиваем в iikoChain, а затем запускаем 🔄 принудительный обмен

Настройка

1 - В боковом меню находим раздел Доставка и выбираем Города

2 - Если нужные города уже есть в списке — переходим к следующему пункту.
Если нет:

• Нажимаем Добавить

• Вводим нужное Название города
• Нажимаем Сохранить и закрыть

3 - В списке городов нажимаем правой кнопкой на нужном городе

4 - Выбираем Загрузить список улиц из КЛАДР

• Многие наименования городов дублируются в разных регионах — выбираем нужный регион

5 - В открывшемся окне нажимаем Да

• Либо меняем регион при необходимости
  

Выгрузка

Важно ⚠️ Выгрузка городов и улиц в API производится в каждой подключаемой организации в iikoOffice.

1 - В боковом меню находим раздел Доставка и выбираем Города

2 - Если города добавлялись в iikoChain — в верхнем меню нажимаем Обновить

3 - В верхнем меню нажимаем Выгрузить в API

4 - в боковом меню находим раздел Доставка и выбираем Улицы

5 - В верхнем меню нажимаем Выгрузить в API

Важно ⚠️ Данные манипуляции необходимо провести в каждой подключаемой организации.

🚚 Платная доставка

Обратите внимание ℹ️ Мы не работаем с настройками ГРиК.

Он может быть настроен или не настроен — на нашу работу это никак не повлияет.
При запуске мы попросим Клиента прислать карту зон доставки с описанием условий доставки для каждой зоны.

Для корректной работы с платной доставкой нам понадобятся продукты или услуги, например: «Доставка 100 ₽» — стоимостью 100 ₽ — в выгрузке меню.

Подробнее, как добавить продукт в выгрузку меню, описано здесь 📦 Выгрузка меню

Важно ❌ Для одного и того же продукта / услуги платной доставки не может быть настроено разных цен для разных организаций.

🔄 Как запустить принудительный обмен iikoChain со всеми RMS

Как вы знаете, изменения, проведенные в iikoChain, не всегда моментально разлетаются по всем организациям (RMS) ℹ️

Как ускорить этот процесс – расписано ниже 👇

1 - в боковом меню находим раздел Корпорация и выбираем Монитор синхронизации

2 - выбираем организации, с которыми хотим запустить обмен
можно выбрать несколько организаций, зажав клавишу Shift

3 - нажимаем Экстр. обмен

---

🔴 Настройка на стороне iiko (блок: Чекин гостя в заказ)

🧾 Чекин гостя в заказ

Вообще, описание и настройки добавлены 👉 📘 в инструкции iiko

Вот тут 👉 расписано зачем нужен блок 📘 Чекин гостя в заказ

А вот тут 👉 📘 что делать в iikoFront для чекина гостя в заказ

ВАЖНО 📌 Режим Ресторан и его функции (чекин гостя в заказ посредством ввода кода с перчека) НЕ доступны из-за ограничений API, вступающих в силу 15.01.2026

1️⃣ Подключение доступа

При подключении нескольких организаций в одно приложение ⚠️:

• описанные ниже действия необходимо провести для КАЖДОЙ подключаемой организации
• все подключаемые организации должны быть объединены в сеть

1. заходим в iiko.biz под администратором
2. в верхнем меню выбираем раздел Приложения
3. в боковом меню выбираем Список
4. в списке доступных приложений выбираем Rubeacon
5. в открывшемся окне нажимаем Подключить и вводим любое количество лицензий больше 0 (это действие НЕ влияет на подключение платных лицензий, они подключаются отдельно)

2️⃣ Настройка поиска гостя

Описанные ниже действия необходимо провести для КАЖДОЙ подключаемой организации и для сети ⚠️

Все подключаемые организации должны быть объединены в сеть

1. в iiko.biz в верхнем меню выбираем раздел iikoCard
2. в боковом меню выбираем Настройки
3. выбираем нужную организацию / сеть
4. снимаем галочку Авторизация гостя По карте
5. ставим галочку Авторизация гостя По номеру телефона
6. ставим галочку Запрашивать данные гостя с сервера перед его созданием

3️⃣ Настройка подключения

С 01.01.2026 нам нужно ТОЛЬКО отдельный API ключ для подключения через iikoTransport ⚠️

1 - заходим в iikoWeb

2 - выбираем Настройки Cloud API

3 - переходим во вкладку Организации и проверяем, что у нас видны все организации, куда мы ходим открыть доступ по api

4 - переходим во вкладку Интеграции и нажимаем Добавить интеграцию

5 - на вкладке Основное заполняем:

• Имя api логина (например RBCN_checkin)
• Email (help@ru-beacon.ru)
• Источник заказа можно заполнить, можно не заполнять*

*если источник будет заполнен - вне зависимости от отправляемых через api данных у всех заказов будет отображаться введенный источник (мы рекомендуем не заполнять, поскольку при подключении более 1 продукта мы шлем разные источники, например: RBCNApp / RBCNSite)

6 - на вкладке Подключенные точки нажимаем Добавить точки

7 - в открывшемся окне выбираем нужные* точки

8 - нажимаем Добавить

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

9 - возвращаемся на вкладку Основное
10 - копируем api ключ
11 - нажимаем Сохранить

Более от дилера НИКАКИХ настроек не нужно, поскольку после изменений начала 2026 все остальные настройки происходят на нашей стороне 🔥

🔥 Как проверить, что api ключ для настройки блока Отправка заказа настроен верно и по нему уходит все, что было настроено?

✔️ Мы знаем, что не всегда удобно запускать Postman и проверять, что отдает тот или иной api ключ, поэтому для вашего удобства собрали основные запросы и удобный интерфейс, чтобы вы могли проверить когда вам удобно любой ключ 👇

🍀 RBCN ApiChecker

🛒 Как принимать и обрабатывать заказы?

💬 Контакты

На всякий случай оставляем контакты, куда можно писать в любое время по всем вопросам

🆘 поддержка help@ru-beacon.ru или https://t.me/RBCNbot

🫂 познакомиться и пообщаться @matvey_matvey или @Ele4ka_T