Интеграции
Iiko — система автоматизации работы ресторанов.
Импортируйте меню, управляйте заказами, акциями и бонусными баллами с помощью интеграции с iiko.
  • Основные возможности
    • Импорт меню из iiko в DG
    • Отправка заказов из DG в iiko
    • Синхронизация статусов в DG и iiko
    • Передача информации об акциях, скидках и бонусных баллах из DG в iiko

Данные, которые необходимо предоставить


Для настройки интеграции вам необходимо направить следующие данные:
1) АПИ-ключ
2) Указать источник меню - iikoOffice или iikoWeb
3) Название точки, из которой нам необходимо тянуть меню (если точек несколько)
4) Название способов оплаты в iiko, которые мы должны использовать
5) Название типов заказов в iiko
6) Названия скидок в iikoOffice (если есть)
7) Названия категорий гостей в iikoCard (если есть)

Дополнительно: повышению удобства и ускорению подключения поспособствует создание доступов для Delivery Guru в iikoWeb. Для безопасности учетная запись может быть только на просмотр данных. Это позволит нам самостоятельно проверять некоторые настройки без привлечения сотрудников ресторана.
1. Зайдите в iikoWeb организации
2. Перейдите в iikoWeb в раздел "Настройка Cloud API":
Создание интеграции в iikoWeb
3. Перейдите в "Организации":
4. Настройте точку по аналогии с изображением и сохраните изменения:
5. Перейдите в "Интеграции", добавьте новую интеграцию:
6. Укажите следующие параметры, в том числе и созданное внешнее меню:
7. В разделе "Подключенные точки" выберите нужные точки:
9. Сохраните интеграцию
8. Скопируйте и передайте нашему менеджеру API-ключ созданной интеграции:
  1. Перейдите в iikoWeb в раздел внешнего меню:
Создание меню через iikoWeb
4.Добавьте новое меню. Подробная инструкция в документации:
https://ru.iiko.help/articles/#!iikoweb/external-menu
5. В разделе "Настройка Cloud API" добавьте созданное меню в интеграцию. Сохраните изменения.
1. Если вы хотите передавать меню из iikoOffice, его необходимо настроить в разделе "Обмен данными"/"Выгрузка меню"

Подробная инструкция: https://ru.iiko.help/articles/#!iikooffice-7-9/topic-905
2. После того, как меню будет собрано, необходимо его выгрузить:
Создание меню через iikoOffice
После того, как меню iiko будут внесены корректировки, его необходимо повторно импортировать.
1. Перейдите в любой раздел меню и нажмите на кнопку "Синхронизировать меню". Начнется процесс импорта. После того, как импорт завершится, отобразится сообщение.

Примечание 1: не желательно делать синхронизацию во время рабочего дня ресторана.

Примечание 2: если меню не создалось/изменилось сразу, советуем подождать 8-10 минут. В случае возникновения проблем с интеграцией, обращайтесь к нам в поддержку.
Синхронизация меню
При каждой синхронизации меню из iikoOffice в Деливери Гуру передаются следующие настройки и iiko:
Особенности синхронизации меню из iikoOffice
  • Элемент меню
    Категории
    Меняется только в iiko
    - доступность категории
  • Элемент меню
    Блюда
    Меняется только в iiko:
    - стоимость
    - описание
  • Элемент меню
    Группы модификаторов
    Меняется только в iiko
    - минимальное количество
    - максимальное количество
    - тип группы модификаторов
  • Элемент меню
    Модификаторы
    Меняется только в iiko
    - название
    - доступность
    - цена
    - минимальное количество
    - максимальное количество
    - количественный
    - фотография
