Интеграция Яндекса и iiko: как подключить заказы из Еды
Как подключить Яндекс Еду к iiko: подготовка меню, настройка в iikoWeb, проверка заказов, оплат и стоп-листа. Чем отличается модуль Яндекс Доставки.
Интеграция Яндекса и iiko позволяет передавать заказы Яндекс Еды в ресторанную систему без ручного переноса состава. Для запуска нужно настроить источник заказов, связать его с нужной точкой и внешним меню - набором блюд и описаний для Еды, затем проверить обмен. Конкретный путь зависит от вашей конфигурации iiko; ниже разобран вариант из официальной документации iikoMini для iikoWeb.
Если задача ресторана - вызвать курьера для заказа с собственного сайта, нужен другой сценарий: модуль Яндекс Доставки. Подключение витрины Еды и курьерской службы проверяют отдельно.
Какую интеграцию Яндекса вы подключаете
Начните с источника заказа. Яндекс Еда передаёт ресторану заказ, оформленный на площадке. Модуль Яндекс Доставки помогает отправить уже созданный в iiko заказ в экспресс-доставку.
| Задача ресторана | Нужное подключение | Что проверить |
|---|---|---|
| Получать заказы с площадки Еды в iiko | Интеграция Яндекс Еды с ресторанной системой | Состав заказа, нужную точку, оплату и обмен статусами |
| Вызывать курьера для заказа, который уже есть в iiko | Модуль Яндекс Доставки | Совместимость системы, кабинет Доставки и порядок отправки заявки |
Для модуля Доставки Яндекс отдельно указывает условие: по заказу в iiko должна быть принята оплата. Требования этого модуля к версии и лицензиям нельзя переносить на подключение Еды. Актуальные условия опубликованы в справке Яндекс Доставки.
Собственный сайт ресторана - ещё один источник заказов. Если вы готовите его параллельно, сначала определите, какие каналы будут передавать заказы в iiko. Отдельный разбор запуска сайта доставки поможет собрать требования к этому каналу.
Что подготовить до настройки
Соберите параметры вашей установки и согласуйте подключение с тем, кто сопровождает iiko. До создания интеграции документация iikoMini предписывает настроить типы заказов, оплат, скидок и услугу доставки с помощью технической поддержки.
Передайте специалисту список исходных данных:
- Ресторан и точка продаж. Для сети укажите адреса и меню каждой точки.
- Конфигурация iiko. Уточните версию, доступные модули и наличие нужных разделов в iikoWeb. Не покупайте дополнительную лицензию по инструкции для другой схемы подключения.
- Терминальная группа. Это группа кассовых терминалов, на которую должен поступать заказ. Если таких групп несколько, заранее определите нужную.
- Внешнее меню. Назовите меню, предназначенное для Еды, и ответственного за его изменения.
- Сценарии работы. Укажите используемые способы получения заказа, оплату и акции, которые предстоит проверить.
Запишите также, кто отвечает за обращения в Яндекс, настройки iiko и работу смены при сбое. Согласуйте список параметров и ответственных. Доступ к кабинету сам по себе ещё не подтверждает готовность обмена.
Как подключить Яндекс Еду через iikoWeb
В варианте из документации iikoMini подключение создают через приложение «Внешние заказы». Если у вас другие разделы или нет нужного типа источника, остановитесь и уточните маршрут у обслуживающего партнёра iiko.
Последовательность по официальной инструкции iiko:
- Откройте в iikoWeb приложение «Внешние заказы», затем «Источники заказов» и нажмите «Добавить».
- В поле «Тип» выберите «Яндекс.Еда», задайте название интеграции и сохраните её.
- Выберите подключаемый ресторан и нужную терминальную группу. Укажите предварительно настроенные типы заказов, оплат, скидок и услугу доставки.
- Перейдите на вкладку «ВЫГРУЗКА НОМЕНКЛАТУРЫ», выберите внешнее меню ресторана и сохраните настройки.
- Подготовьте параметры подключения: Host, Client id, Client secret. В этом сценарии Host соответствует полю WebHook URL в настройках терминальных групп.
- Передайте параметры Яндексу согласованным способом и договоритесь о проверке подключения. Начать оформление заявки можно с обращения в поддержку в кабинете ресторана; доступные темы обращения уточните в своей форме.
Client secret - секрет подключения. Передавайте его только уполномоченному специалисту через согласованный канал, без публикации в общих инструкциях и снимках экрана.
Создание и настройка источника в iikoWeb - часть подключения. Затем нужно согласовать подключение на стороне Яндекса и проверить заказы.
Как подготовить меню и стоп-лист
Проверьте всю цепочку: карточку блюда в iiko, выбранное внешнее меню и то, что видит гость в Еде. Совпадение названий не подтверждает корректную передачу цены, добавок и доступности.
В документации iikoMini описаны создание и редактирование внешнего меню: категории, блюда, цены, вес, изображения и модификаторы. Модификатор - вариант или добавка к блюду, например соус, начинка или выбор основы.
Для проверки выберите позиции, на которых легко заметить ошибку:
- простое блюдо без добавок;
- блюдо с платным модификатором;
- блюдо с обязательным выбором;
- позицию с разными размерами или составом, если вы её продаёте;
- блюдо, участвующее в используемой акции.
Наличие размеров или комбо в iiko не подтверждает, что конкретное подключение передаёт их в Еду в нужном виде. Согласуйте представление таких позиций и проверьте итоговую витрину. Яндекс описывает обязательные данные блюда, платные и бесплатные опции, а также модерацию в правилах создания меню.
Стоп-лист - перечень временно недоступных позиций. Согласуйте, где его ведут при вашей схеме, затем проверьте оба действия: постановку блюда в стоп и возврат в продажу. Отдельно проверьте недоступный соус или другую добавку: доступность основного блюда не означает, что доступны все его варианты.
Если данные на витрине устарели, сначала выясните источник изменений и состояние обмена. Согласуйте с поддержкой, где менять данные и может ли следующий обмен перезаписать ручную правку в кабинете. Изменение складского остатка не заменяет проверку стоп-листа: убедитесь, что гость видит актуальную доступность блюда.
Если одновременно запускаете собственный канал, составьте для него отдельное задание на обмен. У Monobox можно запросить демонстрацию приложения с интеграцией iiko и проверить нужные ресторану сценарии. Это отдельное подключение собственного приложения.
Как проверить интеграцию перед запуском
Согласуйте с поддержкой режим проверки и проведите заказ по всему рабочему пути. Нужно увидеть его в нужной точке, сверить состав и оплату, проверить передачу на кухню и доступные статусы. Ниже - предлагаемый план приёмки, а не отчёт об испытании конкретной кассы.
| Проверка | Что сделать | Признак успешного результата |
|---|---|---|
| Обычный заказ | Заказать простое блюдо в согласованном режиме | Заказ появился в нужном ресторане; количество и состав верны |
| Модификаторы | Добавить платную опцию и сделать обязательный выбор | В iiko и на кухне виден выбранный вариант; итог совпадает с исходным заказом |
| Оплата и скидка | Проверить реально используемый способ оплаты и акцию | Верны тип оплаты, скидка и итог; сотрудник понимает порядок расчёта с гостем |
| Стоп-лист | Временно закрыть тестовую позицию, затем вернуть её | Гость видит недоступность, а после снятия стопа может снова выбрать позицию |
| Маршрутизация сети | Проверить подключаемые точки по отдельности | Каждый заказ поступает по нужному адресу и на нужную терминальную группу |
| Статусы | Провести заказ по поддерживаемым этапам | Доступные состояния согласованы между системами; смена знает, где их менять |
В API Яндекс Еды, интерфейсе для обмена данными между программами, создание, изменение, отмена и передача статуса описаны отдельными операциями. Наличие этих операций в API не означает, что установленное подключение автоматически выполняет их все. Попросите сопровождающего специалиста назвать поддерживаемые действия и подтвердить их при проверке.
Отмену заказа и возврат оплаты согласуйте отдельно. Нельзя считать изменение статуса подтверждением возврата денег. Если для теста используется реальная оплата, заранее определите порядок завершения или отмены такого заказа.
Зафиксируйте результаты: сценарий, номер и время заказа, точку, ожидаемое и фактическое поведение. Не включайте в общий отчёт данные гостя и секреты подключения. Если часть проверки не прошла, укажите конкретный дефект и повторите этот сценарий после исправления.
Что делать при ошибках обмена
Сначала найдите этап, на котором возникло расхождение. Для обращения пригодятся номер заказа, время, ресторан, описание ошибки и снимок экрана без лишних персональных данных. Эти сведения помогают отличить проблему меню от ошибки передачи или настройки точки.
| Что произошло | Что проверить первым | Следующее действие |
|---|---|---|
| В Еде заказ есть, в iiko его не видно | Ресторан, время, поиск по номеру и состояние подключения | Передать данные поддержке; применять согласованный резервный порядок |
| Заказ поступил в другую точку | Выбранный ресторан и терминальную группу | Исправить маршрутизацию со специалистом и повторить проверку точки |
| Состав верный, сумма отличается | Платные добавки, источник цены, скидку и тип оплаты | Сверить итог с исходным заказом, затем проверить настройки |
| Закончившееся блюдо остаётся в продаже | Где установлен стоп и передалась ли недоступность | Зафиксировать расхождение и согласовать временное ограничение продаж |
| Карточка есть, кухня заказ не получила | Как заказ передаётся на кухню | Проверить настройки с сопровождающим iiko; появления карточки недостаточно |
| Один заказ приготовили дважды | Автоматическую запись и ручное заведение | Сопоставить номера, разобрать резервный порядок и исключить повторное приготовление |
Перед ручным заведением пропавшего заказа проверьте, не появилась ли его запись с задержкой. Один сотрудник должен отвечать за резервные действия и последующую сверку. Переключение нескольких работников на ручной ввод без общего учёта создаёт риск дублей.
По конкретному заказу в кабинете Еды доступен путь «Заказы» → нужный заказ → «Помощь по заказу». Общие вопросы по настройке направляйте через раздел поддержки. Этот порядок описан в справке Яндекс Еды.
Что включить в стоимость и сопровождение
Запросите смету под вашу конфигурацию. Разделите необходимые лицензии, работы по настройке, подготовку меню и дальнейшую поддержку. Условия работы с площадкой и расходы на курьерскую доставку уточняйте отдельно от стоимости интеграционных работ.
В предложении на подключение должны быть названы:
- поддерживаемая установка iiko и подключаемые точки;
- состав обмена: меню, модификаторы, стоп-лист, заказы, оплаты и статусы;
- ответственные за настройку каждой стороны;
- приёмочные сценарии и способ фиксации результата;
- порядок обращения при сбое и временный режим работы;
- сопровождение после обновлений iiko и изменений меню.
Если планируете собственное приложение, сравните требования к нему с уже подготовленным списком. В статье о выборе готового приложения разобрано, что уточнить у поставщика до запуска. Возможности собственного обмена Monobox описаны на странице интеграции с iiko.
Следующий шаг для подключения Еды - передать специалисту параметры своей установки и согласовать проверочные заказы. Для отдельного приложения под брендом ресторана можно запросить демонстрацию Monobox с разбором его обмена с iiko.
Источники
Документация проверена 14 ноября 2026 года. Настройка на рабочей кассе в рамках подготовки статьи не выполнялась.
Хотите запустить доставку еды быстрее и без ошибок?
Получите демонстрацию готовой платформы для доставки еды.
Перейти к решению