Skip to content

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

КРИТИЧЕСКИ ВАЖНО: Изменение метода выгрузки с 1 ноября 2026 года ⚠️

С 1 ноября 2026 года компания iiko прекращает поддержку старого метода выгрузки меню через раздел «Обмен данными» → «Выгрузка меню» в iikoOffice. Этот метод, описанный ниже в разделе «➡️ Выгрузка меню из бэка», будет полностью отключен.

Для дальнейшей работы вам необходимо перейти на использование «Внешнего меню iikoWeb». Вся новая информация в этом документе относится именно к этому способу. Пожалуйста, ознакомьтесь с ней и запланируйте переход.

🚀 Внешнее меню iikoWeb🔗

Внешнее меню — это инструмент iikoWeb, который позволяет создать отдельный список блюд для экспорта во внешние системы, такие как наше приложение / сайт / VK mini App.

Это основной и рекомендуемый способ выгрузки меню для интеграции.

Что дает внешнее меню?🔗

  • Можно создать несколько разных меню под разные задачи (например, для приложения одно меню, для Яндекс Еда — другое)
  • Можно настроить разные цены для разных агрегаторов (приложение, Яндекс Еда и т.д.)
  • Можно добавить картинки для модификаторов
  • Можно использовать любые ценовые категории, а не только базовый прейскурант
  • Нет проблем с разными настройками модификаторов для разных продуктов (во внешнем меню каждый продукт получает свои настройки модификаторов индивидуально)

🔑 Ключевое условие для работы🔗

Для того чтобы мы могли выгружать ваше меню через API, внешнее меню должно быть подключено к тому API-ключу, который вы предоставляете нам для интеграции. Это обязательное условие.

⚠️ Важно понимать🔗

❗ Блюда и продукты не создаются во внешнем меню — они берутся из вашей номенклатуры iikoOffice/iikoChain. Внешнее меню — это как конструктор, в котором вы собираете нужный набор блюд из уже существующей номенклатуры.

🛠️ Инструкция по созданию внешнего меню🔗

Официальные инструкции iiko: - Создание внешнего меню - Настройка внешнего меню

Мы настоятельно рекомендуем заручиться поддержкой вашего обслуживающей компании iiko при создании внешнего меню, особенно если у вас нет опыта работы с этим инструментом. Это поможет избежать ошибок на начальном этапе.

⚙️ Возможности настройки выгрузки🔗

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

  • Вес блюд (выход в граммах)
  • Пищевая ценность (КБЖУ) на весь продукт (порцию)
  • Вес модификаторов
  • Картинки модификаторов (рекомендуемый размер 1000х1000px с контентом по центру)

📋 Пошаговый чек-лист для подключения🔗

  • Создано внешнее меню в iikoWeb
  • Внешнее меню привязано к нашему API-ключу
  • В настройках API-ключа для выбранного внешнего меню выбран источник цен «Ценовые категории» (это необходимо для корректной работы приказов)
  • Если используете ценовые категории — выбрана нужная категория
  • Внешнее меню синхронизировано с номенклатурой

После выполнения всех пунктов сообщите нам — мы выгрузим ваше меню.

❗ Важно знать про обновление меню🔗

В настоящее время внешнее меню обновляется на нашей стороне раз в час. Если вы внесли изменения в iikoWeb, они не применятся мгновенно — нужно подождать до следующего обновления.

Также мы можем выгрузить меню вручную по запросу.

🔄 Синхронизация с номенклатурой🔗

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

❗ Частая ошибка: не применяются приказы🔗

Если приказы не применяются, проверьте:

  1. В настройках API-ключа в iikoWeb для выбранного внешнего меню должен быть выбран источник цен «Ценовые категории»
  2. В нашей админке выбрана нужная ценовая категория
  3. После изменения настроек в iikoWeb мы перевыгрузили настройки внешнего меню и затем перевыгрузили само меню

➡️ Выгрузка меню из бэка (метод, устаревающий с 01.11.2026)🔗

Этот метод будет ОТКЛЮЧЕН с 1 ноября 2026 года

Данный раздел оставлен для справки, но с указанной даты работать НЕ БУДЕТ. Всем клиентам необходимо перейти на использование Внешнего меню iikoWeb, описанного выше.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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