Если вы поменяете название, фото, описание блюда/категории в Delivery Guru, то при повторной синхронизации изменений из iiko не будут применены на тех параметрах, которые были изменены в DG.
Важно: Менять состав модификаторов в группах, настройки количества модификаторов, состав блюд в категориях нельзя! Тогда заказы не будут экспортироваться в iiko.
При каждой синхронизации меню все настройки меню, которые были сделаны вручную в Delivery Guru будут заменяться настройками из iikoWeb. Исключением являются настройки, которых нет в iiko.
Важно: Менять состав модификаторов в группах, количество модификаторов, состав блюд в категориях нельзя! Тогда заказы не будут экспортироваться в iiko.
Особенности синхронизации меню из iikoWeb
1. После создания внешнего меню в iikoWeb перейдите в его настройки:
Редактирование меню в iikoWeb
1. В разделе "Список блюд" и "Модификаторы" вы можете редактировать, добавлять и удалять категории, блюда и модификаторы, добавлять изображения. Рекомендуемый размер изображений - 1080x1080 (квадратный). Если фото будет прямоугольным, то есть вероятность, что нужная часть обрежется.
3. После того, как все изменения в меню будут завершены, нажмите на кнопку "Сохранить".
О внесении изменений в меню
Интеграция настроена таким образом, что все изменения, внесенные в Delivery Guru вручную, будут перекрыты изменениями из iikoWeb. Поэтому все изменения рекомендуем делать именно в iikoWeb.
1. В iikoOffice перейдите в раздел "Обмен данными"/"Выгрузка меню" и отредактируйте меню.
Примечание: чтобы у блюд в Delivery Guru были изображения, их необходимо добавлять блюдам в меню для выгрузки. Рекомендуемый размер изображений - 1080x1080 (квадратный). Если фото будет прямоугольным, то есть вероятность, что нужная часть обрежется.
Редактирование меню в iikoOffice
3. После того, как новое меню будет выгружено, изменения вступят в силу, можно будет синхронизировать меню.
О внесении изменений в меню
Интеграция настроена таким образом, что часть изменений, внесенных напрямую в DG перекрывается дальнейшими изменениями из iiko, а часть - нет.
Категории/Подкатегории:
Если задать название или фото категории в Delivery Guru, то все их дальнейшие изменения в iiko не изменят их.
Блюда:
Если задать название, вес, единицы измерения блюд в Delivery Guru, то все их дальнейшие изменения в iiko не изменят их.
Группы модификаторов:
Если задать название групп модификаторов в Delivery Guru, то все их дальнейшие изменения в iiko не изменят их.
2. После того, как меню для выгрузки будет готово, нажмите выгрузить:
Блюда и модификаторы в iiko имеют свои обозначения. Для удобства администраторов эти обозначения выводятся и в системе Delivery Guru в карточке позиции:
Внешние идентификаторы позиций меню
В iikoOffice в разделе "Товары и склады"/"Номенклатуры" можно увидеть артикулы и коды товаров:
По данным значениям вы сможете сравнивать позиции в меню Delivery Guru.
Обратите внимание: у блюд и модификаторов Delivery Guru отображает артикул блюда, а у групп модификаторов - код.
Чтобы создавать промокоды только для определенных групп пользователей, необходимо указать для промокода сегмент iiko.
1. Создайте категорию в iikoCard (Гости/Категории гостей/Создать):
Настройка сегментов
2. Добавьте гостей в категорию. В разделе "Гости" отфильтруйте гостей по желаемым признакам и выберите Действие/Настройка категории:
3. Выберите категорию, в которую будут добавлены гости:
4. Запросите идентификатор созданной категории у поддержки iiko или Delivery Guru.
5. Создайте промокод в системе Delivery Guru и укажите полученный идентификатор:
После этого все гости, которые находятся в сегменте, смогут использовать созданный промокод.
Возможные ошибки при применении промокода/акции
При применении промокодов могут возникнуть следующие ошибки.
1) При заказе через сайт/мобильное приложение:
  • "Невозможно проверить промокод. Пожалуйста, повторите попытку через несколько секунд" - ошибка означает, что iiko не отвечает.
  • "Промокод не действителен. Пожалуйста, попробуйте использовать другой код" - сегмент отключен в iiko.
  • "Промокод не применен. Пожалуйста, уточните условия применения кода" - гость не входит в сегмент в iiko.
  • "Промокод не применен. Пожалуйста, проверьте условия применения кода" - что гость не найден в iiko, поэтому промокод нельзя применить.
2) При ручном создании заказа в колл-центре:
  • "Невозможно проверить промокод. Внешняя система не отвечает. Повторите попытку или попробуйте позднее" - ошибка означает, что при попытке соединения с iiko произошел сбой.
  • "Промокод не может быть применен. Во внешней системе отключена группа гостей для данного промокода" - в iiko необходимо включить категорию гостей, привязанную к промокоду.
  • "Промокод не может быть применен. Во внешней системе гость не входит в группу гостей для данного промокода" - iiko сообщил, что гость не входит в сегмент. Включите гостя в сегмент в iiko.
  • Промокод не может быть применен. Гость не найден во внешней системе и не может входить в группу гостей для данного промокода" - гость не найден в iiko, поэтому промокод не может быть применен.
