Интеграции 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 сама по себе не доказывает списание или возврат денег.
Проверку завершайте в таком порядке:
- Сверьте заказ, оформленный гостем, с заказом в iiko: состав, дополнения, количество, сумма, точка и способ получения.
- Убедитесь, что подтверждения и ошибки видны тем сотрудникам, которые должны на них реагировать.
- Проверьте повтор после сбоя, отмену и возврат к обычному приёму заказов.
- Зафиксируйте непрошедшие сценарии и условия повторной проверки. До исправления критичных расхождений ограничьте запуск затронутых операций.
Что делать, если обмен работает с ошибками
Коротко: сначала установите состояние конкретного заказа и платежа, затем устраняйте причину. При неизвестном результате отправки повторное создание заказа без проверки может дать дубль.
Соберите время ошибки, номер заказа во внешнем сервисе, точку, ожидаемый результат и обезличенное описание того, что произошло. В руководстве по отладке iiko для диагностики используется идентификатор запроса. Попросите исполнителя добавить его в обращение, если он доступен в используемом интерфейсе.
| Наблюдение | С чего начать проверку |
|---|---|
| На витрине старая цена | Источник цены, выбранное внешнее меню, ценовые настройки и результат последнего обновления |
| Недоступное блюдо продолжает продаваться | Стоп-лист нужной точки, получение уведомления и повторный запрос актуальных данных |
| Заказ отправлен, но сотрудники его не видят | Результат обработки, организация, группа терминалов и состояние соединения |
| Появился повторный заказ | Связь повторной отправки с исходной операцией и реализованную защиту от дублей |
| Статусы в приложении не меняются | Какие события передаются, принимаются ли уведомления и как обновляется интерфейс гостя |
| Суммы в аналитике расходятся | Период, точки, статусы заказов, скидки, возвраты и учёт стоимости доставки |
В опубликованных скриншотах и открытых обращениях скрывайте данные гостей, ключи и токены доступа. Диагностику передавайте через канал поддержки, предусмотренный вашим поставщиком.
Из чего складывается стоимость интеграции
Коротко: запросите смету на конкретный состав обмена и отдельно выясните стоимость поддержки. Слова «интеграция включена» нужно уточнить: какие работы и ограничения входят в предложение.
Попросите разделить разовую настройку и регулярные платежи. В предложении стоит указать подготовку меню, сопоставление способов оплаты, подключение точек, тестирование, возможные лицензии и доработки. Отдельно уточните комиссии за приём платежей и прочие услуги, если они нужны вашей схеме.
Для сопровождения согласуйте канал обращения, порядок реакции на сбой и ответственность после обновлений iiko или внешнего сервиса. Если добавятся филиал, новое меню или бонусная механика, заранее выясните, какие изменения потребуют отдельной работы.
Условия интеграции включите в общий план запуска доставки: сотрудники должны знать, где увидеть заказ и как действовать при недоступном обмене.
Как связать iiko с сайтом и приложением Monobox
Коротко: Monobox предлагает интеграцию сайта и приложения с iiko. Состав обмена и условия для вашего ресторана стоит подтвердить на демонстрации и зафиксировать в предложении.
На странице интеграции Monobox с iiko перечислены передача заказов, синхронизация меню, цен, модификаторов, стоп-листов и статусов. Это публичное описание поставщика; работу нужных операций проверяют на конфигурации ресторана.
Подготовьте для обсуждения пример меню с дополнениями, список точек, способы получения и оплаты, правила бонусов. Отметьте операции, для которых сохраняется ручная обработка, и попросите показать, как сотрудник узнает об ошибке.
Запросите демонстрацию приложения Monobox и используйте таблицу проверок из статьи как список вопросов. До подключения согласуйте нужные функции, стоимость и порядок сопровождения.
Источники
Продуктовые сведения проверены по открытым страницам 14 ноября 2026 года. Таблица проверок и вопросы подрядчику - рекомендации для согласования работ; испытания конкретного подключения в рамках статьи не проводились.
Использованы официальные руководства iiko и публичное описание Monobox:
Хотите запустить доставку еды быстрее и без ошибок?
Получите демонстрацию готовой платформы для доставки еды.
Перейти к решению