Это инструкция для пользователей iikoMini, у которых уже есть готовый сайт и есть программист, который может написать интеграцию этого сайта с системой.
Если сайта и программиста нет – создайте сайт доставки прямо из личного кабинета iikoWeb. Это быстро, просто, и сайт будет сразу интегрирован с iiko.
Возможности интеграции
Система iikoCloud Mini имеет открытый API (программный интерфейс) для интеграции со сторонними приложениями, который позволяет реализовать следующие сценарии:
Подготовка системы к интеграции
Для того, чтобы ваш разработчик мог начать работу на своей стороне, вам необходимо создать в iikoWeb Внешнее Меню и Источник Заказов.
Внешнее Меню – это отдельный список блюд, доступный для внешних систем. Внешнее меню может отличаться от того, которое используется на сайте, кроме того, вы можете использовать несколько внешних меню для разных источников заказов (например, одно — для вашего сайта и другое — для Яндекс Еды).
Подробно про создание внешнего меню читайте здесь.
Для быстрого старта можно использовать меню кассы, но для того, чтобы сделать сайт по-настоящему красивым и продающим, мы советуем добавить во внешнее меню картинки, описания блюд, информацию об их калорийности и другие параметры, которые облегчат навигацию покупателей.
Ваша iikoCloud Mini поддерживает два типа Источников Заказа – Yandex.Eda и SOI (Simple Order Injection). Нас интересует второй — SOI.
В iikoWeb зайдите в раздел “Внешние заказы” и добавьте новый Источник Заказа
Заполните настройки по своему усмотрению.
Убедитесь, что выбрана опция «Не проверять авторизацию».
Обязательно укажите Имя и Телефон Клиента по умолчанию (может быть любое)
Сохраните Источник Заказа.
Обратите внимание на поле WebHook URL – оно теперь содержит ваш уникальный веб-адрес, на который сайт будет отправлять заказы.
Привяжите ваше Внешнее меню к Источнику заказов – для этого перейдите на вкладку Выгрузка Номенклатуры, укажите Внешнее Меню и нажмите «Сохранить и выгрузить».
Настройки на стороне сайта
Покажите эту информацию разработчику вашего сайта
Как вставлять заказы?
Для вставки заказов отправьте POST-запрос на адрес WebHook URL. Формат запроса смотрите здесь.
Как убедиться, что заказ дошел до кассы?
Метод вставки заказа в iikoCloud Mini работает асинхронно. То есть, несмотря на то что запрос отработает быстро и вернет ОК (HTTP 200), может пройти некоторое время, прежде чем заказ появится на кассе.
Подразумевается, что касса должна быть включена и иметь доступ в Интернет. Система будет пытаться доставить заказ в течение времени, указанного в настройках Источника Заказа («Таймаут отправки заказов», по умолчанию – 60 секунд), после чего прекратит попытки.
При изменении статуса заказа (на «Доставлен» или «Доставка не удалась») система отправит сообщение на адрес, указанный в Источнике Заказа («Endpoint URI»). По этому адресу сайт должен ожидать POST запроса без авторизации.
Как получить меню?
Для получения меню используйте метод
/api/integrations/delivery-injector/webhook/{endpointToken}/menu
Где {endpointToken} – это набор символов из WebHook URL.
Как получить стоп-лист?
Для получения стоп-листа используйте метод
/api/integrations/delivery-injector/webhook/{endpointToken}/stop-list
Где {endpointToken} – это набор символов из WebHook URL.