Все статьи
Автоматизация и интеграции14 ноября 2026· 10 мин

Интеграция Яндекса и iiko: как подключить заказы из Еды

Как подключить Яндекс Еду к iiko: подготовка меню, настройка в iikoWeb, проверка заказов, оплат и стоп-листа. Чем отличается модуль Яндекс Доставки.

Интеграция Яндекса и iiko позволяет передавать заказы Яндекс Еды в ресторанную систему без ручного переноса состава. Для запуска нужно настроить источник заказов, связать его с нужной точкой и внешним меню - набором блюд и описаний для Еды, затем проверить обмен. Конкретный путь зависит от вашей конфигурации iiko; ниже разобран вариант из официальной документации iikoMini для iikoWeb.

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

Заказ на экране телефона и ресторанной кассы рядом с упакованным обедом

Какую интеграцию Яндекса вы подключаете

Начните с источника заказа. Яндекс Еда передаёт ресторану заказ, оформленный на площадке. Модуль Яндекс Доставки помогает отправить уже созданный в iiko заказ в экспресс-доставку.

Задача ресторанаНужное подключениеЧто проверить
Получать заказы с площадки Еды в iikoИнтеграция Яндекс Еды с ресторанной системойСостав заказа, нужную точку, оплату и обмен статусами
Вызывать курьера для заказа, который уже есть в iikoМодуль Яндекс ДоставкиСовместимость системы, кабинет Доставки и порядок отправки заявки

Для модуля Доставки Яндекс отдельно указывает условие: по заказу в iiko должна быть принята оплата. Требования этого модуля к версии и лицензиям нельзя переносить на подключение Еды. Актуальные условия опубликованы в справке Яндекс Доставки.

Собственный сайт ресторана - ещё один источник заказов. Если вы готовите его параллельно, сначала определите, какие каналы будут передавать заказы в iiko. Отдельный разбор запуска сайта доставки поможет собрать требования к этому каналу.

Что подготовить до настройки

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

Передайте специалисту список исходных данных:

  • Ресторан и точка продаж. Для сети укажите адреса и меню каждой точки.
  • Конфигурация iiko. Уточните версию, доступные модули и наличие нужных разделов в iikoWeb. Не покупайте дополнительную лицензию по инструкции для другой схемы подключения.
  • Терминальная группа. Это группа кассовых терминалов, на которую должен поступать заказ. Если таких групп несколько, заранее определите нужную.
  • Внешнее меню. Назовите меню, предназначенное для Еды, и ответственного за его изменения.
  • Сценарии работы. Укажите используемые способы получения заказа, оплату и акции, которые предстоит проверить.

Запишите также, кто отвечает за обращения в Яндекс, настройки iiko и работу смены при сбое. Согласуйте список параметров и ответственных. Доступ к кабинету сам по себе ещё не подтверждает готовность обмена.

Как подключить Яндекс Еду через iikoWeb

В варианте из документации iikoMini подключение создают через приложение «Внешние заказы». Если у вас другие разделы или нет нужного типа источника, остановитесь и уточните маршрут у обслуживающего партнёра iiko.

Последовательность по официальной инструкции iiko:

  1. Откройте в iikoWeb приложение «Внешние заказы», затем «Источники заказов» и нажмите «Добавить».
  2. В поле «Тип» выберите «Яндекс.Еда», задайте название интеграции и сохраните её.
  3. Выберите подключаемый ресторан и нужную терминальную группу. Укажите предварительно настроенные типы заказов, оплат, скидок и услугу доставки.
  4. Перейдите на вкладку «ВЫГРУЗКА НОМЕНКЛАТУРЫ», выберите внешнее меню ресторана и сохраните настройки.
  5. Подготовьте параметры подключения: Host, Client id, Client secret. В этом сценарии Host соответствует полю WebHook URL в настройках терминальных групп.
  6. Передайте параметры Яндексу согласованным способом и договоритесь о проверке подключения. Начать оформление заявки можно с обращения в поддержку в кабинете ресторана; доступные темы обращения уточните в своей форме.

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

Создание и настройка источника в iikoWeb - часть подключения. Затем нужно согласовать подключение на стороне Яндекса и проверить заказы.

Как подготовить меню и стоп-лист

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

В документации iikoMini описаны создание и редактирование внешнего меню: категории, блюда, цены, вес, изображения и модификаторы. Модификатор - вариант или добавка к блюду, например соус, начинка или выбор основы.

Для проверки выберите позиции, на которых легко заметить ошибку:

  • простое блюдо без добавок;
  • блюдо с платным модификатором;
  • блюдо с обязательным выбором;
  • позицию с разными размерами или составом, если вы её продаёте;
  • блюдо, участвующее в используемой акции.

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

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

