Настройка и подключение в личном кабинете

Для полноценной интеграции API iikoTransport требуется версия iiko 7.1.7+, подробнее можете уточнить у специалистов технической поддержки iiko.

1. Откройте Личный кабинет iikoWeb → Настройки iikoTransport → Клиенты API, либо в программе iikoOffice вам доступен пункт Обмен данными → Настройка iikoTransport

2. Для работы с iikoTransport в айко необходимо добавить интеграцию, и указать для неё API Логин, при этом Айко автоматически сгенерирует API Ключ

3. При создании новой интеграции укажите шаблон прав Full Rights(Все права) или Delivery(Права на работу с доставками) для сайта ресторана.

4. Заполните в программе товары для выгрузки меню:

Если Вы используете веб-офис iikoWeb, выберите меню для сайта в выпадающем списке Внешние меню. Если данное поле пустое, сформируйте меню в разделе iikoWeb → Внешние меню.
Подробнее можете ознакомиться по данной ссылке.

Если Вы используете для настроек программу iikoOffice, сформируйте внешнее меню для выгрузки в разделе Обмен данными → Выгрузка меню

Есть несколько ограничений на выгрузку:

5. Далее в окне iikoTransport откройте настройки организации (Общие настройки → Организации)
Должна стоять галочка Включить работу через iikoTransport


6. В программе должны быть зарегистрированные терминалы доставки:

6. Зайдите в Личный кабинет FoodSoul → Интеграции → Автоматизация
7. Выберите iikoTransport
8. Заполните обязательные поля настроек:

9. Сохраните изменения.

10. Выгрузите меню в личный кабинет. Cсылка Принудительный запуск импорта данных позволяет обновить меню в личном кабинете.

Внимание! Выгрузка меню происходит сразу и полностью, текущие товары в личном кабинете будут удалены и заменены на новые.

11. Переключите иконку-глаз справа сверху - чтобы автоматическая интеграция работала она должна быть зеленой.
Меню будет автоматически обновляться раз в сутки. (warning) При синхронизации меню заменяется полностью, учитывайте это при редактировании и вносите необходимые изменения в iiko.(warning)

На этом всё) Далее посмотрим дополнительные настройки для полноценной интеграции Вашей системы.

Подробнее с процессом подключения API Вы можете ознакомиться по ссылке.

Адрес сервера