Чтобы настроить бонусные баллы, вам необходимо обратиться в поддержку iiko и запросить создание типа оплаты "Бонусные баллы". Пример настройки:
Настройка бонусных баллов
2. Сообщите нам точное название созданного типа оплаты.
3. Перейдите в настройки iikoCard, в раздел "Webhook-уведомления" и создайте новую подписку:
4. Введите название (например, Delivery Guru), URL (мы направим точный URL), пароль (произвольный, его сообщить передать нам). Отметьте все настройки и сохраните подписку.
После этого мы настроим бонусные баллы на своей стороне.
Чтобы настроить скидку на подарочное блюдо, вам необходимо в iikoOffice создать блюдо с ценой 0, а в ДГ отметить блюдо как подарочное:
Настройка промокода "Блюдо в подарок"
После этого необходимо перейти в раздел "Промокоды" и создать новый промокод:
Готово! Промокод настроен, можно его проверять
Чтобы настроить скидку, необходимо в iikoOffice перейти в раздел "Скидки и надбавки":
Создание скидки
Задайте все необходимые настройки:
Укажите размер скидки и активируйте ее:
Обратитесь к сотрудникам Деливери Гуру или айко для получения кода скидки. Код скидки нужно указать в поле "Интеграция" у акции при ее создании в Деливери Гуру:
У нас появилась возможность работать с сертификатами Digift, которые настроены в iiko!
Схема взаимодействия следующая:
1) Клиент покупает сертификат digift
2) Digift создает сертификат в iikoCard
3) Клиент вводит сертификат на сайте или в мобильном приложении
4) Заказ создается в Деливери Гуру и отправляется в iiko
5) В iiko с сертификата списываются средства
Если у вас есть сертификаты digift, свяжитесь с нами и мы их подлкючим!
Подключение сертификатов Digift
Добавление новой точки в Деливери Гуру
Основные действия, которые нужно сделать (Подробнее):
  • Создание точки в iikoOffice
  • Создание нового ресторана в административной панели Деливери Гуру
  • Редактирование карты и условий зоны доставки
  • Включение доступности точки для интеграции с Деливери Гуру
Первое, что необходимо сделать, это открыть административную панель, перейти в раздел "Рестораны" и добавить новый ресторан:
Добавление нового ресторана в Деливери Гуру
Задайте все необходимые настройки (обязательно укажите координаты и настройки для самовывоза!):
Загрузите скачанную карту и внесите все изменения в зоны: дважды нажмите на зону, пока не появятся точки на карте. Эти точки можно перемещать.
Чтобы создать новую зону, нажмите на "Многоугольники" и начертите ее на карте. Задайте новой зоне название.
Внимание! Зоны не должны пересекаться между собой.
После того, как все изменения в карту будут внесены, нажмите "Сохранить и продолжить". Убедитесь, что карта находится внутри квадрата и нажмите "Экспорт"
Когда точка будет создана, откройте раздел картографии и зайдите в вашу текущую карту. Скачайте ее:
Нажмите на кнопку "К импорту":
Откройте сайт https://yandex.ru/map-constructor:
Выберите формат GEOJSON и нажмите "Скачать". Файл сохранится на устройстве.
Вернитесь в административную панель в раздел "Картография", откройте текущую карту и нажмите "Загрузить". Выберите файл с картой и нажмите "Сохранить":
Убедитесь, что карта обновилась и все изменения корректно отображаются. После этого перейдите в список геозон и выберите новую:
Задайте координаты зоне, новый ресторан, время доставки, стоимость доставки:
Нажмите "Сохранить".
Редактирование карты в картографии
Создайте новую точку в iikoOffice и перейдите в iikoWeb, в раздел "Настройки СloudApi":
Добавление новой точки в iiko
Перейдите в раздел организации и нажмите на свою организацию:
Обязательно отметьте новую организацию и сохраните изменения:
После этого напишите поддержке Деливери Гуру, чтобы мы могли завершить настройки.
Мы совместно с вами проведем тестовый заказ на самовывоз. Когда все будет настроено корректно, необходимо перейти к след. пункту.
Пока точка не будет полностью настроена, отключите самовывоз.
Не забудьте включить доставку.
Чтобы настроить возможность назначать курьера из iiko в Деливери гуру, необходимо создать курьера в iikoOffice (iikoChain):
Добавление курьера в iiko
Задайте курьеру пин-код для входа в iikoFront:
Дайте курьеру права D_CO, D_DCO, D_MD, F_OPIN
Как только курьер будет создан со всеми настройками, ему необходимо открыть персональную смену в iikoFront. Смену не нужно закрывать, она должна быть всегда открыта.
Далее на стороне Деливери Гуру будут произведены настройки и после этого можно будет проверять заказ.
Наиболее частые вопросы/проблемы с iiko

