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

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

• мы работаем на данный момент только с меню, выгружаемым из бэка => работаем только с базовым прейскурантом
• выгрузка меню происходит из каждой организации, подключенной к 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
• все, что находится вне этой области на экране списка продуктов будет обрезано (на фото - заблюрено)