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

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

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

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

3. При создании ключа укажите тип заказов:

4. Сформируйте в iiko внешнее меню для выгрузки (Обмен данными → Выгрузка меню)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

После времени отведённого на выполнение заказа в личном кабинете, ему автоматически выставляется статус "Подтверждён".

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

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

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

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

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

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

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

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

Результата выполнения акции из личного кабинета FoodSoul передаётся в айко как сумма скидки. Рекомендуем настроить синхронизацию скидок с айко или настраивать автоматические акции 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}