Чтобы добавить новый способ оплаты в r-keeper, нужно в каждом ресторане создать новые столы для доставки с этим типом оплат и для самовывоза с этим типом оплат. (если необходимо разделить доставку и самовывоз) Далее необходимо предоставить сотрудникам Delivery Guru номера этих столов из параметра "table_code".
Пример для точки "Ресторан на Арбате":
"Ресторан на Арбате",
{"table_code"=>
{"pickup"=>{"cash"=>837, "online_card"=>435},
"delivery"=>{"cash"=>786, "online_card"=>234}
Подключение нового способа оплаты

Возможности интеграции
  • Импорт меню из Деливери Гуру в Яндекс Еду
  • Синхронизация стоп-листов в Деливери Гуру и Яндекс Еде
  • Отправка и обработка заказов из Яндекс Еды в Деливери Гуру
Подключение интеграции с Яндекс Едой
Для подключения Яндекс Еды необходимо:
1) Обратиться к вашему менеджеру в чате или написать нам на почту
office@deliveryguru.ru
2) Мы подготовим все необходимые данные для подключения и передадим вам.
3) Необходимо составить обращение в Яндекс Еду:
  • если у вас есть личный менеджер, то передайте ему данные для подключения
  • если у вас нет личного менеджера, то создайте обращение через сайт https://yandex.ru/project/eda/rest_faq_integration или через Vendor кабинет - раздел "Поддержка"/"+"/"Интеграция"/"Подключение интеграции" - отправьте сообщение с доступами, которые вам предоставили сотрудники Delivery Guru.
4) Ожидайте письма от Яндекс поддержке о проверке данных и меню. Меню должно соответствовать требованиям Яндекс Еды: https://yandex.com/support/eda-vendor-ru/ru/menu/dish-moderation
5) Яндекс назначит день переключения работы на систему Delivery Guru. Особенности интеграции:
  • импорт меню в Яндекс Еду из DG будет происходить каждый день в 09:00
  • стоп-листы Яндекс Еда запрашивает каждые 5 минут
  • все заказы будут поступать в Vendor кабинет и в систему Delivery Guru
Создание акции в Яндекс Еде
  1. Зайдите в свой личный кабинет в Яндексе
  2. Перейдите в раздел "Поддержка"
  3. Нажмите "+" около одной из точек, чтобы создать заявку.
  4. Выберите тему "Рост продаж" - "Акции"
5. В запросе укажите:
1) Название + адрес ресторана
2) Минимальная сумма заказа для предоставления подарка
3) Сам подарок, который даем
4) Период проведения акции
5) Максимальная общая сумма, на которую могут быть выданы подарки

Важно: Минимальная сумма заказа должна быть не больше значения среднего чека ваших ресторанов плюс 100 рублей.
Например, если ваш средний чек 1500 рублей, то минимальная сумма заказа для получения подарка не должна превышать 1600 рублей. Показатель среднего чека одного ресторана считается как среднее из показателей за последние 4 недели.
Чтобы посмотреть средний чек, перейдите в раздел «Статистика» - «Бизнес показатели», далее выбираете ресторан и период 30 дней.

6. После отправки заявки ожидайте звонка для проведения тестов по акции
Создание акции в Деливери Гуру
После того, как запрос на акцию был подан в Яндекс Еду, необходимо создать эту акцию в Деливери Гуру:
  1. Откройте раздел промокоды:
2. Создайте новый промокод и обязательно включите настройку "Промокод от Яндекса". Если есть интеграция с внешней системой, укажите код скидки внешней системы:

Возможности Telegram-бота
  • Бесплатная авторизация пользователей в приложении
Создание бота
1. Первым делом необходимо создать бота. Для этого открываем https://t.me/BotFather в аккаунте, который будет владеть ботом
2. Начинаем диалог с ботом, нажимаем /newbot
3. Вводим имя бота. Это имя будет видно пользователям
4. Вводим username бота. Символ "-" не допускается для ввода. Должно быть уникальным
5. Если все введено верно, то бот будет создан
5. Скопируйте у бота токен и username и передайте нам