Если адрес API для Вашего сервера отличается от стандартного (https://api-ru.iiko.services/) укажите его в этом поле, иначе поле необходимо оставить пустым.

Фильтр товаров по названию категории

Укажите название номенклатурной категории товаров из айко. В личный кабинет будут выгружены только товары из этой категории.

(warning) Опция не участвует при выгрузке внешнего меню iikoWeb (warning)

Фильтр по имени группы

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

(warning) Опция не участвует при выгрузке внешнего меню iikoWeb (warning)

Выгрузка внешнего меню

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

1. В Личном кабинете FoodSoul откройте раздел Интеграции - Автоматизация.

2. Найдите поле Название внешнего меню

3. Укажите название меню, так же как оно указано в веб офисе iikoWeb (iikoWeb → Внешние меню).

(warning) Если данное поле не заполнено, по умолчанию выгружается меню для выгрузки из iikoOffice (Обмен данными → Выгрузка меню). (warning)

Ценовые категории

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

1. В Личном кабинете FoodSoul откройте раздел Интеграции - Автоматизация.

2. Найдите поле Название ценовой категории для внешнего меню

3. Укажите название ценовой категории, с которой должен будет работать сайт, так же как оно указано в айко.

(warning) Ценовые категории работают только с внешними меню iikoWeb. (warning)

Передача кода способа оплаты

В Айко будет передаваться Способ оплаты который был выбран при оформлении заказа. Для этого необходимо настроить внешний тип оплаты.

Откройте справочник iikoOffice Розничные продажи -> Типы оплат. Укажите настройки способа оплаты или создайте новый:

В личном кабинете FoodSoul заполните поля настроек:

Каждое поле соответствуют способу оплаты заказа, который выбирается на сайте или в приложении.
Укажите Код типа оплаты, который Вы настраивали в iiko.

Проводить оплату онлайн автоматически

Включите эту опцию, чтобы передать Айко статус онлайн оплаты Проведена.

Передача типа заказа

В Айко будет передаваться разный тип заказа в зависимости от условий. В Личном кабинете FoodSoul → Интеграции → Автоматизация найдите поля настроек:

Откройте справочник iiko Розничные продажи → Типы заказов.

Укажите в нужном поле Название типа заказа из справочника.

Синхронизация статусов заказа

Есть два способа настроить синхронизацию статуса заказа:

1. После поступления заказа в Айко периодически будет происходить его проверка на изменение статуса.

В Личном кабинете FoodSoul включите опцию Интеграции → Автоматизация → Callback Api.

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

Изменения поступают не моментально, в течение нескольких минут.

2. Webhook-уведомления

В Личном кабинете FoodSoul отключите опцию Интеграции → Автоматизация → Callback Api.

Скопируйте ссылку ниже: Интеграции → Автоматизация → WebHook

Зайдите в интерфейс веб-офиса iikoWeb в раздел настройки Webhook уведомлений

Вставьте ссылку, которую вы копировали выше в поле Uri для уведомлений о изменении статуса заказа и сохраните изменения.

При необходимости поставьте фильтры - галочки в блоке Доставка: Статус заказа и Ошибки.

Статус заказа изменится по возможности сразу после поступления уведомления от Айко.

  • Если заказ уже был подтвержден или находится в одном из "рабочих" статусов, его уже нельзя отменить через Айко.
  • После времени отведённого на выполнение заказа в личном кабинете, ему автоматически выставляется статус "Подтверждён" и проверка на изменение статуса (1) не производится.

Синхронизируются только стандартные статусы заказа:

Статус заказа в айкоСтатус заказа в личном кабинете
Не обработанаНе обработан

Не подтверждена

Не обработан
ОжидаетОжидает отправки на кухню
Пора готовитьНа кухне
ГотовитсяНа кухне
ПриготовленПриготовлен
Ждет отправкиОжидает отправки
ОтправленВ пути
ДоставленВыполнен
ЗакрытВыполнен
ОтмененОтменен

Передача акций и скидок

Скидки из программы лояльности iikoCard будут должны применяться к заказу автоматически, для них не нужно производить дополнительных настроек в личном кабинете FoodSoul.

В айко можно передать сумму локальной скидки. Откройте справочник iiko Меню и цены → Скидки.

1. Создайте новую скидку со свободной суммой.

2. В Личном кабинете FoodSoul → Интеграции → Автоматизация найдите поле Название гибкой скидки

3. Укажите Название скидки которую Вы добавляли в справочнике.

4. Если в личном кабинете FoodSoul присутствует скидка к заказу, она будет передана в айко как сумма в рублях.

Применять систему лояльности iikoCard совместно с локальными скидками не рекомендуется! Используйте одно из двух: либо только локальные скидки, либо все скидки настраивайте в iikoCard.

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

Товар в подарок

Товар в подарок передаётся в айко как дополнительная позиция. Так что далее после получения заказа со стороны iikoCard необходимо сделать так чтобы этот товар считался бесплатным.

Есть несколько вариантов. Например:

- добавить в акции действие скидка 100% на выбранный товар
https://ru.iiko.help/articles/#!iikocard/topic-64/a/h3_15

- отдельно добавить в меню бесплатные товары для использования в акции и скрыть через личный кабинет FoodSoul
после переключения иконки публикации товара или категории она сохраняется

- в личном кабинете FoodSoul также есть акции с процентной или фиксированной скидкой на выбранные товары, эта скидка может быть передана в айко как локальная
(warning) помните про то что скидки айко кард применяются независимо согласно условиям акций в программе (warning)

Промокод

Промокод передается в айко как код купона айко кард(coupon).
https://ru.iiko.help/articles/#!iikocard/topic-15

Название промокода и код купона iikoCard должны совпадать, в этом случае айко отметит что купон с нужным кодом был активирован при заказе.

С помощью условия "Купон" в айко можно проверить был ли активирован данный промокод.

Передача терминала доставки

Вы можете указать iiko основной терминал для доставки заказов. В этом случае выбор терминала будет зависеть от выбора гостя в приложении точки самовывоза/района/города.

1. В Личном кабинете FoodSoul → Интеграции → Автоматизация найдите блоки Районы и Точки самовывоза

2. В поле Название терминала для доставки заказа укажите Название терминала доставки из iiko.

3. Из выпадающего списка ниже можете выбрать новый элемент и кликнуть Добавить. Таким образом можно настроить разные терминалы iiko для разных точек доставки.

4. Пункт По умолчанию действует для всех точек самовывоза или районов которым не присвоен терминал.

Настройки бонусной программы

По умолчанию оплата бонусными баллами передаётся так же как акция - в виде суммы скидки.

Зарегистрированные клиенты могут накапливать и расплачиваться бонусными баллами.

1. Для настройки интеграции с бонусной системой создайте и настройте бонусную программу в iikoCard;

2. Настройте для бонусной программы метод оплаты.

3. Далее В личном кабинете Личном кабинете FoodSoul → Интеграции → Автоматизация укажите:

4. Откройте раздел Личный кабинет FoodSoul → Настройки - Бонусная система

5. Активируйте бонусную систему

6. Включите настройку Бонусная система из системы автоматизации.

Настройка завершена!

Информация об оплате заказа бонусами будет передаваться в айко. Гости будут видеть количество баллов, которые начислены в iikoCard по совпадению номера телефона.

Дополнительные настройки товаров и категорий

Для категории вы можете в автоматическом режиме устанавливать опции "Применять скидки для категории" и "Учитывать в корзине при минимальной сумме заказа"

Откройте справочник iiko Обмен данными → Выгрузка меню

В карточке категории в поле "техническая информация" укажите в формате JSON:

{"minimal_sum": true, "discount": true}

Для товара вы можете в автоматическом режиме устанавливать "Лейбл" и "Публикацию на главной странице сайта"

Откройте справочник iiko Обмен данными → Выгрузка меню

В карточке товара в поле "техническая информация" укажите в формате JSON:

{"labels_ids":[6621,6615], "recommend": true}

Выгружать пищевую ценность продуктов

Включите опцию чтобы выгрузить общие БЖУ и Калорийность для товаров и модификаторов.

Включите чтобы дополнительно выгрузить БЖУ и Калорийность на 100гр в описании товаров.

Выгрузка модификаторов

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

Брать организацию из терминала

Включите для Колл-центра iiko с сетью терминалов доставки. Приложение будет изменять ID организации в зависимости от выбранного терминала.

Опция используется только если со стороны технической поддержки iiko настроен данный функционал.