Если данные на витрине устарели, сначала выясните источник изменений и состояние обмена. Согласуйте с поддержкой, где менять данные и может ли следующий обмен перезаписать ручную правку в кабинете. Изменение складского остатка не заменяет проверку стоп-листа: убедитесь, что гость видит актуальную доступность блюда.

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

Как проверить интеграцию перед запуском

Согласуйте с поддержкой режим проверки и проведите заказ по всему рабочему пути. Нужно увидеть его в нужной точке, сверить состав и оплату, проверить передачу на кухню и доступные статусы. Ниже - предлагаемый план приёмки, а не отчёт об испытании конкретной кассы.

Одинаковый бургер с соусом на двух экранах и готовый заказ перед проверкой
ПроверкаЧто сделатьПризнак успешного результата
Обычный заказЗаказать простое блюдо в согласованном режимеЗаказ появился в нужном ресторане; количество и состав верны
МодификаторыДобавить платную опцию и сделать обязательный выборВ iiko и на кухне виден выбранный вариант; итог совпадает с исходным заказом
Оплата и скидкаПроверить реально используемый способ оплаты и акциюВерны тип оплаты, скидка и итог; сотрудник понимает порядок расчёта с гостем
Стоп-листВременно закрыть тестовую позицию, затем вернуть еёГость видит недоступность, а после снятия стопа может снова выбрать позицию
Маршрутизация сетиПроверить подключаемые точки по отдельностиКаждый заказ поступает по нужному адресу и на нужную терминальную группу
СтатусыПровести заказ по поддерживаемым этапамДоступные состояния согласованы между системами; смена знает, где их менять

В API Яндекс Еды, интерфейсе для обмена данными между программами, создание, изменение, отмена и передача статуса описаны отдельными операциями. Наличие этих операций в API не означает, что установленное подключение автоматически выполняет их все. Попросите сопровождающего специалиста назвать поддерживаемые действия и подтвердить их при проверке.

Отмену заказа и возврат оплаты согласуйте отдельно. Нельзя считать изменение статуса подтверждением возврата денег. Если для теста используется реальная оплата, заранее определите порядок завершения или отмены такого заказа.

Зафиксируйте результаты: сценарий, номер и время заказа, точку, ожидаемое и фактическое поведение. Не включайте в общий отчёт данные гостя и секреты подключения. Если часть проверки не прошла, укажите конкретный дефект и повторите этот сценарий после исправления.

Что делать при ошибках обмена

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

Что произошлоЧто проверить первымСледующее действие
В Еде заказ есть, в iiko его не видноРесторан, время, поиск по номеру и состояние подключенияПередать данные поддержке; применять согласованный резервный порядок
Заказ поступил в другую точкуВыбранный ресторан и терминальную группуИсправить маршрутизацию со специалистом и повторить проверку точки
Состав верный, сумма отличаетсяПлатные добавки, источник цены, скидку и тип оплатыСверить итог с исходным заказом, затем проверить настройки
Закончившееся блюдо остаётся в продажеГде установлен стоп и передалась ли недоступностьЗафиксировать расхождение и согласовать временное ограничение продаж
Карточка есть, кухня заказ не получилаКак заказ передаётся на кухнюПроверить настройки с сопровождающим iiko; появления карточки недостаточно
Один заказ приготовили дваждыАвтоматическую запись и ручное заведениеСопоставить номера, разобрать резервный порядок и исключить повторное приготовление

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

По конкретному заказу в кабинете Еды доступен путь «Заказы» → нужный заказ → «Помощь по заказу». Общие вопросы по настройке направляйте через раздел поддержки. Этот порядок описан в справке Яндекс Еды.

Что включить в стоимость и сопровождение

Запросите смету под вашу конфигурацию. Разделите необходимые лицензии, работы по настройке, подготовку меню и дальнейшую поддержку. Условия работы с площадкой и расходы на курьерскую доставку уточняйте отдельно от стоимости интеграционных работ.

В предложении на подключение должны быть названы:

  • поддерживаемая установка iiko и подключаемые точки;
  • состав обмена: меню, модификаторы, стоп-лист, заказы, оплаты и статусы;
  • ответственные за настройку каждой стороны;
  • приёмочные сценарии и способ фиксации результата;
  • порядок обращения при сбое и временный режим работы;
  • сопровождение после обновлений iiko и изменений меню.

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

Следующий шаг для подключения Еды - передать специалисту параметры своей установки и согласовать проверочные заказы. Для отдельного приложения под брендом ресторана можно запросить демонстрацию Monobox с разбором его обмена с iiko.

Источники

Документация проверена 14 ноября 2026 года. Настройка на рабочей кассе в рамках подготовки статьи не выполнялась.

Хотите запустить доставку еды быстрее и без ошибок?

Получите демонстрацию готовой платформы для доставки еды.

Перейти к решению