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

Интеграции iiko: что подключить и как проверить обмен данными

Какие сервисы подключают к iiko и что проверить до запуска: меню, стоп-листы, заказы, оплаты и статусы. Критерии выбора интеграции и вопросы подрядчику.

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

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

Какие задачи решают интеграции iiko

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

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

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

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

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

Как выбрать способ подключения

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

Здесь два решения. Первое - использовать готовую связку или заказывать разработку. Второе - через какой интерфейс она работает. Готовый сервис тоже использует API или установленный компонент; слово «готовый» не объясняет устройство подключения.

Способ обменаЧто означаетЧто уточнить у исполнителя
Облачный API (Cloud API)Программный интерфейс обмена данными iiko, к которому подключается внешний сервисНужные операции, права, доступ к заведениям в системе, обработку ошибок и изменений статусов
Плагин iikoFrontДополнительная программа, которую устанавливают там, где работает кассовое приложение iikoFrontСовместимость версии, установку, лицензирование и обновление компонента

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

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

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

Что согласовать до подключения

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

Начните с меню. В руководстве по внешнему меню описаны блюда, категории, цены, фотографии и модификаторы - варианты или добавки к блюду. Для своей витрины уточните, какие поля передаются и где их редактировать. Например, кто меняет цену, как передаётся обязательный выбор размера и откуда берётся доплата за добавку.

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

Для рабочего задания зафиксируйте следующие пункты:

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

Уточните также, не затронет ли настройка уже работающие подключения. Вебхуки - автоматические уведомления систем о событиях - могут использоваться несколькими процессами. Их адреса и порядок обработки следует согласовать с ответственными за текущие интеграции; особенности описаны в руководстве iiko по вебхукам.

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

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

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

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

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

Ниже таблица проверок перед запуском. Согласуйте тестовую среду или контрольные заказы с исполнителем. Операции с оплатой проводите в предусмотренном поставщиком тестовом режиме; их результат отдельно сверяют ответственные за платежи.

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

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

Проверку завершайте в таком порядке:

  1. Сверьте заказ, оформленный гостем, с заказом в iiko: состав, дополнения, количество, сумма, точка и способ получения.
  2. Убедитесь, что подтверждения и ошибки видны тем сотрудникам, которые должны на них реагировать.
  3. Проверьте повтор после сбоя, отмену и возврат к обычному приёму заказов.
  4. Зафиксируйте непрошедшие сценарии и условия повторной проверки. До исправления критичных расхождений ограничьте запуск затронутых операций.

Что делать, если обмен работает с ошибками

Коротко: сначала установите состояние конкретного заказа и платежа, затем устраняйте причину. При неизвестном результате отправки повторное создание заказа без проверки может дать дубль.

Соберите время ошибки, номер заказа во внешнем сервисе, точку, ожидаемый результат и обезличенное описание того, что произошло. В руководстве по отладке iiko для диагностики используется идентификатор запроса. Попросите исполнителя добавить его в обращение, если он доступен в используемом интерфейсе.

НаблюдениеС чего начать проверку
На витрине старая ценаИсточник цены, выбранное внешнее меню, ценовые настройки и результат последнего обновления
Недоступное блюдо продолжает продаватьсяСтоп-лист нужной точки, получение уведомления и повторный запрос актуальных данных
Заказ отправлен, но сотрудники его не видятРезультат обработки, организация, группа терминалов и состояние соединения
Появился повторный заказСвязь повторной отправки с исходной операцией и реализованную защиту от дублей
Статусы в приложении не меняютсяКакие события передаются, принимаются ли уведомления и как обновляется интерфейс гостя
Суммы в аналитике расходятсяПериод, точки, статусы заказов, скидки, возвраты и учёт стоимости доставки

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

Из чего складывается стоимость интеграции

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

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

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

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

Как связать iiko с сайтом и приложением Monobox

Коротко: Monobox предлагает интеграцию сайта и приложения с iiko. Состав обмена и условия для вашего ресторана стоит подтвердить на демонстрации и зафиксировать в предложении.

На странице интеграции Monobox с iiko перечислены передача заказов, синхронизация меню, цен, модификаторов, стоп-листов и статусов. Это публичное описание поставщика; работу нужных операций проверяют на конфигурации ресторана.

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

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

Источники

Продуктовые сведения проверены по открытым страницам 14 ноября 2026 года. Таблица проверок и вопросы подрядчику - рекомендации для согласования работ; испытания конкретного подключения в рамках статьи не проводились.

Использованы официальные руководства iiko и публичное описание Monobox:

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

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

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